happy-dom 5.3.3 → 6.0.0

package/src/selection/SelectionDirectionEnum.ts

@@ -0,0 +1,7 @@
+enum SelectionDirectionEnum {
+	forwards = 1,
+	backwards = -1,
+	directionless = 0
+}
+
+export default SelectionDirectionEnum;

package/src/window/IWindow.ts

@@ -24,6 +24,7 @@ import HTMLBaseElement from '../nodes/html-base-element/HTMLBaseElement';
 import SVGSVGElement from '../nodes/svg-element/SVGSVGElement';
 import SVGElement from '../nodes/svg-element/SVGElement';
 import HTMLScriptElement from '../nodes/html-script-element/HTMLScriptElement';
+import HTMLDialogElement from '../nodes/html-dialog-element/HTMLDialogElement';
 import HTMLImageElement from '../nodes/html-image-element/HTMLImageElement';
 import Image from '../nodes/html-image-element/Image';
 import DocumentFragment from '../nodes/document-fragment/DocumentFragment';
@@ -79,6 +80,7 @@ import IRequest from '../fetch/IRequest';
 import IHeaders from '../fetch/IHeaders';
 import IRequestInit from '../fetch/IRequestInit';
 import IResponse from '../fetch/IResponse';
+import Range from '../range/Range';
 import MediaQueryList from '../match-media/MediaQueryList';
 import DOMRect from '../nodes/element/DOMRect';
 import Window from './Window';
