Added Exact Value/s Condition for String Length & Tests required with README.md Update

README.md

@@ -140,7 +140,7 @@ Validator                               | Description
 **isJSON(str [, options])**             | check if the string is valid JSON (note: uses JSON.parse).<br/><br/>`options` is an object which defaults to `{ allow_primitives: false }`. If `allow_primitives` is true, the primitives 'true', 'false' and 'null' are accepted as valid JSON values.
 **isJWT(str)**                         | check if the string is valid JWT token.
 **isLatLong(str [, options])**                      | check if the string is a valid latitude-longitude coordinate in the format `lat,long` or `lat, long`.<br/><br/>`options` is an object that defaults to `{ checkDMS: false }`. Pass `checkDMS` as `true` to validate DMS(degrees, minutes, and seconds) latitude-longitude format.
-**isLength(str [, options])**              | check if the string's length falls in a range.<br/><br/>`options` is an object which defaults to `{min:0, max: undefined}`. Note: this function takes into account surrogate pairs.
+**isLength(str [, options])**              | check if the string's length falls in a range and equal to `exact` if provided. The `exact` can be an integer, an array or an object of several integers.<br/><br/>`options` is an object which defaults to `{min:0, max: undefined, exact: undefined}`. Note: this function takes into account surrogate pairs.
 **isLicensePlate(str [, locale])**     | check if string matches the format of a country's license plate.<br/><br/>(locale is one of `['cs-CZ', 'de-DE', 'de-LI', 'fi-FI', 'pt-BR', 'pt-PT', 'sq-AL', 'sv-SE', 'en-IN', 'hi-IN', 'gu-IN', 'as-IN', 'bn-IN', 'kn-IN', 'ml-IN', 'mr-IN', 'or-IN', 'pa-IN', 'sa-IN', 'ta-IN', 'te-IN', 'kok-IN']` or `any`)
 **isLocale(str)**                       | check if the string is a locale
 **isLowercase(str)**                    | check if the string is lowercase.

src/lib/isLength.js

@@ -5,15 +5,39 @@ export default function isLength(str, options) {
   assertString(str);
   let min;
   let max;
+  let exact;
+  let result;
+  let isValid = false;
   if (typeof (options) === 'object') {
     min = options.min || 0;
     max = options.max;
+    exact = options.exact;
   } else { // backwards compatibility: isLength(str, min [, max])
     min = arguments[1] || 0;
     max = arguments[2];
   }
   const presentationSequences = str.match(/(\uFE0F|\uFE0E)/g) || [];
   const surrogatePairs = str.match(/[\uD800-\uDBFF][\uDC00-\uDFFF]/g) || [];
   const len = str.length - presentationSequences.length - surrogatePairs.length;
-  return len >= min && (typeof max === 'undefined' || len <= max);
+  result = len >= min && (typeof max === 'undefined' || len <= max);
+  if (result === false || typeof exact === 'undefined') return result;
+  if (Array.isArray(exact) === true) {
+    for (let oneElem of exact) {
+      if (len === oneElem) {
+        isValid = true;
+        break;
+      }
+    }
+  } else if (typeof exact === 'number') {
+    if (len === exact) {
+      isValid = true;
+    }
+  } else if (typeof exact === 'object') {
+    for (let key in exact) {
+      if (len === exact[key]) {
+        isValid = true;
+      }
+    }
+  }
+  return isValid;
 }

test/validators.js

@@ -4698,12 +4698,54 @@ describe('Validators', () => {
       valid: ['abc', 'de', 'a', ''],
       invalid: ['abcd'],
     });
+    test({
+      validator: 'isLength',
+      args: [{ max: 6, exact: 5 }],
+      valid: ['abcde', 'fffde', 'allkk'],
+      invalid: ['abcd', 'abcdef', 'vfd', 'ff', '', 'k'],
+    });
+    test({
+      validator: 'isLength',
+      args: [{ max: 6, exact: { } }],
+      valid: [],
+      invalid: ['abcd', 'abcdef', 'vfd', 'ff', '', 'k'],
+    });
+    test({
+      validator: 'isLength',
+      args: [{ min: 2, max: 6, exact: 5 }],
+      valid: ['abcde', 'fffde', 'allkk'],
+      invalid: ['bsa', 'vfvd', 'ff', '', 'k'],
+    });
+    test({
+      validator: 'isLength',
+      args: [{ min: 1, exact: 2 }],
+      valid: ['fg', 'ff', 'po'],
+      invalid: ['bsa', 'vfvd', '', 'k'],
+    });
     test({
       validator: 'isLength',
       args: [{ max: 0 }],
       valid: [''],
       invalid: ['a', 'ab'],
     });
+    test({
+      validator: 'isLength',
+      args: [{ min: 5, max: 10, exact: [2, 6, 8, 9] }],
+      valid: ['helloguy', 'shopping', 'validator', 'length'],
+      invalid: ['abcde', 'abcdefg'],
+    });
+    test({
+      validator: 'isLength',
+      args: [{ min: 5, max: 10, exact: { first: 6, second: 8, third: 9 } }],
+      valid: ['helloguy', 'shopping', 'validator', 'length'],
+      invalid: ['abcde', 'abcdefg', 'abcdefghij'],
+    });
+    test({
+      validator: 'isLength',
+      args: [{ exact: '9' }],
+      valid: [],
+      invalid: ['a', 'abcd', 'abcdefghijkl'],
+    });
     test({
       validator: 'isLength',
       valid: ['a', '', 'asds'],