Feat: Add randomize option

index.d.ts

@@ -85,6 +85,24 @@
 	```
 	*/
 	readonly signal?: AbortSignal;
+
+	/**
+	 Decide if a random delay should be introduced between retries.
+	 Enabling this option adds variability to the retry strategy, helping to distribute load peaks and reduce contention.
+	 If set to `true`, a random delay will be introduced between each retry attempt.
+	 *
+	 @example
+	 ```
+	 import pRetry from 'p-retry';
+	 *
+	 const run = async () => { ... };
+	 *
+	 const result = await pRetry(run, {
+	   randomize: true
+	 });
+	 ```
+	 */
+	 readonly randomize?: boolean;
 } & OperationOptions;
 
 /**

index.test-d.ts

@@ -21,6 +21,11 @@ expectType<Promise<string>>(
 		retries: 5,
 	}),
 );
+expectType<Promise<string>>(
+	pRetry(() => 'foo', {
+		randomize: true,
+	}),
+);
 
 const abortError = new AbortError('foo');
 new AbortError(new Error('foo')); // eslint-disable-line no-new

readme.md

@@ -143,6 +143,23 @@ try {
 }
 ```
 
+##### randomize
+
+Decide whether to introduce a random delay between retry attempts. (multiply with a factor between 1 to 2)
+
+Enabling this option adds variability to the retry strategy, helping to distribute load peaks and reduce contention among concurrent retry attempts.
+
+```js
+import pRetry from 'p-retry';
+
+const run = async () => { … };
+
+const result = await pRetry(run, {
+	randomize: true
+});
+```
+
+
 ### AbortError(message)
 ### AbortError(error)