happy-dom 16.8.1 → 17.0.1

package/src/fetch/preload/PreloadEntry.ts

@@ -0,0 +1,46 @@
+import Response from '../Response.js';
+
+/**
+ * Preload entry.
+ *
+ * @see https://html.spec.whatwg.org/multipage/links.html#preload-entry
+ */
+export default class PreloadEntry {
+	public integrityMetadata: string | null = null;
+	public response: Response | null = null;
+	public error: Error | null = null;
+	#callback: { resolve: (response: Response) => void; reject: (error: Error) => void } | null =
+		null;
+
+	/**
+	 * On response available.
+	 *
+	 * @returns Response.
+	 */
+	public onResponseAvailable(): Promise<Response> {
+		return new Promise((resolve, reject) => {
+			this.#callback = { resolve, reject };
+		});
+	}
+
+	/**
+	 * Response available.
+	 *
+	 * @param error
+	 * @param response
+	 */
+	public responseAvailable(error: Error | null, response: Response): void {
+		this.response = response;
+		this.error = error;
+
+		if (!this.#callback) {
+			return;
+		}
+
+		if (error) {
+			this.#callback.reject(error);
+		} else {
+			this.#callback.resolve(response);
+		}
+	}
+}

package/src/fetch/preload/PreloadUtility.ts

@@ -0,0 +1,33 @@
+import IRequestCredentials from '../types/IRequestCredentials.js';
+import IRequestMode from '../types/IRequestMode.js';
+
+/**
+ * Utility for preloading resources.
+ *
+ * @see https://html.spec.whatwg.org/multipage/links.html#link-type-preload
+ */
+export default class PreloadUtility {
+	/**
+	 * Returns a key for a preload entry.
+	 *
+	 * @param options Options.
+	 * @param options.url URL.
+	 * @param options.destination Destination.
+	 * @param options.mode Mode.
+	 * @param options.credentialsMode Credentials mode.
+	 * @returns Key.
+	 */
+	public static getKey(options: {
+		url: string;
+		destination: string;
+		mode: IRequestMode;
+		credentialsMode: IRequestCredentials;
+	}): string {
+		return JSON.stringify({
+			url: options.url,
+			destination: options.destination,
+			mode: options.mode,
+			credentialsMode: options.credentialsMode
+		});
+	}
+}

package/src/fetch/types/IRequestInit.ts

@@ -5,6 +5,7 @@ import IRequestReferrerPolicy from './IRequestReferrerPolicy.js';
 import IRequestRedirect from './IRequestRedirect.js';
 import IRequestBody from './IRequestBody.js';
 import IRequestCredentials from './IRequestCredentials.js';
