Add .range() method

index.d.ts

@@ -55,6 +55,24 @@ type Delay = {
 		}
 	): delay.ClearablePromise<T>;
 
+	/**
+	Create a promise which resolves after a random amount of milliseconds between `minimum` and `maximum` has passed.
+
+	@param minimum - Minimum amount of milliseconds to delay the promise.
+	@param maximum - Maximum amount of milliseconds to delay the promise.
+	@returns A promise which resolves after a random amount of milliseconds between `maximum` and `maximum` has passed.
+	*/
+	range<T>(
+		minimum: number,
+		maximum: number,
+		options?: delay.Options & {
+			/**
+			Value to resolve in the returned promise.
+			*/
+			value: T;
+		}
+	): delay.ClearablePromise<T>;
+
 	/**
 	Create a promise which rejects after the specified `milliseconds`.
 

index.js

@@ -1,4 +1,5 @@
 'use strict';
+const randomInteger = require('random-int');
 
 const createAbortError = () => {
 	const error = new Error('Delay aborted');
@@ -56,6 +57,7 @@ const createDelay = ({clearTimeout: defaultClear, setTimeout: set, willResolve})
 
 const delay = createDelay({willResolve: true});
 delay.reject = createDelay({willResolve: false});
+delay.range = (minimum, maximum, options) => delay(randomInteger(minimum, maximum), options);
 delay.createWithTimers = ({clearTimeout, setTimeout}) => {
 	const delay = createDelay({clearTimeout, setTimeout, willResolve: true});
 	delay.reject = createDelay({clearTimeout, setTimeout, willResolve: false});

index.test-d.ts

@@ -11,6 +11,8 @@ expectType<ClearablePromise<void>>(
 	delay(200, {signal: new AbortController().signal})
 );
 
+expectType<ClearablePromise<number>>(delay.range(50, 200, { value: 0 }));
+
 expectType<ClearablePromise<never>>(delay.reject(200, {value: '🦄'}));
 expectType<ClearablePromise<never>>(delay.reject(200, {value: 0}));
 

package.json

@@ -38,6 +38,9 @@
 		"promises",
 		"bluebird"
 	],
+	"dependencies": {
+		"random-int": "^2.0.1"
+	},
 	"devDependencies": {
 		"abort-controller": "^3.0.0",
 		"ava": "1.4.1",

readme.md

@@ -36,7 +36,11 @@ Create a promise which resolves after the specified `milliseconds`.
 
 Create a promise which rejects after the specified `milliseconds`.
 
-#### milliseconds
+### delay.range(minimum, maximum, [options])
+
+Create a promise which resolves after a random amount of milliseconds between `minimum` and `maximum` has passed.
+
+#### milliseconds (minimum and maximum for delay.range)
 
 Type: `number`
 

test.js

@@ -163,3 +163,9 @@ test('can create a new instance with fixed timeout methods', async t => {
 	t.is(cleared.length, 1);
 	t.is(cleared[0], callbacks[2].handle);
 });
+
+test('returns a promise that is resolved in a random range of time', async t => {
+	const end = timeSpan();
+	await m.range(50, 150);
+	t.true(inRange(end(), 30, 170), 'is delayed');
+});