summaryrefslogtreecommitdiffstats
path: root/remote/test/puppeteer/packages/puppeteer-core/src/util/DeferredPromise.ts
blob: 8c7945e3591e63770792e92591bbeb4ab5c6c02a (plain)
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
import {TimeoutError} from '../common/Errors.js';

/**
 * @internal
 */
export interface DeferredPromise<T> extends Promise<T> {
  finished: () => boolean;
  resolved: () => boolean;
  resolve: (value: T) => void;
  reject: (reason?: unknown) => void;
}

/**
 * @internal
 */
export interface DeferredPromiseOptions {
  message: string;
  timeout: number;
}

/**
 * Creates and returns a promise along with the resolve/reject functions.
 *
 * If the promise has not been resolved/rejected within the `timeout` period,
 * the promise gets rejected with a timeout error. `timeout` has to be greater than 0 or
 * it is ignored.
 *
 * @internal
 */
export function createDeferredPromise<T>(
  opts?: DeferredPromiseOptions
): DeferredPromise<T> {
  let isResolved = false;
  let isRejected = false;
  let resolver: (value: T) => void;
  let rejector: (reason?: unknown) => void;
  const taskPromise = new Promise<T>((resolve, reject) => {
    resolver = resolve;
    rejector = reject;
  });
  const timeoutId =
    opts && opts.timeout > 0
      ? setTimeout(() => {
          isRejected = true;
          rejector(new TimeoutError(opts.message));
        }, opts.timeout)
      : undefined;
  return Object.assign(taskPromise, {
    resolved: () => {
      return isResolved;
    },
    finished: () => {
      return isResolved || isRejected;
    },
    resolve: (value: T) => {
      if (timeoutId) {
        clearTimeout(timeoutId);
      }
      isResolved = true;
      resolver(value);
    },
    reject: (err?: unknown) => {
      clearTimeout(timeoutId);
      isRejected = true;
      rejector(err);
    },
  });
}