puppeteer-core/src/util/DebuggableDeferred.ts

A high-level API to control headless Chrome over the DevTools Protocol

import {DEFERRED_PROMISE_DEBUG_TIMEOUT} from '../environment.js';

import {Deferred} from './Deferred.js';

/**
 * Creates and returns a deferred promise using DEFERRED_PROMISE_DEBUG_TIMEOUT
 * if it's specified or a normal deferred promise otherwise.
 *
 * @internal
 */
export function createDebuggableDeferred<T>(message: string): Deferred<T> {
  if (DEFERRED_PROMISE_DEBUG_TIMEOUT > 0) {
    return Deferred.create({
      message,
      timeout: DEFERRED_PROMISE_DEBUG_TIMEOUT,
    });
  }
  return Deferred.create();
}