add valueOrEmpty method.

Jojo-craft · Sep 8, 2023 · a2dfdec · a2dfdec
1 parent cdf15c6
commit a2dfdec
Show file tree

Hide file tree

Showing 5 changed files with 125 additions and 64 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 📦 [2.4.0] - 2023-09-08
+
+### 💎 Added
+- Methods:
+  - `valueOrEmpty`: Returns an empty string if the value is null, undefined, or blank; otherwise, returns the input value. 
 
 
 ## 📦 [2.3.0] - 2023-08-23

diff --git a/README.md b/README.md
@@ -68,6 +68,7 @@ String.EMPTY;
 | [`containsSpecialCharacter`](#containsSpecialCharacter) |                     Indicates whether a given string contains at least one special character (reverse with `notContainsSpecialCharacter` method).                     |              value: `string` &#124; `null` &#124; `undefined`              | `boolean` |
 |        [`containsUpperCase`](#containsUpperCase)        |                                            Indicates whether the specified string contains at least one uppercase letter.                                             |              value: `string` &#124; `null` &#124; `undefined`              | `boolean` |
 |        [`containsLowerCase`](#containsLowerCase)        |                                            Indicates whether the specified string contains at least one lowercase letter.                                             |              value: `string` &#124; `null` &#124; `undefined`              | `boolean` |
+|             [`valueOrEmpty`](#valueOrEmpty)             |                                Returns an empty string if the value is null, undefined, or blank; otherwise, returns the input value.                                 |              value: `string` &#124; `null` &#124; `undefined`              | `string`  |
 |            [`removeAccents`](#removeAccents)            |                                                                 Removes accents from a given string.                                                                  |                              value: `string`                               | `string`  |
 |                     [`join`](#join)                     |                                          Concatenates an array of strings using the specified separator between each member.                                          | separator: `string`, values: (`string` &#124; `null` &#124; `undefined`)[] | `string`  |
 |               [`countWords`](#countWords)               |                                                               Counts the number of words in a sentence.                                                               |            sentence: `string` &#124; `null` &#124; `undefined`             | `number`  |
@@ -345,6 +346,27 @@ String.toBoolean('true');
 // true
 ```
 
+#### <a id="valueOrEmpty"/> valueOrEmpty
+
+```typescript
+String.valueOrEmpty(undefined);
+// ''
+```
+
+```typescript
+String.valueOrEmpty(null);
+// ''
+```
+
+```typescript
+String.valueOrEmpty('   ');
+// ''
+```
+
+```typescript
+String.valueOrEmpty('pomme de terre');
+// 'pomme de terre'
+```
 
 
 ## License

diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "string-craft",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "Simple string manipulation library for TypeScript",
   "main": "dist/string.js",
   "types": "dist/string.d.ts",
@@ -34,7 +34,10 @@
     "package.json",
     "tsconfig.json",
     "stryker.conf.json",
-    ".eslintrc"
+    ".eslintrc",
+    ".eslintignore",
+    ".gitignore",
+    ".npmignore"
   ],
   "author": "Joann JOUSSELIN",
   "license": "MIT",