happy-dom/src/module/UnresolvedModule.ts

Happy DOM is a JavaScript implementation of a web browser without its graphical user interface. It includes many web standards from WHATWG DOM and HTML.

import type BrowserWindow from '../window/BrowserWindow.js';
import type { URL } from 'url';
import type IModule from './types/IModule.js';

interface IUnresolvedModuleInit {
	window: BrowserWindow;
	url: URL;
}

/**
 * CSS module.
 */
export default class UnresolvedModule implements IModule {
	public readonly url: URL;
	readonly #window: BrowserWindow;
	#hooks: { resolve: (value: unknown) => void; reject: (error: Error) => void }[] = [];
	#error: Error | null = null;

	/**
	 * Constructor.
	 *
	 * @param init Initialization options.
	 */
	constructor(init: IUnresolvedModuleInit) {
		this.#window = init.window;
		this.url = init.url;
	}

	/**
	 * Compiles and evaluates the module.
	 *
	 * @returns Module exports.
	 */
	public async evaluate(): Promise<any> {
		throw new this.#window.TypeError('Unresolved module. We should never end up here.');
	}

	/**
	 * Compiles and preloads the module and its imports.
	 *
	 * @returns Promise.
	 */
	public async preload(): Promise<void> {
		throw new this.#window.TypeError('Unresolved module. We should never end up here.');
	}

	/**
	 * Add a hook to be called when the module is resolved.
	 *
	 * @param resolve Resolve.
	 * @param reject Reject.
	 */
	public addResolveListener(
		resolve: (value: unknown) => void,
		reject: (error: Error) => void
	): void {
		if (this.#error) {
			reject(this.#error);
			return;
		}
		this.#hooks.push({ resolve, reject });
	}

	/**
	 * Resolves the module.
	 *
	 * @param [error] Error.
	 */
	public resolve(error?: Error): void {
		if (error) {
			this.#error = error;
		}
		for (const hook of this.#hooks) {
			if (error) {
				hook.reject(error);
			} else {
				hook.resolve(null);
			}
		}
	}
}