1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
declare namespace delay {
interface ClearablePromise<T> extends Promise<T> {
/**
Clears the delay and settles the promise.
*/
clear(): void;
}
/**
Minimal subset of `AbortSignal` that delay will use if passed.
This avoids a dependency on dom.d.ts.
The dom.d.ts `AbortSignal` is compatible with this one.
*/
interface AbortSignal {
readonly aborted: boolean;
addEventListener(
type: 'abort',
listener: () => void,
options?: {once?: boolean}
): void;
removeEventListener(type: 'abort', listener: () => void): void;
}
interface Options {
/**
An optional AbortSignal to abort the delay.
If aborted, the Promise will be rejected with an AbortError.
*/
signal?: AbortSignal;
}
}
type Delay = {
/**
Create a promise which resolves after the specified `milliseconds`.
@param milliseconds - Milliseconds to delay the promise.
@returns A promise which resolves after the specified `milliseconds`.
*/
(milliseconds: number, options?: delay.Options): delay.ClearablePromise<void>;
/**
Create a promise which resolves after the specified `milliseconds`.
@param milliseconds - Milliseconds to delay the promise.
@returns A promise which resolves after the specified `milliseconds`.
*/
<T>(
milliseconds: 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`.
@param milliseconds - Milliseconds to delay the promise.
@returns A promise which rejects after the specified `milliseconds`.
*/
// TODO: Allow providing value type after https://github.com/Microsoft/TypeScript/issues/5413 will be resolved.
reject(
milliseconds: number,
options?: delay.Options & {
/**
Value to reject in the returned promise.
*/
value?: unknown;
}
): delay.ClearablePromise<never>;
};
declare const delay: Delay & {
createWithTimers(timers: {
clearTimeout: typeof clearTimeout;
setTimeout: typeof setTimeout;
}): Delay;
// TODO: Remove this for the next major release
default: typeof delay;
};
export = delay;
|
