@bexer/error-event-listeners/esm/index.js

import Debug from '@bexer/commons/esm/private/debug';
import { mandatory, assert, timeouted } from '@bexer/utils';
import * as ErrorTypes from '@bexer/commons/esm/error-types';
import { areProxySettingsControlledAsync } from './private/proxy-settings';

const debug = Debug('bexer:catcher');

const bgName = 'BG';
/**
 * @param {Window} hostWindow
*/
const generateNameForDebug = (hostWindow) => {

  if (hostWindow === window) {
    return bgName;
  }
  return hostWindow.location.href
    .replace(/^.+\//, '')
    .replace(/.html$/, '')
    .toUpperCase();
};

/**
  @param {{
    hostWindow: Window,
    typedErrorEventListener: (
      _: ErrorTypesTS,
      __: ErrorEvent | chrome.proxy.ErrorDetails,
    ) => any,
    nameForDebug?: string,
    onlyTheseErrorTypes?: ErrorTypesTS[],
  }} _
  @param {Function} [cb]
*/
// eslint-disable-next-line
export const installTypedErrorEventListenersOn = ({
  hostWindow = mandatory(),
  typedErrorEventListener = mandatory(),
  nameForDebug = generateNameForDebug(hostWindow),
  onlyTheseErrorTypes = [ErrorTypes.EXT_ERROR, ErrorTypes.PAC_ERROR],
}, cb) => {

  const ifInBg = hostWindow === window;
  if (ifInBg) {
    assert(
      nameForDebug === 'BG',
      `Background window can't have name other than "${bgName}" (default value).`,
    );
  } else {
    assert(nameForDebug !== 'BG', 'nameForDebug "BG" is already assigned to the background window, choose something different.');
  }
  debug(ifInBg ? 'Installing handlers in BG.' : `Installing handlers in ${nameForDebug}.`);

  /** @type {Function[]} */
  const uninstallers = [];
  const ifExtErr = onlyTheseErrorTypes.includes(ErrorTypes.EXT_ERROR);
  if (ifExtErr) {
    /** @param {ErrorEvent} errorEvent */
    const errorHandler = (errorEvent) => {

      debug(nameForDebug, 'caught:', errorEvent);
      typedErrorEventListener(ErrorTypes.EXT_ERROR, errorEvent);
    };

    const ifUseCapture = true;
    hostWindow.addEventListener('error', errorHandler, ifUseCapture);
    uninstallers.push(() =>
      hostWindow.removeEventListener('error', errorHandler, ifUseCapture),
    );
    /**
      @param {PromiseRejectionEvent} event
      @returns {never}
    */
    const rejHandler = (event) => {

      event.preventDefault();
      debug(nameForDebug, 'rethrowing promise...');
      throw event.reason;

    };

    hostWindow.addEventListener('unhandledrejection', rejHandler, ifUseCapture);
    uninstallers.push(() =>
      hostWindow.removeEventListener('unhandledrejection', rejHandler, ifUseCapture),
    );
  }

  const ifPacErr = onlyTheseErrorTypes.includes(ErrorTypes.PAC_ERROR);
  if (chrome.proxy && ifInBg && ifPacErr) {
    /**
      @param {chrome.proxy.ErrorDetails} details
    */
    const listener = async (details) => {

      // TODO: This handler is not timeouted.
      // TODO: Test throwing error here and catching it.
      const ifControlled = await areProxySettingsControlledAsync();
      if (!ifControlled) {
        // PAC script is not controlled by this extension,
        // so its errors are caused by other extensoin.
        return;
      }
      /*
        Example: {
          details: "line: 7: Uncaught Error: This is error, man.",
          error: "net::ERR_PAC_SCRIPT_FAILED",
          fatal: false,
        }
      */
      typedErrorEventListener(ErrorTypes.PAC_ERROR, details);
    };
    chrome.proxy.onProxyError.addListener(listener);
    uninstallers.push(() =>
      chrome.proxy.onProxyError.removeListener(listener),
    );
  }

  const uninstallErrorHandlers = () => uninstallers.forEach((f) => f());

  if (cb) {
    timeouted(cb)(uninstallErrorHandlers);
  }

  return uninstallErrorHandlers;
};