happy-dom 15.0.0 → 15.2.0

package/src/history/History.ts

@@ -3,7 +3,6 @@ import HistoryScrollRestorationEnum from './HistoryScrollRestorationEnum.js';
 import * as PropertySymbol from '../PropertySymbol.js';
 import IHistoryItem from './IHistoryItem.js';
 import BrowserFrameURL from '../browser/utilities/BrowserFrameURL.js';
-import DOMException from '../exception/DOMException.js';
 import DOMExceptionNameEnum from '../exception/DOMExceptionNameEnum.js';
 import BrowserWindow from '../window/BrowserWindow.js';
 
@@ -15,18 +14,22 @@ import BrowserWindow from '../window/BrowserWindow.js';
  */
 export default class History {
 	#browserFrame: IBrowserFrame;
-	#ownerWindow: BrowserWindow;
+	#window: BrowserWindow;
 	#currentHistoryItem: IHistoryItem;
 
 	/**
 	 * Constructor.
 	 *
 	 * @param browserFrame Browser frame.
-	 * @param ownerWindow Owner window.
+	 * @param window Owner window.
 	 */
-	constructor(browserFrame: IBrowserFrame, ownerWindow: BrowserWindow) {
+	constructor(browserFrame: IBrowserFrame, window: BrowserWindow) {
+		if (!browserFrame) {
+			throw new TypeError('Illegal constructor');
+		}
+
 		this.#browserFrame = browserFrame;
-		this.#ownerWindow = ownerWindow;
+		this.#window = window;
 
 		const history = browserFrame[PropertySymbol.history];
 
@@ -83,14 +86,18 @@ export default class History {
 	 * Goes to the previous page in session history.
 	 */
 	public back(): void {
-		this.#browserFrame.goBack();
+		if (!this.#window.closed) {
+			this.#browserFrame.goBack();
+		}
 	}
 
 	/**
 	 * Goes to the next page in session history.
 	 */
 	public forward(): void {
-		this.#browserFrame.goForward();
+		if (!this.#window.closed) {
+			this.#browserFrame.goForward();
+		}
 	}
 
 	/**
@@ -100,7 +107,9 @@ export default class History {
 	 * @param _delta
 	 */
 	public go(delta: number): void {
-		this.#browserFrame.goSteps(delta);
+		if (!this.#window.closed) {
+			this.#browserFrame.goSteps(delta);
+		}
 	}
 
 	/**
@@ -111,17 +120,21 @@ export default class History {
 	 * @param [url] URL.
 	 */
 	public pushState(state: object, title, url?: string): void {
+		if (this.#window.closed) {
+			return;
+		}
+
 		const history = this.#browserFrame[PropertySymbol.history];
 
 		if (!history) {
 			return;
 		}
 
-		const location = this.#ownerWindow[PropertySymbol.location];
+		const location = this.#window[PropertySymbol.location];
 		const newURL = url ? BrowserFrameURL.getRelativeURL(this.#browserFrame, url) : location;
 
 		if (url && newURL.origin !== location.origin) {
-			throw new DOMException(
+			throw new this.#window.DOMException(
 				`Failed to execute 'pushState' on 'History': A history state object with URL '${url}' cannot be created in a document with origin '${location.origin}' and URL '${location.href}'.`,
 				DOMExceptionNameEnum.securityError
 			);
@@ -141,7 +154,7 @@ export default class History {
 		}
 
 		const newHistoryItem: IHistoryItem = {
-			title: title || this.#ownerWindow.document.title,
+			title: title || this.#window.document.title,
 			href: newURL.href,
 			state: JSON.parse(JSON.stringify(state)),
 			scrollRestoration: this.#currentHistoryItem.scrollRestoration,
@@ -165,17 +178,21 @@ export default class History {
 	 * @param [url] URL.
 	 */
 	public replaceState(state: object, title, url?: string): void {
+		if (this.#window.closed) {
+			return;
+		}
+
 		const history = this.#browserFrame[PropertySymbol.history];
 
 		if (!history) {
 			return;
 		}
 
-		const location = this.#ownerWindow[PropertySymbol.location];
+		const location = this.#window[PropertySymbol.location];
 		const newURL = url ? BrowserFrameURL.getRelativeURL(this.#browserFrame, url) : location;
 
 		if (url && newURL.origin !== location.origin) {
-			throw new DOMException(
+			throw new this.#window.DOMException(
 				`Failed to execute 'pushState' on 'History': A history state object with URL '${url}' cannot be created in a document with origin '${location.origin}' and URL '${location.href}'.`,
 				DOMExceptionNameEnum.securityError
 			);
@@ -184,7 +201,7 @@ export default class History {
 		for (let i = history.length - 1; i >= 0; i--) {
 			if (history[i].isCurrent) {
 				const newHistoryItem = {
-					title: title || this.#ownerWindow.document.title,
+					title: title || this.#window.document.title,
 					href: newURL.href,
 					state: JSON.parse(JSON.stringify(state)),
 					scrollRestoration: history[i].scrollRestoration,

package/src/index.ts

@@ -188,7 +188,7 @@ import type IBrowserPage from './browser/types/IBrowserPage.js';
 import type IBrowserSettings from './browser/types/IBrowserSettings.js';
 import type IOptionalBrowserSettings from './browser/types/IOptionalBrowserSettings.js';
 import type IEventInit from './event/IEventInit.js';
-import type IEventListener from './event/IEventListener.js';
+import type TEventListener from './event/TEventListener.js';
 import type ITouchInit from './event/ITouchInit.js';
 import type IUIEventInit from './event/IUIEventInit.js';
 import type IAnimationEventInit from './event/events/IAnimationEventInit.js';
@@ -217,7 +217,7 @@ export type {
 	ICustomEventInit,
 	IErrorEventInit,
 	IEventInit,
-	IEventListener,
+	TEventListener,
 	IFocusEventInit,
 	IHashChangeEventInit,
 	IInputEventInit,

package/src/location/Location.ts

@@ -21,6 +21,9 @@ export default class Location {
 	 * @param url URL.
 	 */
 	constructor(browserFrame: IBrowserFrame, url: string) {
+		if (!browserFrame) {
+			throw new TypeError('Illegal constructor');
+		}
 		this.#browserFrame = browserFrame;
 		this.#url = new URL(url);
 	}
@@ -40,6 +43,10 @@ export default class Location {
 	 * @param hash Value.
 	 */
 	public set hash(hash: string) {
+		if (!this.#browserFrame) {
+			return;
+		}
+
 		const oldURL = this.#url.href;
 		this.#url.hash = hash;
 		const newURL = this.#url.href;
@@ -68,9 +75,7 @@ export default class Location {
 	public set host(host: string) {
 		const url = new URL(this.#url.href);
 		url.host = host;
-		this.#browserFrame
-			.goto(url.href)
-			.catch((error) => this.#browserFrame.page.console.error(error));
+		this.href = url.href;
 	}
 
 	/**
@@ -90,9 +95,7 @@ export default class Location {
 	public set hostname(hostname: string) {
 		const url = new URL(this.#url.href);
 		url.hostname = hostname;
-		this.#browserFrame
-			.goto(url.href)
-			.catch((error) => this.#browserFrame.page.console.error(error));
+		this.href = url.href;
 	}
 
 	/**
@@ -106,7 +109,17 @@ export default class Location {
 	 * Override set href.
 	 */
 	public set href(url: string) {
-		this.#browserFrame.goto(url).catch((error) => this.#browserFrame.page.console.error(error));
+		if (!this.#browserFrame) {
+			return;
+		}
+
+		this.#browserFrame.goto(url).catch((error) => {
+			if (this.#browserFrame.page?.console) {
+				this.#browserFrame.page.console.error(error);
+			} else {
+				throw error;
+			}
+		});
 	}
 
 	/**
@@ -135,9 +148,7 @@ export default class Location {
 	public set pathname(pathname: string) {
 		const url = new URL(this.#url.href);
 		url.pathname = pathname;
-		this.#browserFrame
-			.goto(url.href)
-			.catch((error) => this.#browserFrame.page.console.error(error));
+		this.href = url.href;
 	}
 
 	/**
@@ -157,9 +168,7 @@ export default class Location {
 	public set port(port: string) {
 		const url = new URL(this.#url.href);
 		url.port = port;
-		this.#browserFrame
-			.goto(url.href)
-			.catch((error) => this.#browserFrame.page.console.error(error));
+		this.href = url.href;
 	}
 
 	/**
@@ -179,9 +188,7 @@ export default class Location {
 	public set protocol(protocol: string) {
 		const url = new URL(this.#url.href);
 		url.protocol = protocol;
-		this.#browserFrame
-			.goto(url.href)
-			.catch((error) => this.#browserFrame.page.console.error(error));
+		this.href = url.href;
 	}
 
 	/**
@@ -201,9 +208,7 @@ export default class Location {
 	public set search(search: string) {
 		const url = new URL(this.#url.href);
 		url.search = search;
-		this.#browserFrame
-			.goto(url.href)
-			.catch((error) => this.#browserFrame.page.console.error(error));
+		this.href = url.href;
 	}
 
 	/**
@@ -228,9 +233,17 @@ export default class Location {
 	 * Reloads the resource from the current URL.
 	 */
 	public reload(): void {
-		this.#browserFrame
-			.goto(this.href)
-			.catch((error) => this.#browserFrame.page.console.error(error));
+		if (!this.#browserFrame) {
+			return;
+		}
+
+		this.#browserFrame.goto(this.href).catch((error) => {
+			if (this.#browserFrame.page?.console) {
+				this.#browserFrame.page.console.error(error);
+			} else {
+				throw error;
+			}
+		});
 	}
 
 	/**
@@ -240,6 +253,10 @@ export default class Location {
 	 * @param url URL.
 	 */
 	public [PropertySymbol.setURL](browserFrame: IBrowserFrame, url: string): void {
+		if (!this.#browserFrame) {
+			return;
+		}
+
 		if (this.#browserFrame !== browserFrame) {
 			throw new Error('Failed to set URL. Browser frame mismatch.');
 		}
@@ -247,6 +264,13 @@ export default class Location {
 		this.#url.href = url;
 	}
 
+	/**
+	 * Destroys the location.
+	 */
+	public [PropertySymbol.destroy](): void {
+		this.#browserFrame = null;
+	}
+
 	/**
 	 * Returns the URL as a string.
 	 *

package/src/match-media/MediaQueryItem.ts

@@ -1,6 +1,6 @@
 import CSSMeasurementConverter from '../css/declaration/measurement-converter/CSSMeasurementConverter.js';
 import BrowserWindow from '../window/BrowserWindow.js';
-import WindowBrowserSettingsReader from '../window/WindowBrowserSettingsReader.js';
+import WindowBrowserContext from '../window/WindowBrowserContext.js';
 import IMediaQueryRange from './IMediaQueryRange.js';
 import IMediaQueryRule from './IMediaQueryRule.js';
 import MediaQueryTypeEnum from './MediaQueryTypeEnum.js';
@@ -14,13 +14,13 @@ export default class MediaQueryItem {
 	public rules: IMediaQueryRule[];
 	public ranges: IMediaQueryRange[];
 	private rootFontSize: string | number | null = null;
-	private ownerWindow: BrowserWindow;
+	private window: BrowserWindow;
 
 	/**
 	 * Constructor.
 	 *
 	 * @param options Options.
-	 * @param options.ownerWindow Owner window.
+	 * @param options.window Owner window.
 	 * @param [options.rootFontSize] Root font size.
 	 * @param [options.mediaTypes] Media types.
 	 * @param [options.not] Not.
@@ -28,14 +28,14 @@ export default class MediaQueryItem {
 	 * @param [options.ranges] Ranges.
 	 */
 	constructor(options: {
-		ownerWindow: BrowserWindow;
+		window: BrowserWindow;
 		rootFontSize?: string | number | null;
 		mediaTypes?: MediaQueryTypeEnum[];
 		not?: boolean;
 		rules?: IMediaQueryRule[];
 		ranges?: IMediaQueryRange[];
 	}) {
-		this.ownerWindow = options.ownerWindow;
+		this.window = options.window;
 		this.rootFontSize = options.rootFontSize || null;
 		this.mediaTypes = options.mediaTypes || [];
 		this.not = options.not || false;
@@ -115,7 +115,7 @@ export default class MediaQueryItem {
 		if (mediaType === MediaQueryTypeEnum.all) {
 			return true;
 		}
-		return mediaType === WindowBrowserSettingsReader.getSettings(this.ownerWindow).device.mediaType;
+		return mediaType === new WindowBrowserContext(this.window).getSettings()?.device.mediaType;
 	}
 
 	/**
@@ -125,8 +125,7 @@ export default class MediaQueryItem {
 	 * @returns "true" if the range matches.
 	 */
 	private matchesRange(range: IMediaQueryRange): boolean {
-		const windowSize =
-			range.type === 'width' ? this.ownerWindow.innerWidth : this.ownerWindow.innerHeight;
+		const windowSize = range.type === 'width' ? this.window.innerWidth : this.window.innerHeight;
 
 		if (range.before) {
 			const beforeValue = this.toPixels(range.before.value);
@@ -226,38 +225,38 @@ export default class MediaQueryItem {
 		switch (rule.name) {
 			case 'min-width':
 				const minWidth = this.toPixels(rule.value);
-				return minWidth !== null && this.ownerWindow.innerWidth >= minWidth;
+				return minWidth !== null && this.window.innerWidth >= minWidth;
 			case 'max-width':
 				const maxWidth = this.toPixels(rule.value);
-				return maxWidth !== null && this.ownerWindow.innerWidth <= maxWidth;
+				return maxWidth !== null && this.window.innerWidth <= maxWidth;
 			case 'min-height':
 				const minHeight = this.toPixels(rule.value);
-				return minHeight !== null && this.ownerWindow.innerHeight >= minHeight;
+				return minHeight !== null && this.window.innerHeight >= minHeight;
 			case 'max-height':
 				const maxHeight = this.toPixels(rule.value);
-				return maxHeight !== null && this.ownerWindow.innerHeight <= maxHeight;
+				return maxHeight !== null && this.window.innerHeight <= maxHeight;
 			case 'width':
 				const width = this.toPixels(rule.value);
-				return width !== null && this.ownerWindow.innerWidth === width;
+				return width !== null && this.window.innerWidth === width;
 			case 'height':
 				const height = this.toPixels(rule.value);
-				return height !== null && this.ownerWindow.innerHeight === height;
+				return height !== null && this.window.innerHeight === height;
 			case 'orientation':
 				return rule.value === 'landscape'
-					? this.ownerWindow.innerWidth > this.ownerWindow.innerHeight
-					: this.ownerWindow.innerWidth < this.ownerWindow.innerHeight;
+					? this.window.innerWidth > this.window.innerHeight
+					: this.window.innerWidth < this.window.innerHeight;
 			case 'prefers-color-scheme':
 				return (
 					rule.value ===
-					WindowBrowserSettingsReader.getSettings(this.ownerWindow).device.prefersColorScheme
+					new WindowBrowserContext(this.window).getSettings().device.prefersColorScheme
 				);
 			case 'any-hover':
 			case 'hover':
 				if (rule.value === 'none') {
-					return this.ownerWindow.navigator.maxTouchPoints > 0;
+					return this.window.navigator.maxTouchPoints > 0;
 				}
 				if (rule.value === 'hover') {
-					return this.ownerWindow.navigator.maxTouchPoints === 0;
+					return this.window.navigator.maxTouchPoints === 0;
 				}
 				return false;
 			case 'any-pointer':
@@ -267,11 +266,11 @@ export default class MediaQueryItem {
 				}
 
 				if (rule.value === 'coarse') {
-					return this.ownerWindow.navigator.maxTouchPoints > 0;
+					return this.window.navigator.maxTouchPoints > 0;
 				}
 
 				if (rule.value === 'fine') {
-					return this.ownerWindow.navigator.maxTouchPoints === 0;
+					return this.window.navigator.maxTouchPoints === 0;
 				}
 
 				return false;
@@ -292,17 +291,17 @@ export default class MediaQueryItem {
 					case 'min-aspect-ratio':
 						return (
 							aspectRatioWidth / aspectRatioHeight <=
-							this.ownerWindow.innerWidth / this.ownerWindow.innerHeight
+							this.window.innerWidth / this.window.innerHeight
 						);
 					case 'max-aspect-ratio':
 						return (
 							aspectRatioWidth / aspectRatioHeight >=
-							this.ownerWindow.innerWidth / this.ownerWindow.innerHeight
+							this.window.innerWidth / this.window.innerHeight
 						);
 					case 'aspect-ratio':
 						return (
 							aspectRatioWidth / aspectRatioHeight ===
-							this.ownerWindow.innerWidth / this.ownerWindow.innerHeight
+							this.window.innerWidth / this.window.innerHeight
 						);
 				}
 		}
@@ -318,23 +317,21 @@ export default class MediaQueryItem {
 	 */
 	private toPixels(value: string): number | null {
 		if (
-			!WindowBrowserSettingsReader.getSettings(this.ownerWindow).disableComputedStyleRendering &&
+			!new WindowBrowserContext(this.window).getSettings()?.disableComputedStyleRendering &&
 			value.endsWith('em')
 		) {
 			this.rootFontSize =
 				this.rootFontSize ||
-				parseFloat(
-					this.ownerWindow.getComputedStyle(this.ownerWindow.document.documentElement).fontSize
-				);
+				parseFloat(this.window.getComputedStyle(this.window.document.documentElement).fontSize);
 			return CSSMeasurementConverter.toPixels({
-				ownerWindow: this.ownerWindow,
+				window: this.window,
 				value,
 				rootFontSize: this.rootFontSize,
 				parentFontSize: this.rootFontSize
 			});
 		}
 		return CSSMeasurementConverter.toPixels({
-			ownerWindow: this.ownerWindow,
+			window: this.window,
 			value,
 			rootFontSize: 16,
 			parentFontSize: 16

package/src/match-media/MediaQueryList.ts

@@ -2,7 +2,7 @@ import EventTarget from '../event/EventTarget.js';
 import * as PropertySymbol from '../PropertySymbol.js';
 import Event from '../event/Event.js';
 import BrowserWindow from '../window/BrowserWindow.js';
-import IEventListener from '../event/IEventListener.js';
+import TEventListener from '../event/TEventListener.js';
 import MediaQueryListEvent from '../event/events/MediaQueryListEvent.js';
 import IMediaQueryItem from './MediaQueryItem.js';
 import MediaQueryParser from './MediaQueryParser.js';
@@ -15,7 +15,7 @@ import MediaQueryParser from './MediaQueryParser.js';
  */
 export default class MediaQueryList extends EventTarget {
 	public onchange: (event: Event) => void = null;
-	#ownerWindow: BrowserWindow;
+	#window: BrowserWindow;
 	#items: IMediaQueryItem[] | null = null;
 	#media: string;
 	#rootFontSize: string | number | null = null;
@@ -24,17 +24,13 @@ export default class MediaQueryList extends EventTarget {
 	 * Constructor.
 	 *
 	 * @param options Options.
-	 * @param options.ownerWindow Owner window.
+	 * @param options.window Owner window.
 	 * @param options.media Media.
 	 * @param [options.rootFontSize] Root font size.
 	 */
-	constructor(options: {
-		ownerWindow: BrowserWindow;
-		media: string;
-		rootFontSize?: string | number;
-	}) {
+	constructor(options: { window: BrowserWindow; media: string; rootFontSize?: string | number }) {
 		super();
-		this.#ownerWindow = options.ownerWindow;
+		this.#window = options.window;
 		this.#media = options.media;
 		this.#rootFontSize = options.rootFontSize || null;
 	}
@@ -48,7 +44,7 @@ export default class MediaQueryList extends EventTarget {
 		this.#items =
 			this.#items ||
 			MediaQueryParser.parse({
-				ownerWindow: this.#ownerWindow,
+				window: this.#window,
 				mediaQuery: this.#media,
 				rootFontSize: this.#rootFontSize
 			});
@@ -65,7 +61,7 @@ export default class MediaQueryList extends EventTarget {
 		this.#items =
 			this.#items ||
 			MediaQueryParser.parse({
-				ownerWindow: this.#ownerWindow,
+				window: this.#window,
 				mediaQuery: this.#media,
 				rootFontSize: this.#rootFontSize
 			});
@@ -102,7 +98,7 @@ export default class MediaQueryList extends EventTarget {
 	/**
 	 * @override
 	 */
-	public addEventListener(type: string, listener: IEventListener | ((event: Event) => void)): void {
+	public addEventListener(type: string, listener: TEventListener): void {
 		super.addEventListener(type, listener);
 		if (type === 'change') {
 			let matchesState = false;
@@ -114,23 +110,17 @@ export default class MediaQueryList extends EventTarget {
 				}
 			};
 			listener[PropertySymbol.windowResizeListener] = resizeListener;
-			this.#ownerWindow.addEventListener('resize', resizeListener);
+			this.#window.addEventListener('resize', resizeListener);
 		}
 	}
 
 	/**
 	 * @override
 	 */
-	public removeEventListener(
-		type: string,
-		listener: IEventListener | ((event: Event) => void)
-	): void {
+	public removeEventListener(type: string, listener: TEventListener): void {
 		super.removeEventListener(type, listener);
 		if (type === 'change' && listener[PropertySymbol.windowResizeListener]) {
-			this.#ownerWindow.removeEventListener(
-				'resize',
-				listener[PropertySymbol.windowResizeListener]
-			);
+			this.#window.removeEventListener('resize', listener[PropertySymbol.windowResizeListener]);
 		}
 	}
 }

package/src/match-media/MediaQueryParser.ts

@@ -38,18 +38,18 @@ export default class MediaQueryParser {
 	 * Parses a media query string.
 	 *
 	 * @param options Options.
-	 * @param options.ownerWindow Owner window.
+	 * @param options.window Owner window.
 	 * @param options.mediaQuery Media query string.
 	 * @param [options.rootFontSize] Root font size.
 	 * @returns Media query items.
 	 */
 	public static parse(options: {
-		ownerWindow: BrowserWindow;
+		window: BrowserWindow;
 		mediaQuery: string;
 		rootFontSize?: string | number | null;
 	}): MediaQueryItem[] {
 		let currentMediaQueryItem: MediaQueryItem = new MediaQueryItem({
-			ownerWindow: options.ownerWindow,
+			window: options.window,
 			rootFontSize: options.rootFontSize
 		});
 		const mediaQueryItems: MediaQueryItem[] = [currentMediaQueryItem];
@@ -59,7 +59,7 @@ export default class MediaQueryParser {
 		while ((match = regexp.exec(options.mediaQuery.toLowerCase()))) {
 			if (match[4] === ',' || match[5] === 'or') {
 				currentMediaQueryItem = new MediaQueryItem({
-					ownerWindow: options.ownerWindow,
+					window: options.window,
 					rootFontSize: options.rootFontSize
 				});
 				mediaQueryItems.push(currentMediaQueryItem);
@@ -93,7 +93,7 @@ export default class MediaQueryParser {
 					if (!trimmedValue && !match[3]) {
 						return [
 							new MediaQueryItem({
-								ownerWindow: options.ownerWindow,
+								window: options.window,
 								rootFontSize: options.rootFontSize,
 								not: true,
 								mediaTypes: [MediaQueryTypeEnum.all]