npm - happy-dom - Versions diffs - 18.0.1 → 19.0.1 - Mend

happy-dom 18.0.1 → 19.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of happy-dom might be problematic. Click here for more details.

Files changed (2606) hide show

package/src/fetch/types/IFetchRequestHeaders.ts ADDED Viewed

@@ -0,0 +1,9 @@
+/**
+ * Fetch request header.
+ */
+export default interface IFetchRequestHeaders {
+	url?: string | RegExp | null;
+	headers: {
+		[key: string]: string;
+	};
+}

package/src/fetch/types/IResourceFetchResponse.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export default interface IResourceFetchResponse {
+	content: string;
+	virtualServerFile: string | null;
+}

package/src/fetch/types/ISyncResponse.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+import { PropertySymbol } from '../../index.js';
 import Headers from '../Headers.js';
 /**
@@ -13,4 +14,5 @@ export default interface ISyncResponse {
 	redirected: boolean;
 	headers: Headers;
 	body: Buffer | null;
+	[PropertySymbol.virtualServerFile]?: string | null;
 }

package/src/fetch/utilities/VirtualServerUtility.ts CHANGED Viewed

@@ -3,6 +3,7 @@ import WindowBrowserContext from '../../window/WindowBrowserContext.js';
 import Path from 'path';
 import Response from '../Response.js';
 import ISyncResponse from '../types/ISyncResponse.js';
+import * as PropertySymbol from '../../PropertySymbol.js';
 const NOT_FOUND_HTML =
 	'<html><head><title>Happy DOM Virtual Server - 404 Not Found</title></head><body><h1>Happy DOM Virtual Server - 404 Not Found</h1></body></html>';
@@ -84,7 +85,8 @@ export default class VirtualServerUtility {
 			headers: new window.Headers({
 				'Content-Type': 'text/html'
 			}),
-			body: Buffer.from(NOT_FOUND_HTML)
+			body: Buffer.from(NOT_FOUND_HTML),
+			[PropertySymbol.virtualServerFile]: null
 		};
 	}
 }

package/src/history/History.ts CHANGED Viewed

@@ -1,7 +1,6 @@
 import IBrowserFrame from '../browser/types/IBrowserFrame.js';
 import HistoryScrollRestorationEnum from './HistoryScrollRestorationEnum.js';
 import * as PropertySymbol from '../PropertySymbol.js';
-import IHistoryItem from './IHistoryItem.js';
 import BrowserFrameURL from '../browser/utilities/BrowserFrameURL.js';
 import DOMExceptionNameEnum from '../exception/DOMExceptionNameEnum.js';
 import BrowserWindow from '../window/BrowserWindow.js';
@@ -15,7 +14,6 @@ import BrowserWindow from '../window/BrowserWindow.js';
 export default class History {
 	#browserFrame: IBrowserFrame | null;
 	#window: BrowserWindow;
-	#currentHistoryItem: IHistoryItem;
 	/**
 	 * Constructor.
@@ -30,22 +28,6 @@ export default class History {
 		this.#browserFrame = browserFrame;
 		this.#window = window;
-		const history = browserFrame[PropertySymbol.history];
-		let currentHistoryItem: IHistoryItem | null = null;
-		for (let i = history.length - 1; i >= 0; i--) {
-			if (history[i].isCurrent) {
-				currentHistoryItem = history[i];
-				break;
-			}
-		}
-		if (!currentHistoryItem) {
-			throw new Error('No current history item found.');
-		}
-		this.#currentHistoryItem = currentHistoryItem;
 	}
 	/**
@@ -54,7 +36,7 @@ export default class History {
 	 * @returns History length.
 	 */
 	public get length(): number {
-		return this.#browserFrame?.[PropertySymbol.history].length || 0;
+		return this.#browserFrame?.[PropertySymbol.history].items.length || 0;
 	}
 	/**
@@ -63,7 +45,7 @@ export default class History {
 	 * @returns State.
 	 */
 	public get state(): object | null {
-		return this.#currentHistoryItem.state;
+		return this.#browserFrame?.[PropertySymbol.history].currentItem.state || null;
 	}
 	/**
@@ -72,7 +54,10 @@ export default class History {
 	 * @returns Sroll restoration.
 	 */
 	public get scrollRestoration(): HistoryScrollRestorationEnum {
-		return this.#currentHistoryItem.scrollRestoration;
+		return (
+			this.#browserFrame?.[PropertySymbol.history].currentItem.scrollRestoration ||
+			HistoryScrollRestorationEnum.auto
+		);
 	}
 	/**
@@ -84,7 +69,10 @@ export default class History {
 		switch (scrollRestoration) {
 			case HistoryScrollRestorationEnum.auto:
 			case HistoryScrollRestorationEnum.manual:
-				this.#currentHistoryItem.scrollRestoration = scrollRestoration;
+				const currentItem = this.#browserFrame?.[PropertySymbol.history].currentItem;
+				if (currentItem) {
+					currentItem.scrollRestoration = scrollRestoration;
+				}
 				break;
 		}
 	}
@@ -126,8 +114,8 @@ export default class History {
 	 * @param _unused Unused.
 	 * @param [url] URL.
 	 */
