happy-dom 8.5.0 → 8.7.0

package/src/nodes/html-iframe-element/IFrameCrossOriginWindow.ts

@@ -0,0 +1,60 @@
+import EventTarget from '../../event/EventTarget';
+import IWindow from '../../window/IWindow';
+import DOMException from '../../exception/DOMException';
+import DOMExceptionNameEnum from '../../exception/DOMExceptionNameEnum';
+import Location from '../../location/Location';
+
+/**
+ * Browser window with limited access due to CORS restrictions in iframes.
+ */
+export default class IFrameCrossOriginWindow extends EventTarget {
+	public readonly self = this;
+	public readonly window = this;
+	public readonly parent: IWindow;
+	public readonly top: IWindow;
+	public readonly location: Location;
+
+	private _targetWindow: IWindow;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param parent Parent window.
+	 * @param target Target window.
+	 */
+	constructor(parent: IWindow, target: IWindow) {
+		super();
+
+		this.parent = parent;
+		this.top = parent;
+		this.location = <Location>new Proxy(
+			{},
+			{
+				get: () => {
+					throw new DOMException(
+						`Blocked a frame with origin "${this.parent.location.origin}" from accessing a cross-origin frame.`,
+						DOMExceptionNameEnum.securityError
+					);
+				},
+				set: () => {
+					throw new DOMException(
+						`Blocked a frame with origin "${this.parent.location.origin}" from accessing a cross-origin frame.`,
+						DOMExceptionNameEnum.securityError
+					);
+				}
+			}
+		);
+		this._targetWindow = target;
+	}
+
+	/**
+	 * Safely enables cross-origin communication between Window objects; e.g., between a page and a pop-up that it spawned, or between a page and an iframe embedded within it.
+	 *
+	 * @param message Message.
+	 * @param [targetOrigin=*] Target origin.
+	 * @param transfer Transfer. Not implemented.
+	 */
+	public postMessage(message: unknown, targetOrigin = '*', transfer?: unknown[]): void {
+		this._targetWindow.postMessage(message, targetOrigin, transfer);
+	}
+}

package/src/nodes/html-iframe-element/IHTMLIFrameElement.ts

@@ -0,0 +1,27 @@
+import Event from '../../event/Event';
+import IWindow from '../../window/IWindow';
+import IDocument from '../document/IDocument';
+import IHTMLElement from '../html-element/IHTMLElement';
+import IFrameCrossOriginWindow from './IFrameCrossOriginWindow';
+
+/**
+ * HTML Iframe Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLIFrameElement.
+ */
+export default interface IHTMLIFrameElement extends IHTMLElement {
+	src: string | null;
+	allow: string | null;
+	height: string | null;
+	width: string | null;
+	name: string | null;
+	sandbox: string | null;
+	srcdoc: string | null;
+	readonly contentDocument: IDocument | null;
+	readonly contentWindow: IWindow | IFrameCrossOriginWindow | null;
+
+	// Events
+	onload: (event: Event) => void | null;
+	onerror: (event: Event) => void | null;
+}

package/src/nodes/html-link-element/HTMLLinkElement.ts

@@ -250,13 +250,14 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 	/**
 	 * @override
 	 */