@@ -112,6 +114,7 @@ export default interface IWindow extends IEventTarget, NodeJS.Global {
 	readonly HTMLLabelElement: typeof HTMLLabelElement;
 	readonly HTMLMetaElement: typeof HTMLMetaElement;
 	readonly HTMLBaseElement: typeof HTMLBaseElement;
+	readonly HTMLDialogElement: typeof HTMLDialogElement;
 	readonly SVGSVGElement: typeof SVGSVGElement;
 	readonly SVGElement: typeof SVGElement;
 	readonly Image: typeof Image;
@@ -174,6 +177,7 @@ export default interface IWindow extends IEventTarget, NodeJS.Global {
 	readonly Headers: { new (init?: string[][] | Record<string, string> | IHeaders): IHeaders };
 	readonly Request: { new (input: string | IRequest, init?: IRequestInit): IRequest };
 	readonly Response: { new (body?: unknown | null, init?: IResponseInit): IResponse };
+	readonly Range: typeof Range;
 	readonly DOMRect: typeof DOMRect;
 
 	// Events
@@ -301,4 +305,24 @@ export default interface IWindow extends IEventTarget, NodeJS.Global {
 	 * @returns Promise.
 	 */
 	fetch(url: string, init?: IRequestInit): Promise<IResponse>;
+
+	/**
+	 * Creates a Base64-encoded ASCII string from a binary string (i.e., a string in which each character in the string is treated as a byte of binary data).
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/btoa
+	 * @param data Binay data.
+	 * @returns Base64-encoded string.
+	 */
+	btoa(data: unknown): string;
+
+	/**
+	 * Decodes a string of data which has been encoded using Base64 encoding.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/atob
+	 * @see https://infra.spec.whatwg.org/#forgiving-base64-encode.
+	 * @see Https://html.spec.whatwg.org/multipage/webappapis.html#btoa.
+	 * @param data Binay string.
+	 * @returns An ASCII string containing decoded data from encodedData.
+	 */
+	atob(data: unknown): string;
 }

package/src/window/Window.ts

@@ -21,11 +21,12 @@ import HTMLSlotElement from '../nodes/html-slot-element/HTMLSlotElement';
 import HTMLLabelElement from '../nodes/html-label-element/HTMLLabelElement';
 import HTMLMetaElement from '../nodes/html-meta-element/HTMLMetaElement';
 import HTMLBaseElement from '../nodes/html-base-element/HTMLBaseElement';
+import HTMLDialogElement from '../nodes/html-dialog-element/HTMLDialogElement';
 import SVGSVGElement from '../nodes/svg-element/SVGSVGElement';
 import SVGElement from '../nodes/svg-element/SVGElement';
 import HTMLScriptElement from '../nodes/html-script-element/HTMLScriptElement';
 import HTMLImageElement from '../nodes/html-image-element/HTMLImageElement';
-import Image from '../nodes/html-image-element/Image';
+import { default as ImageImplementation } from '../nodes/html-image-element/Image';
 import DocumentFragment from '../nodes/document-fragment/DocumentFragment';
 import CharacterData from '../nodes/character-data/CharacterData';
 import TreeWalker from '../tree-walker/TreeWalker';
@@ -40,13 +41,13 @@ import Location from '../location/Location';
 import NonImplementedEventTypes from '../event/NonImplementedEventTypes';
 import MutationObserver from '../mutation-observer/MutationObserver';
 import NonImplemenetedElementClasses from '../config/NonImplemenetedElementClasses';
-import DOMParser from '../dom-parser/DOMParser';
+import { default as DOMParserImplementation } from '../dom-parser/DOMParser';
 import XMLSerializer from '../xml-serializer/XMLSerializer';
 import ResizeObserver from '../resize-observer/ResizeObserver';
 import Blob from '../file/Blob';
 import File from '../file/File';
 import DOMException from '../exception/DOMException';
-import FileReader from '../file/FileReader';
+import { default as FileReaderImplementation } from '../file/FileReader';
 import History from '../history/History';
 import CSSStyleSheet from '../css/CSSStyleSheet';
 import CSSStyleDeclaration from '../css/CSSStyleDeclaration';
@@ -72,8 +73,8 @@ import IRequestInit from '../fetch/IRequestInit';
 import IHeaders from '../fetch/IHeaders';
 import IHeadersInit from '../fetch/IHeadersInit';
 import Headers from '../fetch/Headers';
-import Request from '../fetch/Request';
-import Response from '../fetch/Response';
+import { default as RequestImplementation } from '../fetch/Request';
+import { default as ResponseImplementation } from '../fetch/Response';
 import Storage from '../storage/Storage';
 import IWindow from './IWindow';
 import HTMLCollection from '../nodes/element/HTMLCollection';
@@ -87,12 +88,19 @@ import Plugin from '../navigator/Plugin';
 import PluginArray from '../navigator/PluginArray';
 import { URLSearchParams } from 'url';
 import FetchHandler from '../fetch/FetchHandler';
+import { default as RangeImplementation } from '../range/Range';
 import DOMRect from '../nodes/element/DOMRect';
 import VMGlobalPropertyScript from './VMGlobalPropertyScript';
 import * as PerfHooks from 'perf_hooks';
 import VM from 'vm';
 import { Buffer } from 'buffer';
-import { atob, btoa } from './WindowBase64';
+import Base64 from '../base64/Base64';
+import IDocument from '../nodes/document/IDocument';
+
+const ORIGINAL_SET_TIMEOUT = setTimeout;
+const ORIGINAL_CLEAR_TIMEOUT = clearTimeout;
+const ORIGINAL_SET_INTERVAL = setInterval;
+const ORIGINAL_CLEAR_INTERVAL = clearInterval;
 
 /**
  * Browser window.
@@ -101,7 +109,7 @@ import { atob, btoa } from './WindowBase64';
  * https://developer.mozilla.org/en-US/docs/Web/API/Window.
  */
 export default class Window extends EventTarget implements IWindow {
-	// Public Properties
+	// The Happy DOM property
 	public readonly happyDOM = {
 		whenAsyncComplete: async (): Promise<void> => {
 			return await this.happyDOM.asyncTaskManager.whenComplete();
@@ -121,7 +129,6 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly HTMLInputElement = HTMLInputElement;
 	public readonly HTMLTextAreaElement = HTMLTextAreaElement;
 	public readonly HTMLImageElement = HTMLImageElement;
-	public readonly Image = Image;
 	public readonly HTMLScriptElement = HTMLScriptElement;
 	public readonly HTMLLinkElement = HTMLLinkElement;
 	public readonly HTMLStyleElement = HTMLStyleElement;
@@ -129,6 +136,7 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly HTMLSlotElement = HTMLSlotElement;
 	public readonly HTMLMetaElement = HTMLMetaElement;
 	public readonly HTMLBaseElement = HTMLBaseElement;
+	public readonly HTMLDialogElement = HTMLDialogElement;
 	public readonly SVGSVGElement = SVGSVGElement;
 	public readonly SVGElement = SVGElement;
 	public readonly Text = Text;
@@ -139,7 +147,6 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly CharacterData = CharacterData;
 	public readonly NodeFilter = NodeFilter;
 	public readonly TreeWalker = TreeWalker;
-	public readonly DOMParser = DOMParser;
 	public readonly MutationObserver = MutationObserver;
 	public readonly Document = Document;
 	public readonly HTMLDocument = HTMLDocument;
@@ -171,7 +178,6 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly CSSStyleSheet = CSSStyleSheet;
 	public readonly Blob = Blob;
 	public readonly File = File;
-	public readonly FileReader = FileReader;
 	public readonly DOMException = DOMException;
 	public readonly History = History;
 	public readonly Screen = Screen;
@@ -188,13 +194,17 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly Plugin = Plugin;
 	public readonly PluginArray = PluginArray;
 	public readonly Headers: { new (init?: IHeadersInit): IHeaders } = Headers;
+	public readonly DOMRect: typeof DOMRect;
 	public readonly Request: {
 		new (input: string | { href: string } | IRequest, init?: IRequestInit): IRequest;
-	} = Request;
+	};
 	public readonly Response: {
 		new (body?: NodeJS.ReadableStream | null, init?: IResponseInit): IResponse;
-	} = Response;
-	public readonly DOMRect: typeof DOMRect;
+	};
+	public readonly DOMParser;
+	public readonly Range;
+	public readonly FileReader;
+	public readonly Image;
 
 	// Events
 	public onload: (event: Event) => void = null;
@@ -220,10 +230,6 @@ export default class Window extends EventTarget implements IWindow {
 	public readonly localStorage = new Storage();
 	public readonly performance = PerfHooks.performance;
 
-	// Atob & btoa
-	public atob = atob;
-	public btoa = btoa;
-
 	// Node.js Globals
 	public ArrayBuffer;
 	public Boolean;
@@ -288,10 +294,10 @@ export default class Window extends EventTarget implements IWindow {
 	public Function;
 
 	// Private properties
-	private _setTimeout = setTimeout;
-	private _clearTimeout = clearTimeout;
-	private _setInterval = setInterval;
-	private _clearInterval = clearInterval;
+	private _setTimeout;
+	private _clearTimeout;
+	private _setInterval;
+	private _clearInterval;
 
 	/**
 	 * Constructor.
@@ -299,24 +305,19 @@ export default class Window extends EventTarget implements IWindow {
 	constructor() {
 		super();
 
-		this.document = new HTMLDocument();
-		this.document.defaultView = this;
-		this.document._readyStateManager.whenComplete().then(() => {
-			this.dispatchEvent(new Event('load'));
-		});
-
-		DOMParser._ownerDocument = this.document;
-		FileReader._ownerDocument = this.document;
-		Image.ownerDocument = this.document;
-		Request._ownerDocument = this.document;
-		Response._ownerDocument = this.document;
+		this._setTimeout = ORIGINAL_SET_TIMEOUT;
+		this._clearTimeout = ORIGINAL_CLEAR_TIMEOUT;
+		this._setInterval = ORIGINAL_SET_INTERVAL;
+		this._clearInterval = ORIGINAL_CLEAR_INTERVAL;
 
+		// Non-implemented event types
 		for (const eventType of NonImplementedEventTypes) {
 			if (!this[eventType]) {
 				this[eventType] = Event;
 			}
 		}
 
+		// Non implemented element classes
 		for (const className of NonImplemenetedElementClasses) {
 			if (!this[className]) {
 				this[className] = HTMLElement;
@@ -337,7 +338,54 @@ export default class Window extends EventTarget implements IWindow {
 			}
 		}
 
+		HTMLDocument._defaultView = this;
+
+		const document = new HTMLDocument();
+
+		this.document = document;
+
+		// We need to set the correct owner document when the class is constructed.
+		// To achieve this we will extend the original implementation with a class that sets the owner document.
+
+		ResponseImplementation._ownerDocument = document;
+		RequestImplementation._ownerDocument = document;
+		ImageImplementation._ownerDocument = document;
+		FileReaderImplementation._ownerDocument = document;
+		DOMParserImplementation._ownerDocument = document;
+		RangeImplementation._ownerDocument = document;
+
+		/* eslint-disable jsdoc/require-jsdoc */
+		class Response extends ResponseImplementation {
+			public static _ownerDocument: IDocument = document;
+		}
+		class Request extends RequestImplementation {
+			public static _ownerDocument: IDocument = document;
+		}
+		class Image extends ImageImplementation {
+			public static _ownerDocument: IDocument = document;
+		}
+		class FileReader extends FileReaderImplementation {
+			public static _ownerDocument: IDocument = document;
+		}
+		class DOMParser extends DOMParserImplementation {
+			public static _ownerDocument: IDocument = document;
+		}
+		class Range extends RangeImplementation {
+			public static _ownerDocument: IDocument = document;
+		}
+
+		/* eslint-enable jsdoc/require-jsdoc */
+
+		this.Response = Response;
+		this.Request = Request;
+		this.Image = Image;
+		this.FileReader = FileReader;
+		this.DOMParser = DOMParser;
+		this.Range = Range;
+
 		this._setupVMContext();
+
+		this.document._onWindowReady();
 	}
 
 	/**
@@ -527,6 +575,30 @@ export default class Window extends EventTarget implements IWindow {
 		return await FetchHandler.fetch(this.document, url, init);
 	}
 
+	/**
+	 * Creates a Base64-encoded ASCII string from a binary string (i.e., a string in which each character in the string is treated as a byte of binary data).
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/btoa
+	 * @param data Binay data.
+	 * @returns Base64-encoded string.
+	 */
+	public btoa(data: unknown): string {
+		return Base64.btoa(data);
+	}
+
+	/**
+	 * Decodes a string of data which has been encoded using Base64 encoding.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/API/atob
+	 * @see https://infra.spec.whatwg.org/#forgiving-base64-encode.
+	 * @see Https://html.spec.whatwg.org/multipage/webappapis.html#btoa.
+	 * @param data Binay string.
+	 * @returns An ASCII string containing decoded data from encodedData.
+	 */
+	public atob(data: unknown): string {
+		return Base64.atob(data);
+	}
+
 	/**
 	 * Setup of VM context.
 	 */

package/src/xml-parser/XMLParser.ts

@@ -10,6 +10,7 @@ import HTMLScriptElement from '../nodes/html-script-element/HTMLScriptElement';
 import INode from '../nodes/node/INode';
 import IElement from '../nodes/element/IElement';
 import HTMLLinkElement from '../nodes/html-link-element/HTMLLinkElement';
+import IDocumentFragment from '../nodes/document-fragment/IDocumentFragment';
 
 const MARKUP_REGEXP = /<(\/?)([a-z][-.0-9_a-z]*)\s*([^<>]*?)(\/?)>/gi;
 const COMMENT_REGEXP = /<!--(.*?)-->|<([!?])([^>]*)>/gi;
@@ -28,11 +29,15 @@ export default class XMLParser {
 	 * @param [evaluateScripts = false] Set to "true" to enable script execution.
 	 * @returns Root element.
 	 */
-	public static parse(document: IDocument, data: string, evaluateScripts = false): IElement {
-		const root = document.createElement('root');
-		const stack = [root];
+	public static parse(
+		document: IDocument,
+		data: string,
+		evaluateScripts = false
+	): IDocumentFragment {
+		const root = document.createDocumentFragment();
+		const stack: Array<IElement | IDocumentFragment> = [root];
 		const markupRegexp = new RegExp(MARKUP_REGEXP, 'gi');
-		let parent = root;
+		let parent: IDocumentFragment | IElement = root;
 		let parentUnnestableTagName = null;
 		let lastTextIndex = 0;
 		let match: RegExpExecArray;
@@ -47,7 +52,10 @@ export default class XMLParser {
 			}
 
 			if (isStartTag) {
-				const namespaceURI = tagName === 'svg' ? NamespaceURI.svg : parent.namespaceURI;
+				const namespaceURI =
+					tagName === 'svg'
+						? NamespaceURI.svg
+						: (<IElement>parent).namespaceURI || NamespaceURI.html;
 				const newElement = document.createElementNS(namespaceURI, tagName);
 
 				// Scripts are not allowed to be executed when they are parsed using innerHTML, outerHTML, replaceWith() etc.
@@ -115,8 +123,8 @@ export default class XMLParser {
 	 * @param element Element.
 	 * @returns Tag name if element is unnestable.
 	 */
-	private static getUnnestableTagName(element: IElement): string {
-		const tagName = element.tagName.toLowerCase();
+	private static getUnnestableTagName(element: IElement | IDocumentFragment): string {
+		const tagName = (<IElement>element).tagName ? (<IElement>element).tagName.toLowerCase() : null;
 		return tagName && UnnestableElements.includes(tagName) ? tagName : null;
 	}
 

package/src/xml-serializer/XMLSerializer.ts

@@ -5,6 +5,7 @@ import DocumentType from '../nodes/document-type/DocumentType';
 import { escape } from 'he';
 import INode from '../nodes/node/INode';
 import IElement from '../nodes/element/IElement';
+import IHTMLTemplateElement from '../nodes/html-template-element/IHTMLTemplateElement';
 
 /**
  * Utility for converting an element to string.
@@ -28,9 +29,13 @@ export default class XMLSerializer {
 					return `<${tagName}${this._getAttributes(element)}>`;
 				}
 
+				const childNodes =
+					element.tagName === 'TEMPLATE'
+						? (<IHTMLTemplateElement>root).content.childNodes
+						: root.childNodes;
 				let innerHTML = '';
 
-				for (const node of root.childNodes) {
+				for (const node of childNodes) {
 					innerHTML += this.serializeToString(node, options);
 				}
 

package/lib/nodes/element/Range.d.ts

@@ -1,167 +0,0 @@
-import Node from '../node/Node';
-import DocumentFragment from '../document-fragment/DocumentFragment';
-import DOMRect from './DOMRect';
-/**
- * Range object.
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/Range
- */
-export default class Range {
-    private _startContainer;
-    private _endContainer;
-    private _startOffset;
-    private _endOffset;
-    private _collapsed;
-    /**
-     * Returns collapsed.
-     *
-     * @returns "true" if collapsed.
-     */
-    get collapsed(): boolean;
-    /**
-     * Returns common ancestor container.
-     *
-     * @returns Node.
-     */
-    get commonAncestorContainer(): Node;
-    /**
-     * Returns end container.
-     *
-     * @returns Node.
-     */
-    get endContainer(): Node;
-    /**
-     * Returns start container.
-     *
-     * @returns Node.
-     */
-    get startContainer(): Node;
-    /**
-     * Returns end offset.
-     *
-     * @returns Offset.
-     */
-    get endOffset(): number;
-    /**
-     * Returns start offset.
-     *
-     * @returns Offset.
-     */
-    get startOffset(): number;
-    /**
-     * Sets start.
-     *
-     * @param startNode Start node.
-     * @param startOffset Start offset.
-     */
-    setStart(startNode: Node, startOffset: number): void;
-    /**
-     * Sets end.
-     *
-     * @param endNode End node.
-     * @param endOffset End offset.
-     */
-    setEnd(endNode: Node, endOffset: number): void;
-    /**
-     * Sets start before.
-     */
-    setStartBefore(): void;
-    /**
-     * Sets start after.
-     */
-    setStartAfter(): void;
-    /**
-     * Sets end before.
-     */
-    setEndBefore(): void;
-    /**
-     * Sets end after.
-     */
-    setEndAfter(): void;
-    /**
-     * Selects a node.
-     */
-    selectNode(): void;
-    /**
-     * Selects node content.
-     */
-    selectNodeContents(): void;
-    /**
-     * Collapses the Range to one of its boundary points.
-     */
-    collapse(): void;
-    /**
-     * Removes the contents of a Range from the Document.
-     */
-    deleteContents(): void;
-    /**
-     * Moves contents of a Range from the document tree into a DocumentFragment.
-     */
-    extractContents(): DocumentFragment;
-    /**
-     * Insert a Node at the start of a Range.
-     */
-    insertNode(): void;
-    /**
-     * Moves content of a Range into a new Node.
-     */
-    surroundContents(): void;
-    /**
-     * Compares the boundary points of the Range with another Range.
-     *
-     * @returns "true" when equal.
-     */
-    compareBoundaryPoints(): boolean;
-    /**
-     * Clones the range.
-     *
-     * @returns Range.
-     */
-    cloneRange(): Range;
-    /**
-     * Releases the Range from use to improve performance.
-     */
-    detach(): void;
-    /**
-     * Returns the text of the Range.
-     *
-     * @returns Text.
-     */
-    toString(): string;
-    /**
-     * Returns -1, 0, or 1 indicating whether the point occurs before, inside, or after the Range.
-     *
-     * @returns Number.
-     */
-    comparePoint(): number;
-    /**
-     * Returns a DocumentFragment created from a given string of code.
-     *
-     * @returns Document fragment.
-     */
-    createContextualFragment(): DocumentFragment;
-    /**
-     * Returns a DOMRect object which bounds the entire contents of the Range; this would be the union of all the rectangles returned by range.getClientRects().
-     *
-     * @returns DOM rect.
-     */
-    getBoundingClientRect(): DOMRect;
-    /**
-     * Returns a list of DOMRect objects that aggregates the results of Element.getClientRects() for all the elements in the Range.
-     *
-     * @returns DOM rect.
-     */
-    getClientRects(): DOMRect;
-    /**
-     * Returns a boolean indicating whether the given node intersects the Range.
-     *
-     * @returns "true" when intersecting.
-     */
-    intersectsNode(): boolean;
-    /**
-     * Returns a boolean indicating whether the given point is in the Range.
-     *
-     * @returns "true" when in range.
-     */
-    isPointInRange(): boolean;
-}