-	public pushState(state: object, _unused: any, url?: string | URL): void {
-		if (this.#window.closed || !this.#browserFrame) {
+	public pushState(state: any, _unused: any, url?: string | URL): void {
+		if (!this.#browserFrame || this.#window.closed) {
 			return;
 		}
@@ -137,44 +125,37 @@ export default class History {
 			return;
 		}
+		if (arguments.length < 2) {
+			throw new this.#window.TypeError(
+				`Failed to execute 'pushState' on 'History': 2 arguments required, but only ${arguments.length} present.`
+			);
+		}
 		const location = this.#window[PropertySymbol.location];
 		const newURL = url ? BrowserFrameURL.getRelativeURL(this.#browserFrame, url) : location;
 		if (url && newURL.origin !== location.origin) {
 			throw new this.#window.DOMException(
-				`Failed to execute 'pushState' on 'History': A history state object with URL '${url.toString()}' cannot be created in a document with origin '${location.origin}' and URL '${location.href}'.`,
+				`Failed to execute 'pushState' on 'History': A history state object with URL '${url.toString()}' cannot be created in a document with origin '${
+					location.origin
+				}' and URL '${location.href}'.`,
 				DOMExceptionNameEnum.securityError
 			);
 		}
-		let previousHistoryItem;
-		for (let i = history.length - 1; i >= 0; i--) {
-			if (history[i].isCurrent) {
-				previousHistoryItem = history[i];
-				previousHistoryItem.isCurrent = false;
-				// We need to remove all history items after the current one.
-				history.length = i + 1;
-				break;
-			}
-		}
+		history.currentItem.popState = true;
-		const newHistoryItem: IHistoryItem = {
+		history.push({
 			title: this.#window.document.title,
 			href: newURL.href,
-			state: JSON.parse(JSON.stringify(state)),
-			scrollRestoration: this.#currentHistoryItem.scrollRestoration,
-			method: previousHistoryItem?.method || 'GET',
-			formData: previousHistoryItem?.formData || null,
-			isCurrent: true
-		};
-		history.push(newHistoryItem);
-		location[PropertySymbol.setURL](this.#browserFrame, newHistoryItem.href);
-		this.#currentHistoryItem = newHistoryItem;
+			state,
+			popState: true,
+			scrollRestoration: history.currentItem.scrollRestoration,
+			method: history.currentItem.method || 'GET',
+			formData: history.currentItem.formData || null
+		});
+		location[PropertySymbol.setURL](this.#browserFrame, history.currentItem.href);
 	}
 	/**
@@ -184,7 +165,7 @@ export default class History {
 	 * @param _unused Unused.
 	 * @param [url] URL.
 	 */
-	public replaceState(state: object, _unused: any, url?: string | URL): void {
+	public replaceState(state: any, _unused: any, url?: string | URL): void {
 		if (!this.#browserFrame || this.#window.closed) {
 			return;
 		}
@@ -195,37 +176,36 @@ export default class History {
 			return;
 		}
+		if (arguments.length < 2) {
+			throw new this.#window.TypeError(
+				`Failed to execute 'pushState' on 'History': 2 arguments required, but only ${arguments.length} present.`
+			);
+		}
 		const location = this.#window[PropertySymbol.location];
 		const newURL = url ? BrowserFrameURL.getRelativeURL(this.#browserFrame, url) : location;
 		if (url && newURL.origin !== location.origin) {
 			throw new this.#window.DOMException(
-				`Failed to execute 'pushState' on 'History': A history state object with URL '${url.toString()}' cannot be created in a document with origin '${location.origin}' and URL '${location.href}'.`,
+				`Failed to execute 'pushState' on 'History': A history state object with URL '${url.toString()}' cannot be created in a document with origin '${
+					location.origin
+				}' and URL '${location.href}'.`,
 				DOMExceptionNameEnum.securityError
 			);
 		}
-		for (let i = history.length - 1; i >= 0; i--) {
-			if (history[i].isCurrent) {
-				const newHistoryItem = {
-					title: this.#window.document.title,
-					href: newURL.href,
-					state: JSON.parse(JSON.stringify(state)),
-					scrollRestoration: history[i].scrollRestoration,
-					method: history[i].method,
-					formData: history[i].formData,
-					isCurrent: true
-				};
-				history[i] = newHistoryItem;
-				this.#currentHistoryItem = newHistoryItem;
-				break;
-			}
-		}
+		history.replace({
+			title: this.#window.document.title,
+			href: newURL.href,
+			state,
+			popState: history.currentItem.popState,
+			scrollRestoration: history.currentItem.scrollRestoration,
+			method: history.currentItem.method,
+			formData: history.currentItem.formData
+		});
 		if (url) {
-			location[PropertySymbol.setURL](this.#browserFrame, this.#currentHistoryItem.href);
+			location[PropertySymbol.setURL](this.#browserFrame, history.currentItem.href);
 		}
 	}

package/src/history/HistoryItemList.ts ADDED Viewed

@@ -0,0 +1,72 @@
+import HistoryScrollRestorationEnum from './HistoryScrollRestorationEnum.js';
+import IHistoryItem from './IHistoryItem.js';
+/**
+ * History item list.
+ */
+export default class HistoryItemList {
+	public currentItem: IHistoryItem = {
+		title: '',
+		href: 'about:blank',
+		state: null,
+		popState: false,
+		scrollRestoration: HistoryScrollRestorationEnum.auto,
+		method: 'GET',
+		formData: null
+	};
+	public readonly items: IHistoryItem[] = [this.currentItem];
+	/**
+	 * History item list.
+	 *
+	 * @param historyItem History item.
+	 */
+	public push(historyItem: IHistoryItem): void {
+		const index = this.items.indexOf(this.currentItem);
+		// If the current item is not the last one, remove all items after it.
+		if (index !== this.items.length - 1) {
+			this.items.length = index + 1;
+		}
+		this.items.push(historyItem);
+		this.currentItem = historyItem;
+	}
+	/**
+	 *
+	 * @param historyItem
+	 */
+	public replace(historyItem: IHistoryItem): void {
+		const index = this.items.indexOf(this.currentItem);
+		// If the current item is not the last one, remove all items after it.
+		if (index !== this.items.length - 1) {
+			this.items.length = index + 1;
+		}
+		if (index === -1) {
+			throw new Error('Current history item not found');
+		}
+		this.currentItem = historyItem;
+		this.items[index] = historyItem;
+	}
+	/**
+	 * Clears history and sets current item to "about:blank".
+	 */
+	public clear(): void {
+		this.items.length = 0;
+		this.currentItem = {
+			title: '',
+			href: 'about:blank',
+			state: null,
+			popState: false,
+			scrollRestoration: HistoryScrollRestorationEnum.auto,
+			method: 'GET',
+			formData: null
+		};
+		this.items.push(this.currentItem);
+	}
+}

package/src/history/IHistoryItem.ts CHANGED Viewed

@@ -5,8 +5,8 @@ export default interface IHistoryItem {
 	title: string | null;
 	href: string;
 	state: any | null;
+	popState: boolean;
 	scrollRestoration: HistoryScrollRestorationEnum;
 	method: string;
 	formData: FormData | null;
-	isCurrent: boolean;
 }

package/src/html-serializer/HTMLSerializer.ts CHANGED Viewed

@@ -19,10 +19,12 @@ export default class HTMLSerializer {
 		serializableShadowRoots: boolean;
 		shadowRoots: ShadowRoot[] | null;
 		allShadowRoots: boolean;
+		excludeShadowRootTags: string[] | null;
 	} = {
 		serializableShadowRoots: false,
 		shadowRoots: null,
-		allShadowRoots: false
+		allShadowRoots: false,
+		excludeShadowRootTags: null
 	};
 	/**
@@ -32,11 +34,13 @@ export default class HTMLSerializer {
 	 * @param [options.serializableShadowRoots] If shadow roots should be serialized.
 	 * @param [options.shadowRoots] Shadow roots to serialize.
 	 * @param [options.allShadowRoots] If all shadow roots should be serialized.
+	 * @param [options.excludeShadowRootTags] Tags to exclude from serialization.
 	 */
 	constructor(options?: {
 		serializableShadowRoots?: boolean;
 		shadowRoots?: ShadowRoot[] | null;
 		allShadowRoots?: boolean;
+		excludeShadowRootTags?: string[] | null;
 	}) {
 		if (options) {
 			if (options.serializableShadowRoots) {
@@ -50,6 +54,10 @@ export default class HTMLSerializer {
 			if (options.allShadowRoots) {
 				this.options.allShadowRoots = options.allShadowRoots;
 			}
+			if (options.excludeShadowRootTags) {
+				this.options.excludeShadowRootTags = options.excludeShadowRootTags;
+			}
 		}
 	}
@@ -64,7 +72,7 @@ export default class HTMLSerializer {
 			case NodeTypeEnum.elementNode:
 				const element = <Element>root;
 				const prefix = element[PropertySymbol.prefix];
-				const localName = element[PropertySymbol.localName];
+				const localName = element[PropertySymbol.localName]!;
 				const config = HTMLElementConfig[<'a'>element[PropertySymbol.localName]];
 				const tagName = prefix ? `${prefix}:${localName}` : localName;
@@ -80,7 +88,9 @@ export default class HTMLSerializer {
 					(this.options.allShadowRoots ||
 						(this.options.serializableShadowRoots &&
 							element.shadowRoot[PropertySymbol.serializable]) ||
-						this.options.shadowRoots?.includes(element.shadowRoot))
+						this.options.shadowRoots?.includes(element.shadowRoot)) &&
+					(!this.options.excludeShadowRootTags ||
+						!this.options.excludeShadowRootTags.includes(tagName))
 				) {
 					innerHTML += `<template shadowrootmode="${element.shadowRoot[PropertySymbol.mode]}"${
 						element.shadowRoot[PropertySymbol.serializable] ? ' shadowrootserializable=""' : ''

package/src/index.ts CHANGED Viewed

@@ -19,14 +19,22 @@ import VirtualConsoleLogTypeEnum from './console/enums/VirtualConsoleLogTypeEnum
 import CookieSameSiteEnum from './cookie/enums/CookieSameSiteEnum.js';
 import CSSRule from './css/CSSRule.js';
 import CSSStyleSheet from './css/CSSStyleSheet.js';
+import MediaList from './css/MediaList.js';
 import CSSStyleDeclaration from './css/declaration/CSSStyleDeclaration.js';
+import CSSConditionRule from './css/rules/CSSConditionRule.js';
 import CSSContainerRule from './css/rules/CSSContainerRule.js';
 import CSSFontFaceRule from './css/rules/CSSFontFaceRule.js';
+import CSSGroupingRule from './css/rules/CSSGroupingRule.js';
 import CSSKeyframeRule from './css/rules/CSSKeyframeRule.js';
 import CSSKeyframesRule from './css/rules/CSSKeyframesRule.js';
 import CSSMediaRule from './css/rules/CSSMediaRule.js';
+import CSSScopeRule from './css/rules/CSSScopeRule.js';
 import CSSStyleRule from './css/rules/CSSStyleRule.js';
 import CSSSupportsRule from './css/rules/CSSSupportsRule.js';
+import CSSKeywordValue from './css/style-property-map/CSSKeywordValue.js';
+import CSSStyleValue from './css/style-property-map/CSSStyleValue.js';
+import StylePropertyMap from './css/style-property-map/StylePropertyMap.js';
+import StylePropertyMapReadOnly from './css/style-property-map/StylePropertyMapReadOnly.js';
 import CustomElementRegistry from './custom-element/CustomElementRegistry.js';
 import DOMParser from './dom-parser/DOMParser.js';
 import DOMRect from './dom/DOMRect.js';
@@ -50,6 +58,7 @@ import KeyboardEvent from './event/events/KeyboardEvent.js';
 import MediaQueryListEvent from './event/events/MediaQueryListEvent.js';
 import MouseEvent from './event/events/MouseEvent.js';
 import PointerEvent from './event/events/PointerEvent.js';
+import PopStateEvent from './event/events/PopStateEvent.js';
 import ProgressEvent from './event/events/ProgressEvent.js';
 import SubmitEvent from './event/events/SubmitEvent.js';
 import TouchEvent from './event/events/TouchEvent.js';
@@ -261,15 +270,20 @@ export {
 	ClipboardItem,
 	Comment,
 	CookieSameSiteEnum,
+	CSSConditionRule,
 	CSSContainerRule,
 	CSSFontFaceRule,
+	CSSGroupingRule,
 	CSSKeyframeRule,
 	CSSKeyframesRule,
+	CSSKeywordValue,
 	CSSMediaRule,
 	CSSRule,
+	CSSScopeRule,
 	CSSStyleDeclaration,
 	CSSStyleRule,
 	CSSStyleSheet,
+	CSSStyleValue,
 	CSSSupportsRule,
 	CustomElementRegistry,
 	CustomEvent,
@@ -377,6 +391,7 @@ export {
 	IntersectionObserverEntry,
 	KeyboardEvent,
 	Location,
+	MediaList,
 	MediaQueryListEvent,
 	MediaStream,
 	MediaStreamTrack,
@@ -389,6 +404,7 @@ export {
 	Permissions,
 	PermissionStatus,
 	PointerEvent,
+	PopStateEvent,
 	ProcessingInstruction,
 	ProgressEvent,
 	PropertySymbol,
@@ -401,6 +417,8 @@ export {
 	Selection,
 	ShadowRoot,
 	Storage,
+	StylePropertyMap,
+	StylePropertyMapReadOnly,
 	SubmitEvent,
 	SVGElement,
 	SVGGraphicsElement,

package/src/location/Location.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import IBrowserFrame from '../browser/types/IBrowserFrame.js';
 import HashChangeEvent from '../event/events/HashChangeEvent.js';
+import HistoryScrollRestorationEnum from '../history/HistoryScrollRestorationEnum.js';
 import * as PropertySymbol from '../PropertySymbol.js';
-import { URL } from 'url';
 /**
  * Location.
@@ -13,6 +13,8 @@ export default class Location {
 	// Private properties
 	#browserFrame: IBrowserFrame | null;
 	#url: URL;
+	#hashChangeTimeout: NodeJS.Timeout | null = null;
+	#hashChangeEvents: HashChangeEvent[] = [];
 	/**
 	 * Constructor.
@@ -43,18 +45,31 @@ export default class Location {
 	 * @param hash Value.
 	 */
 	public set hash(hash: string) {
-		if (!this.#browserFrame) {
+		const history = this.#browserFrame?.[PropertySymbol.history];
+		if (!history || !this.#browserFrame) {
 			return;
 		}
-		const oldURL = this.#url.href;
-		this.#url.hash = hash;
-		const newURL = this.#url.href;
-		if (newURL !== oldURL) {
-			this.#browserFrame.window?.dispatchEvent(
-				new HashChangeEvent('hashchange', { oldURL, newURL })
-			);
-			this.#browserFrame.window?.document?.[PropertySymbol.clearCache]();
+		const url = new URL(this.#url.href);
+		const oldHash = this.#url.hash;
+		url.hash = hash;
+		if (url.hash !== oldHash) {
+			history.currentItem.popState = true;
+			history.push({
+				title: '',
+				href: url.href,
+				state: history.currentItem.state,
+				popState: true,
+				scrollRestoration: HistoryScrollRestorationEnum.manual,
+				method: history.currentItem.method,
+				formData: history.currentItem.formData || null
+			});
+			this[PropertySymbol.setURL](this.#browserFrame, url.href);
 		}
 	}
@@ -114,7 +129,7 @@ export default class Location {
 		}
 		this.#browserFrame.goto(url).catch((error) => {
-			if (this.#browserFrame?.page.console) {
+			if (this.#browserFrame?.page?.console) {
 				this.#browserFrame.page.console.error(error);
 			} else {
 				throw error;
@@ -261,13 +276,35 @@ export default class Location {
 			throw new Error('Failed to set URL. Browser frame mismatch.');
 		}
+		const oldURL = this.#url.href;
+		const oldHash = this.#url.hash;
 		this.#url.href = url;
+		if (this.#url.hash !== oldHash) {
+			const newURL = this.#url.href;
+			this.#hashChangeEvents.push(new HashChangeEvent('hashchange', { oldURL, newURL }));
+			if (this.#hashChangeTimeout) {
+				this.#browserFrame.window?.clearTimeout(this.#hashChangeTimeout);
+			}
+			this.#hashChangeTimeout = this.#browserFrame.window?.setTimeout(() => {
+				const hashChangeEvents = this.#hashChangeEvents;
+				this.#hashChangeEvents = [];
+				for (const event of hashChangeEvents) {
+					this.#browserFrame?.window?.dispatchEvent(event);
+				}
+				this.#browserFrame?.window?.document?.[PropertySymbol.clearCache]();
+			});
+		}
 	}
 	/**
 	 * Destroys the location.
 	 */
 	public [PropertySymbol.destroy](): void {
+		if (this.#hashChangeTimeout) {
+			this.#browserFrame?.window?.clearTimeout(this.#hashChangeTimeout);
+		}
 		this.#browserFrame = null;
 	}

package/src/module/ECMAScriptModule.ts CHANGED Viewed

@@ -8,7 +8,7 @@ import WindowBrowserContext from '../window/WindowBrowserContext.js';
 import IECMAScriptModuleCompiledResult from './IECMAScriptModuleCompiledResult.js';
 import ModuleFactory from './ModuleFactory.js';
-const EMPTY_COMPILED_RESULT = { imports: [], execute: () => {} };
+const EMPTY_COMPILED_RESULT = { imports: [], execute: async () => {} };
 /**
  * ECMAScript module.
@@ -17,6 +17,7 @@ export default class ECMAScriptModule implements IModule {
 	public readonly url: URL;
 	public readonly [PropertySymbol.window]: BrowserWindow;
 	readonly #source: string;
+	readonly #sourceURL: string | null;
 	#preloaded: boolean = false;
 	#compiled: IECMAScriptModuleCompiledResult | null = null;
 	#exports: { [k: string]: any } | null = null;
@@ -27,11 +28,18 @@ export default class ECMAScriptModule implements IModule {
 	 * @param window Window.
 	 * @param url Module URL.
 	 * @param source Source code.
+	 * @param [sourceURL] Source URL.
 	 */
-	constructor(window: BrowserWindow, url: URL | Location, source: string) {
+	constructor(
+		window: BrowserWindow,
+		url: URL | Location,
+		source: string,
+		sourceURL?: string | null
+	) {
 		this[PropertySymbol.window] = window;
 		this.url = <URL>url;
 		this.#source = source;
+		this.#sourceURL = sourceURL || null;
 	}
 	/**
@@ -70,12 +78,17 @@ export default class ECMAScriptModule implements IModule {
 		}
 		const exports = {};
+		const href = this.url.href;
 		this.#exports = exports;
 		compiled.execute({
 			dispatchError: window[PropertySymbol.dispatchError].bind(window),
 			dynamicImport: this.#import.bind(this),
+			importMeta: {
+				url: href,
+				resolve: (url: string) => new URL(url, href).href
+			},
 			imports,
 			exports
 		});
@@ -135,7 +148,7 @@ export default class ECMAScriptModule implements IModule {
 		const compiler = new ECMAScriptModuleCompiler(this[PropertySymbol.window]);
-		this.#compiled = compiler.compile(this.url.href, this.#source);
+		this.#compiled = compiler.compile(this.url.href, this.#source, this.#sourceURL);
 		return this.#compiled;
 	}