-	public _connectToNode(parentNode: INode = null): void {
+	public override _connectToNode(parentNode: INode = null): void {
 		const isConnected = this.isConnected;
 		const isParentConnected = parentNode ? parentNode.isConnected : false;
 
 		super._connectToNode(parentNode);
 
 		if (
+			isParentConnected &&
 			isConnected !== isParentConnected &&
 			this._evaluateCSS &&
 			!this.ownerDocument.defaultView.happyDOM.settings.disableCSSFileLoading

package/src/nodes/html-script-element/HTMLScriptElement.ts

@@ -182,13 +182,13 @@ export default class HTMLScriptElement extends HTMLElement implements IHTMLScrip
 	/**
 	 * @override
 	 */
-	public _connectToNode(parentNode: INode = null): void {
+	public override _connectToNode(parentNode: INode = null): void {
 		const isConnected = this.isConnected;
 		const isParentConnected = parentNode ? parentNode.isConnected : false;
 
 		super._connectToNode(parentNode);
 
-		if (isConnected !== isParentConnected && this._evaluateScript) {
+		if (isParentConnected && isConnected !== isParentConnected && this._evaluateScript) {
 			const src = this.getAttributeNS(null, 'src');
 
 			if (src !== null) {

package/src/window/IHappyDOMOptions.ts

@@ -0,0 +1,15 @@
+/**
+ * Happy DOM options.
+ */
+export default interface IHappyDOMOptions {
+	innerWidth?: number;
+	innerHeight?: number;
+	url?: string;
+	settings?: {
+		disableJavaScriptEvaluation?: boolean;
+		disableJavaScriptFileLoading?: boolean;
+		disableCSSFileLoading?: boolean;
+		disableIframePageLoading?: boolean;
+		enableFileSystemHttpRequests?: boolean;
+	};
+}

package/src/window/IHappyDOMSettings.ts

@@ -5,5 +5,6 @@ export default interface IHappyDOMSettings {
 	disableJavaScriptEvaluation: boolean;
 	disableJavaScriptFileLoading: boolean;
 	disableCSSFileLoading: boolean;
+	disableIframePageLoading: boolean;
 	enableFileSystemHttpRequests: boolean;
 }

package/src/window/IWindow.ts

@@ -24,6 +24,7 @@ import HTMLMediaElement from '../nodes/html-media-element/HTMLMediaElement';
 import HTMLAudioElement from '../nodes/html-audio-element/HTMLAudioElement';
 import HTMLVideoElement from '../nodes/html-video-element/HTMLVideoElement';
 import HTMLBaseElement from '../nodes/html-base-element/HTMLBaseElement';
+import HTMLIFrameElement from '../nodes/html-iframe-element/HTMLIFrameElement';
 import SVGSVGElement from '../nodes/svg-element/SVGSVGElement';
 import SVGElement from '../nodes/svg-element/SVGElement';
 import HTMLScriptElement from '../nodes/html-script-element/HTMLScriptElement';
@@ -73,6 +74,8 @@ import InputEvent from '../event/events/InputEvent';
 import UIEvent from '../event/UIEvent';
 import ErrorEvent from '../event/events/ErrorEvent';
 import StorageEvent from '../event/events/StorageEvent';
+import MessageEvent from '../event/events/MessageEvent';
+import MessagePort from '../event/MessagePort';
 import Screen from '../screen/Screen';
 import AsyncTaskManager from '../async-task-manager/AsyncTaskManager';
 import Storage from '../storage/Storage';
@@ -142,6 +145,7 @@ export default interface IWindow extends IEventTarget, NodeJS.Global {
 	readonly HTMLAudioElement: typeof HTMLAudioElement;
 	readonly HTMLVideoElement: typeof HTMLVideoElement;
 	readonly HTMLBaseElement: typeof HTMLBaseElement;
+	readonly HTMLIFrameElement: typeof HTMLIFrameElement;
 	readonly HTMLDialogElement: typeof HTMLDialogElement;
 	readonly Attr: typeof Attr;
 	readonly NamedNodeMap: typeof NamedNodeMap;
@@ -175,6 +179,8 @@ export default interface IWindow extends IEventTarget, NodeJS.Global {
 	readonly InputEvent: typeof InputEvent;
 	readonly ErrorEvent: typeof ErrorEvent;
 	readonly StorageEvent: typeof StorageEvent;
+	readonly MessageEvent: typeof MessageEvent;
+	readonly MessagePort: typeof MessagePort;
 	readonly ProgressEvent: typeof ProgressEvent;
 	readonly MediaQueryListEvent: typeof MediaQueryListEvent;
 	readonly EventTarget: typeof EventTarget;
@@ -374,4 +380,12 @@ export default interface IWindow extends IEventTarget, NodeJS.Global {
 	 * @returns An ASCII string containing decoded data from encodedData.
 	 */
 	atob(data: unknown): string;
+
+	/**
+	 * Safely enables cross-origin communication between Window objects; e.g., between a page and a pop-up that it spawned, or between a page and an iframe embedded within it.
+	 *
+	 * @param message Message.
+	 * @param listener Listener.
+	 */
+	postMessage(message: unknown, targetOrigin?: string, transfer?: unknown[]): void;
 }

package/src/window/Window.ts

@@ -25,6 +25,7 @@ import HTMLMediaElement from '../nodes/html-media-element/HTMLMediaElement';
 import HTMLAudioElement from '../nodes/html-audio-element/HTMLAudioElement';
 import HTMLVideoElement from '../nodes/html-video-element/HTMLVideoElement';
 import HTMLBaseElement from '../nodes/html-base-element/HTMLBaseElement';
+import HTMLIFrameElement from '../nodes/html-iframe-element/HTMLIFrameElement';
 import HTMLDialogElement from '../nodes/html-dialog-element/HTMLDialogElement';
 import SVGSVGElement from '../nodes/svg-element/SVGSVGElement';
 import SVGElement from '../nodes/svg-element/SVGElement';
@@ -39,9 +40,11 @@ import Event from '../event/Event';
 import CustomEvent from '../event/events/CustomEvent';
 import AnimationEvent from '../event/events/AnimationEvent';
 import KeyboardEvent from '../event/events/KeyboardEvent';
+import MessageEvent from '../event/events/MessageEvent';
 import ProgressEvent from '../event/events/ProgressEvent';
 import MediaQueryListEvent from '../event/events/MediaQueryListEvent';
 import EventTarget from '../event/EventTarget';
+import MessagePort from '../event/MessagePort';
 import { URL, URLSearchParams } from 'url';
 import Location from '../location/Location';
 import NonImplementedEventTypes from '../event/NonImplementedEventTypes';
@@ -115,9 +118,10 @@ import Attr from '../nodes/attr/Attr';
 import NamedNodeMap from '../named-node-map/NamedNodeMap';
 import IElement from '../nodes/element/IElement';
 import ProcessingInstruction from '../nodes/processing-instruction/ProcessingInstruction';
-import IHappyDOMSettings from './IHappyDOMSettings';
 import RequestInfo from '../fetch/RequestInfo';
 import FileList from '../nodes/html-input-element/FileList';
+import DOMExceptionNameEnum from '../exception/DOMExceptionNameEnum';
+import IHappyDOMOptions from './IHappyDOMOptions';
 
 const ORIGINAL_SET_TIMEOUT = setTimeout;
 const ORIGINAL_CLEAR_TIMEOUT = clearTimeout;
@@ -159,6 +163,7 @@ export default class Window extends EventTarget implements IWindow {
 			disableJavaScriptEvaluation: false,
 			disableJavaScriptFileLoading: false,
 			disableCSSFileLoading: false,
+			disableIframePageLoading: false,
 			enableFileSystemHttpRequests: false
 		}
 	};
@@ -183,6 +188,7 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly HTMLAudioElement = HTMLAudioElement;
 	public readonly HTMLVideoElement = HTMLVideoElement;
 	public readonly HTMLBaseElement = HTMLBaseElement;
+	public readonly HTMLIFrameElement = HTMLIFrameElement;
 	public readonly HTMLDialogElement = HTMLDialogElement;
 	public readonly Attr = Attr;
 	public readonly NamedNodeMap = NamedNodeMap;
@@ -208,6 +214,7 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly CustomEvent = CustomEvent;
 	public readonly AnimationEvent = AnimationEvent;
 	public readonly KeyboardEvent = KeyboardEvent;
+	public readonly MessageEvent = MessageEvent;
 	public readonly MouseEvent = MouseEvent;
 	public readonly PointerEvent = PointerEvent;
 	public readonly FocusEvent = FocusEvent;
@@ -218,6 +225,7 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly ProgressEvent = ProgressEvent;
 	public readonly MediaQueryListEvent = MediaQueryListEvent;
 	public readonly EventTarget = EventTarget;
+	public readonly MessagePort = MessagePort;
 	public readonly DataTransfer = DataTransfer;
 	public readonly DataTransferItem = DataTransferItem;
 	public readonly DataTransferItemList = DataTransferItemList;
@@ -370,12 +378,7 @@ export default class Window extends EventTarget implements IWindow {
 	 * @param [options.url] URL.
 	 * @param [options.settings] Settings.
 	 */
-	constructor(options?: {
-		innerWidth?: number;
-		innerHeight?: number;
-		url?: string;
-		settings?: IHappyDOMSettings;
-	}) {
+	constructor(options?: IHappyDOMOptions) {
 		super();
 
 		this.customElements = new CustomElementRegistry();
@@ -732,6 +735,42 @@ export default class Window extends EventTarget implements IWindow {
 		return Base64.atob(data);
 	}
 
+	/**
+	 * Safely enables cross-origin communication between Window objects; e.g., between a page and a pop-up that it spawned, or between a page and an iframe embedded within it.
+	 *
+	 * @param message Message.
+	 * @param [targetOrigin=*] Target origin.
+	 * @param _transfer Transfer. Not implemented.
+	 */
+	public postMessage(message: unknown, targetOrigin = '*', _transfer?: unknown[]): void {
+		// TODO: Implement transfer.
+
+		if (targetOrigin && targetOrigin !== '*' && this.location.origin !== targetOrigin) {
+			throw new DOMException(
+				`Failed to execute 'postMessage' on 'Window': The target origin provided ('${targetOrigin}') does not match the recipient window\'s origin ('${this.location.origin}').`,
+				DOMExceptionNameEnum.securityError
+			);
+		}
+
+		try {
+			JSON.stringify(message);
+		} catch (error) {
+			throw new DOMException(
+				`Failed to execute 'postMessage' on 'Window': The provided message cannot be serialized.`,
+				DOMExceptionNameEnum.invalidStateError
+			);
+		}
+
+		this.dispatchEvent(
+			new MessageEvent('message', {
+				data: message,
+				origin: this.parent.location.origin,
+				source: this.parent,
+				lastEventId: ''
+			})
+		);
+	}
+
 	/**
 	 * Setup of VM context.
 	 */