feat(string): nanoid (#1716)

2 files changed, 73 insertions, 0 deletions

diff --git a/test/__snapshots__/string.spec.ts.snap b/test/__snapshots__/string.spec.ts.snap
index 0a6df4d9..6a3ccead 100644
--- a/test/__snapshots__/string.spec.ts.snap
+++ b/test/__snapshots__/string.spec.ts.snap
@@ -78,6 +78,20 @@ exports[`string > 42 > hexadecimal > with length range 1`] = `"0xBE4ABdd39321aD"
 
 exports[`string > 42 > hexadecimal > with length, casing and empty prefix 1`] = `"8be4abd"`;
 
+exports[`string > 42 > nanoid > noArgs 1`] = `"NbMBr6sk8E3-W0ZCB01wo"`;
+
+exports[`string > 42 > nanoid > noArgs 2`] = `"2Ye5CnYsRGr0Wyn0eeGBP"`;
+
+exports[`string > 42 > nanoid > noArgs 3`] = `"aobKqcz1-roVJkzwXQKxA"`;
+
+exports[`string > 42 > nanoid > noArgs 4`] = `"XBhia0_oi0cIMBVEUQr5m"`;
+
+exports[`string > 42 > nanoid > noArgs 5`] = `"FFAhynYQIef2I6rcTtyH8"`;
+
+exports[`string > 42 > nanoid > with length parameter 1`] = `"NbMBr6sk8E3-W0ZCB01wo2Ye5CnYsR"`;
+
+exports[`string > 42 > nanoid > with length range 1`] = `"WJB993RBH1YPdb_iwqiB8i"`;
+
 exports[`string > 42 > numeric > noArgs 1`] = `"3"`;
 
 exports[`string > 42 > numeric > with allowLeadingZeros 1`] = `"4"`;
@@ -226,6 +240,20 @@ exports[`string > 1211 > hexadecimal > with length range 1`] = `"0xaDB42F0e3f4A9
 
 exports[`string > 1211 > hexadecimal > with length, casing and empty prefix 1`] = `"eadb42f"`;
 
+exports[`string > 1211 > nanoid > noArgs 1`] = `"sM8_9dqaK0FJViZZsU9C_"`;
+
+exports[`string > 1211 > nanoid > noArgs 2`] = `"0i1q_zaoUZjAoz4ee2QDc"`;
+
+exports[`string > 1211 > nanoid > noArgs 3`] = `"qApz4EyCu9FHt9xrws3AI"`;
+
+exports[`string > 1211 > nanoid > noArgs 4`] = `"5SxX-57HFuA0KnZgRAyUr"`;
+
+exports[`string > 1211 > nanoid > noArgs 5`] = `"T_mrcROKCRDrUWF5dWr0k"`;
+
+exports[`string > 1211 > nanoid > with length parameter 1`] = `"sM8_9dqaK0FJViZZsU9C_0i1q_zaoU"`;
+
+exports[`string > 1211 > nanoid > with length range 1`] = `"TdZFGLlHOLEPqR-_AcmZLoWxYdiHwl-ngjay"`;
+
 exports[`string > 1211 > numeric > noArgs 1`] = `"9"`;
 
 exports[`string > 1211 > numeric > with allowLeadingZeros 1`] = `"9"`;
@@ -374,6 +402,20 @@ exports[`string > 1337 > hexadecimal > with length range 1`] = `"0xc346ba075bd5"
 
 exports[`string > 1337 > hexadecimal > with length, casing and empty prefix 1`] = `"5c346ba"`;
 
+exports[`string > 1337 > nanoid > noArgs 1`] = `"ydx2eAk_jN5mJ_RM0snwm"`;
+
+exports[`string > 1337 > nanoid > noArgs 2`] = `"tRpr8OTVCXSOGGPC-spDN"`;
+
+exports[`string > 1337 > nanoid > noArgs 3`] = `"GQLX3wG-xgP-RiBh-hv9G"`;
+
+exports[`string > 1337 > nanoid > noArgs 4`] = `"TxLsFyNSRiYIsFStp3G0m"`;
+
+exports[`string > 1337 > nanoid > noArgs 5`] = `"AtcFYs1gw9vinZNdyEHwk"`;
+
+exports[`string > 1337 > nanoid > with length parameter 1`] = `"ydx2eAk_jN5mJ_RM0snwmtRpr8OTVC"`;
+
+exports[`string > 1337 > nanoid > with length range 1`] = `"9hsjwgYJ7nC7YrMNmpA"`;
+
 exports[`string > 1337 > numeric > noArgs 1`] = `"2"`;
 
 exports[`string > 1337 > numeric > with allowLeadingZeros 1`] = `"3"`;
diff --git a/test/string.spec.ts b/test/string.spec.ts
index c9f82593..1ad429ca 100644
--- a/test/string.spec.ts
+++ b/test/string.spec.ts
@@ -98,6 +98,12 @@ describe('string', () => {
 
     t.itRepeated('uuid', 5);
 
+    t.describe('nanoid', (t) => {
+      t.itRepeated('noArgs', 5)
+        .it('with length parameter', 30)
+        .it('with length range', { min: 13, max: 37 });
+    });
+
     t.describe('special', (t) => {
       t.it('noArgs')
         .itRepeated('with length parameter', 5, 5)
@@ -657,6 +663,31 @@ describe('string', () => {
         });
       });
 
+      describe(`nanoid`, () => {
+        it('generates a valid Nano ID', () => {
+          const id = faker.string.nanoid();
+          const regex = /^[0-9a-zA-Z_-]+$/;
+          expect(id).toMatch(regex);
+        });
+
+        it('should have a default length of 21', () => {
+          const id = faker.string.nanoid();
+          expect(id).toHaveLength(21);
+        });
+
+        it('should return an empty string when length is negative', () => {
+          const id = faker.string.nanoid(-1);
+          expect(id).toBe('');
+        });
+
+        it('should return string with a length within a given range', () => {
+          const actual = faker.string.nanoid({ min: 13, max: 37 });
+
+          expect(actual.length).toBeGreaterThanOrEqual(13);
+          expect(actual.length).toBeLessThanOrEqual(37);
+        });
+      });
+
       describe('special', () => {
         it('should return a value of type string with default length of 1', () => {
           const actual = faker.string.special();