+import IRequestMode from './IRequestMode.js';
 
 /**
  * Fetch request init.
@@ -13,6 +14,7 @@ export default interface IRequestInit {
 	body?: IRequestBody;
 	headers?: IHeadersInit;
 	method?: string;
+	mode?: IRequestMode;
 	redirect?: IRequestRedirect;
 	signal?: AbortSignal | null;
 	referrer?: '' | 'no-referrer' | 'client' | string | URL;

package/src/fetch/types/IRequestMode.ts

@@ -0,0 +1,2 @@
+type IRequestMode = 'same-origin' | 'cors' | 'no-cors' | 'navigate' | 'websocket';
+export default IRequestMode;

package/src/fetch/utilities/FetchRequestReferrerUtility.ts

@@ -31,7 +31,7 @@ export default class FetchRequestReferrerUtility {
 	 */
 	public static prepareRequest(originURL: URL, request: Request): void {
 		if (!request.referrerPolicy) {
-			(<string>request.referrerPolicy) = 'strict-origin-when-cross-origin';
+			request[PropertySymbol.referrerPolicy] = 'strict-origin-when-cross-origin';
 		}
 
 		if (request.referrer && request.referrer !== 'no-referrer') {

package/src/module/CSSModule.ts

@@ -0,0 +1,54 @@
+import BrowserWindow from '../window/BrowserWindow.js';
+import { URL } from 'url';
+import IModule from './IModule.js';
+import CSSStyleSheet from '../css/CSSStyleSheet.js';
+
+/**
+ * CSS module.
+ */
+export default class CSSModule implements IModule {
+	public readonly url: URL;
+	readonly #window: BrowserWindow;
+	readonly #source: string;
+	#exports: { default: CSSStyleSheet } | null = null;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param window Window.
+	 * @param url Module URL.
+	 * @param source Source code.
+	 */
+	constructor(window: BrowserWindow, url: URL, source: string) {
+		this.#window = window;
+		this.url = url;
+		this.#source = source;
+	}
+
+	/**
+	 * Compiles and evaluates the module.
+	 *
+	 * @returns Module exports.
+	 */
+	public async evaluate(): Promise<{ default: CSSStyleSheet }> {
+		if (this.#exports) {
+			return this.#exports;
+		}
+
+		const styleSheet = new this.#window.CSSStyleSheet();
+		styleSheet.replaceSync(this.#source);
+
+		this.#exports = { default: styleSheet };
+
+		return this.#exports;
+	}
+
+	/**
+	 * Compiles and preloads the module and its imports.
+	 *
+	 * @returns Promise.
+	 */
+	public async preload(): Promise<void> {
+		await this.evaluate();
+	}
+}

package/src/module/ECMAScriptModule.ts

@@ -0,0 +1,171 @@
+import BrowserWindow from '../window/BrowserWindow.js';
+import { URL } from 'url';
+import IModule from './IModule.js';
+import ECMAScriptModuleCompiler from './ECMAScriptModuleCompiler.js';
+import * as PropertySymbol from '../PropertySymbol.js';
+import Location from '../location/Location.js';
+import WindowBrowserContext from '../window/WindowBrowserContext.js';
+import IECMAScriptModuleCompiledResult from './IECMAScriptModuleCompiledResult.js';
+import ModuleFactory from './ModuleFactory.js';
+
+const EMPTY_COMPILED_RESULT = { imports: [], execute: () => {} };
+
+/**
+ * ECMAScript module.
+ */
+export default class ECMAScriptModule implements IModule {
+	public readonly url: URL;
+	public readonly [PropertySymbol.window]: BrowserWindow;
+	readonly #source: string;
+	#preloaded: boolean = false;
+	#compiled: IECMAScriptModuleCompiledResult | null = null;
+	#exports: { [k: string]: any } | null = null;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param window Window.
+	 * @param url Module URL.
+	 * @param source Source code.
+	 */
+	constructor(window: BrowserWindow, url: URL | Location, source: string) {
+		this[PropertySymbol.window] = window;
+		this.url = <URL>url;
+		this.#source = source;
+	}
+
+	/**
+	 * Compiles and evaluates the module.
+	 *
+	 * @returns Module exports.
+	 */
+	public async evaluate(): Promise<{ [key: string]: any } | null> {
+		if (this.#exports) {
+			return this.#exports;
+		}
+
+		const compiled = this.#compile();
+		const modulePromises: Promise<IModule>[] = [];
+		const window = this[PropertySymbol.window];
+		const browserFrame = new WindowBrowserContext(window).getBrowserFrame();
+
+		if (!browserFrame) {
+			return {};
+		}
+
+		for (const moduleImport of compiled.imports) {
+			modulePromises.push(
+				ModuleFactory.getModule(window, this.url, moduleImport.url, {
+					with: { type: moduleImport.type }
+				})
+			);
+		}
+
+		const modules = await Promise.all(modulePromises);
+
+		const imports = new Map<string, { [key: string]: any }>();
+
+		for (const module of modules) {
+			imports.set(module.url.href, await module.evaluate());
+		}
+
+		const exports = {};
+
+		this.#exports = exports;
+
+		compiled.execute({
+			dispatchError: window[PropertySymbol.dispatchError].bind(window),
+			dynamicImport: this.#import.bind(this),
+			imports,
+			exports
+		});
+
+		return exports;
+	}
+
+	/**
+	 * Compiles and preloads the module and its imports.
+	 *
+	 * @returns Promise.
+	 */
+	public async preload(): Promise<void> {
+		if (this.#preloaded) {
+			return;
+		}
+
+		this.#preloaded = true;
+
+		const compiled = this.#compile();
+		const modulePromises: Promise<IModule>[] = [];
+		const window = this[PropertySymbol.window];
+		const browserFrame = new WindowBrowserContext(window).getBrowserFrame();
+
+		if (!browserFrame) {
+			return;
+		}
+
+		for (const moduleImport of compiled.imports) {
+			modulePromises.push(
+				ModuleFactory.getModule(window, this.url, moduleImport.url, {
+					with: { type: moduleImport.type }
+				})
+			);
+		}
+
+		const modules = await Promise.all(modulePromises);
+
+		const promises: Promise<void>[] = [];
+		for (const module of modules) {
+			promises.push(module.preload());
+		}
+
+		await Promise.all(promises);
+	}
+
+	/**
+	 * Compiles the module.
+	 */
+	#compile(): IECMAScriptModuleCompiledResult {
+		if (this.#compiled) {
+			return this.#compiled;
+		}
+
+		// In case of an error, the compiled module will be empty.
+		this.#compiled = EMPTY_COMPILED_RESULT;
+
+		const compiler = new ECMAScriptModuleCompiler(this[PropertySymbol.window]);
+
+		this.#compiled = compiler.compile(this.url.href, this.#source);
+
+		return this.#compiled;
+	}
+
+	/**
+	 * Imports a module.
+	 *
+	 * @param url URL.
+	 * @param [options] Options.
+	 * @param [options.with] With.
+	 * @param [options.with.type] Type.
+	 */
+	async #import(
+		url: string,
+		options?: { with?: { type?: string } }
+	): Promise<{ [key: string]: any }> {
+		const window = this[PropertySymbol.window];
+		const browserFrame = new WindowBrowserContext(window).getBrowserFrame();
+
+		if (!browserFrame) {
+			return;
+		}
+
+		const asyncTaskManager = browserFrame[PropertySymbol.asyncTaskManager];
+		const taskID = asyncTaskManager?.startTask();
+		const module = await ModuleFactory.getModule(window, this.url, url, options);
+		const exports = await module.evaluate();
+
+		asyncTaskManager.endTask(taskID);
+
+		return exports;
+	}
+}