happy-dom 2.49.2 → 2.51.1

package/src/fetch/Response.ts

@@ -0,0 +1,149 @@
+import IResponse from './IResponse';
+import IBlob from '../file/IBlob';
+import IDocument from '../nodes/document/IDocument';
+import * as NodeFetch from 'node-fetch';
+
+/**
+ * Fetch response.
+ */
+export default class Response extends NodeFetch.Response implements IResponse {
+	public static _ownerDocument: IDocument = null;
+
+	/**
+	 * Returns array buffer.
+	 *
+	 * @returns Array buffer.
+	 */
+	public arrayBuffer(): Promise<ArrayBuffer> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.arrayBuffer()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns blob.
+	 *
+	 * @returns Blob.
+	 */
+	public blob(): Promise<IBlob> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.blob()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns buffer.
+	 *
+	 * @returns Buffer.
+	 */
+	public buffer(): Promise<Buffer> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.buffer()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns json.
+	 *
+	 * @returns JSON.
+	 */
+	public json(): Promise<unknown> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.json()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns json.
+	 *
+	 * @returns JSON.
+	 */
+	public text(): Promise<string> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.text()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns json.
+	 *
+	 * @returns JSON.
+	 */
+	public textConverted(): Promise<string> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.textConverted()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Handles promise start.
+	 *
+	 * @returns Task ID.
+	 */
+	private _handlePromiseStart(): number {
+		const taskManager = (<typeof Response>this.constructor)._ownerDocument.defaultView.happyDOM
+			.asyncTaskManager;
+		return taskManager.startTask();
+	}
+
+	/**
+	 * Handles promise end.
+	 *
+	 * @param resolve Resolve.
+	 * @param reject Reject.
+	 * @param taskID Task ID.
+	 * @param response Response.
+	 */
+	private _handlePromiseEnd(
+		resolve: (response: unknown) => void,
+		reject: (error: Error) => void,
+		taskID: number,
+		response: unknown
+	): void {
+		const taskManager = (<typeof Response>this.constructor)._ownerDocument.defaultView.happyDOM
+			.asyncTaskManager;
+		if (taskManager.getTaskCount() === 0) {
+			reject(new Error('Failed to complete fetch request. Task was canceled.'));
+		} else {
+			resolve(response);
+			taskManager.endTask(taskID);
+		}
+	}
+
+	/**
+	 * Handles promise error.
+	 *
+	 * @param error
+	 * @param reject
+	 */
+	private _handlePromiseError(reject: (error: Error) => void, error: Error): void {
+		const taskManager = (<typeof Response>this.constructor)._ownerDocument.defaultView.happyDOM
+			.asyncTaskManager;
+		reject(error);
+		taskManager.cancelAll(error);
+	}
+}

package/src/file/Blob.ts

@@ -1,3 +1,5 @@
+import IBlob from './IBlob';
+
 /**
  * Reference:
  * https://developer.mozilla.org/en-US/docs/Web/API/Blob.
@@ -5,7 +7,7 @@
  * Based on:
  * https://github.com/jsdom/jsdom/blob/master/lib/jsdom/living/file-api/Blob-impl.js (MIT licensed).
  */
-export default class Blob {
+export default class Blob implements IBlob {
 	public readonly _buffer: Buffer = null;
 	public readonly type: string = '';
 
@@ -108,6 +110,15 @@ export default class Blob {
 		return blob;
 	}
 
+	/**
+	 * Returns a Promise that resolves to a text.
+	 *
+	 * @returns Text.
+	 */
+	public async text(): Promise<string> {
+		return this._buffer.toString();
+	}
+
 	/**
 	 * Closes the blob.
 	 *

package/src/file/IBlob.ts

@@ -0,0 +1,10 @@
+/**
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/Blob.
+ */
+export default interface IBlob {
+	readonly type: string;
+	readonly size: number;
+	slice(start?: number, end?: number): IBlob;
+	text(): Promise<string>;
+}

package/src/form-data/IFormData.ts

@@ -0,0 +1,33 @@
+import Stream from 'stream';
+import HTTP from 'http';
+
+interface IHeaders {
+	[key: string]: unknown;
+}
+
+interface IAppendOptions {
+	header?: string | IHeaders;
+	knownLength?: number;
+	filename?: string;
+	filepath?: string;
+	contentType?: string;
+}
+
+interface ISubmitOptions extends HTTP.RequestOptions {
+	protocol?: 'https:' | 'http:';
+}
+
+export default interface IFormData extends Stream.Readable {
+	append(key: string, value: unknown, options?: IAppendOptions | string): void;
+	getHeaders(userHeaders?: IHeaders): { [key: string]: IHeaders };
+	submit(
+		params: string | ISubmitOptions,
+		callback?: (error: Error | null, response: HTTP.IncomingMessage) => void
+	): HTTP.ClientRequest;
+	getBuffer(): Buffer;
+	setBoundary(boundary: string): void;
+	getBoundary(): string;
+	getLength(callback: (err: Error | null, length: number) => void): void;
+	getLengthSync(): number;
+	hasKnownLength(): boolean;
+}

package/src/index.ts

@@ -14,9 +14,7 @@ import DOMException from './exception/DOMException';
 import History from './history/History';
 import CSSStyleDeclaration from './css/CSSStyleDeclaration';
 import Screen from './screen/Screen';
-import AsyncTaskManager from './window/AsyncTaskManager';
-import IResponse from './window/IResponse';
-import IFetchOptions from './window/IFetchOptions';
+import AsyncTaskManager from './async-task-manager/AsyncTaskManager';
 import NodeFilter from './tree-walker/NodeFilter';
 import Event from './event/Event';
 import EventTarget from './event/EventTarget';
@@ -101,7 +99,7 @@ import XMLParser from './xml-parser/XMLParser';
 import XMLSerializer from './xml-serializer/XMLSerializer';
 import CSSStyleSheet from './css/CSSStyleSheet';
 import Storage from './storage/Storage';
-import URLSearchParams from './url-search-params/URLSearchParams';
+import { URLSearchParams } from 'url';
 import Selection from './selection/Selection';
 
 export {
@@ -123,8 +121,6 @@ export {
 	CSSStyleDeclaration,
 	Screen,
 	AsyncTaskManager,
-	IResponse,
-	IFetchOptions,
 	NodeFilter,
 	Event,
 	EventTarget,

package/src/location/URL.ts

@@ -1,4 +1,5 @@
-const URL_REGEXP = /(https?:)\/\/([-a-zA-Z0-9@:%._\+~#=]{2,256}[a-z]{2,6})(:[0-9]*)?([-a-zA-Z0-9@:%_\+.~c&//=]*)(\?[^#]*)?(#.*)?/;
+const URL_REGEXP =
+	/(https?:)\/\/([-a-zA-Z0-9@:%._\+~#=]{2,256}[a-z]{2,6})(:[0-9]*)?([-a-zA-Z0-9@:%_\+.~c&//=]*)(\?[^#]*)?(#.*)?/;
 const PATH_REGEXP = /([-a-zA-Z0-9@:%_\+.~c&//=]*)(\?[^#]*)?(#.*)?/;
 
 /**
@@ -25,43 +26,6 @@ export default class URL {
 		}
 	}
 
-	/**
-	 * Returns the entire URL as a string.
-	 */
-	public toString(): string {
-		return this.href;
-	}
-
-	/**
-	 * Parses an URL.
-	 *
-	 * @param url URL.
-	 */
-	protected parse(url: string): void {
-		const match = url.match(URL_REGEXP);
-
-		if (match) {
-			const hostnamePart = match[2] ? match[2].split('@') : '';
-			const credentialsPart = hostnamePart.length > 1 ? hostnamePart[0].split(':') : null;
-
-			this.protocol = match[1] || '';
-			this.hostname = hostnamePart.length > 1 ? hostnamePart[1] : hostnamePart[0];
-			this.port = match[3] || '';
-			this.pathname = match[4] || '';
-			this.search = match[5] || '';
-			this.hash = match[6] || '';
-			this.username = credentialsPart ? credentialsPart[0] : '';
-			this.password = credentialsPart ? credentialsPart[1] : '';
-		} else {
-			const pathMatch = url.match(PATH_REGEXP);
-			if (pathMatch) {
-				this.pathname = pathMatch[1] || '';
-				this.search = pathMatch[2] || '';
-				this.hash = pathMatch[3] || '';
-			}
-		}
-	}
-
 	/**
 	 * Returns the entire URL as a string.
 	 *
@@ -98,4 +62,41 @@ export default class URL {
 	public get host(): string {
 		return this.hostname + this.port;
 	}
+
+	/**
+	 * Returns the entire URL as a string.
+	 */
+	public toString(): string {
+		return this.href;
+	}
+
+	/**
+	 * Parses an URL.
+	 *
+	 * @param url URL.
+	 */
+	protected parse(url: string): void {
+		const match = url.match(URL_REGEXP);
+
+		if (match) {
+			const hostnamePart = match[2] ? match[2].split('@') : '';
+			const credentialsPart = hostnamePart.length > 1 ? hostnamePart[0].split(':') : null;
+
+			this.protocol = match[1] || '';
+			this.hostname = hostnamePart.length > 1 ? hostnamePart[1] : hostnamePart[0];
+			this.port = match[3] || '';
+			this.pathname = match[4] || '';
+			this.search = match[5] || '';
+			this.hash = match[6] || '';
+			this.username = credentialsPart ? credentialsPart[0] : '';
+			this.password = credentialsPart ? credentialsPart[1] : '';
+		} else {
+			const pathMatch = url.match(PATH_REGEXP);
+			if (pathMatch) {
+				this.pathname = pathMatch[1] || '';
+				this.search = pathMatch[2] || '';
+				this.hash = pathMatch[3] || '';
+			}
+		}
+	}
 }

package/src/mutation-observer/MutationObserver.ts

@@ -39,7 +39,7 @@ export default class MutationObserver {
 
 		options = Object.assign({}, options, {
 			attributeFilter: options.attributeFilter
-				? options.attributeFilter.map(name => name.toLowerCase())
+				? options.attributeFilter.map((name) => name.toLowerCase())
 				: null
 		});
 

package/src/nodes/character-data/CharacterData.ts

@@ -106,6 +106,24 @@ export default abstract class CharacterData extends Node implements ICharacterDa
 		this.textContent = nodeValue;
 	}
 
+	/**
+	 * Previous element sibling.
+	 *
+	 * @returns Element.
+	 */
+	public get previousElementSibling(): IElement {
+		return NonDocumentChildNodeUtility.previousElementSibling(this);
+	}
+
+	/**
+	 * Next element sibling.
+	 *
+	 * @returns Element.
+	 */
+	public get nextElementSibling(): IElement {
+		return NonDocumentChildNodeUtility.nextElementSibling(this);
+	}
+
 	/**
 	 * Appends the given DOMString to the CharacterData.data string; when this method returns, data contains the concatenated DOMString.
 	 *
@@ -155,23 +173,6 @@ export default abstract class CharacterData extends Node implements ICharacterDa
 	public substringData(offset: number, count: number): string {
 		return CharacterDataUtility.substringData(this, offset, count);
 	}
-	/**
-	 * Previous element sibling.
-	 *
-	 * @returns Element.
-	 */
-	public get previousElementSibling(): IElement {
-		return NonDocumentChildNodeUtility.previousElementSibling(this);
-	}
-
-	/**
-	 * Next element sibling.
-	 *
-	 * @returns Element.
-	 */
-	public get nextElementSibling(): IElement {
-		return NonDocumentChildNodeUtility.nextElementSibling(this);
-	}
 
 	/**
 	 * Removes the object from its parent children list.

package/src/nodes/document/Document.ts

@@ -37,6 +37,7 @@ import DocumentReadyStateEnum from './DocumentReadyStateEnum';
 import DocumentReadyStateManager from './DocumentReadyStateManager';
 import Location from '../../location/Location';
 import Selection from '../../selection/Selection';
+import IShadowRoot from '../shadow-root/IShadowRoot';
 
 /**
  * Document.
@@ -240,6 +241,17 @@ export default class Document extends Node implements IDocument {
 	 * @returns Active element.
 	 */
 	public get activeElement(): IHTMLElement {
+		if (this._activeElement) {
+			let rootNode: IShadowRoot | IDocument = <IShadowRoot | IDocument>(
+				this._activeElement.getRootNode()
+			);
+			let activeElement: IHTMLElement = this._activeElement;
+			while (rootNode !== this) {
+				activeElement = <IHTMLElement>(<IShadowRoot>rootNode).host;
+				rootNode = <IShadowRoot | IDocument>activeElement.getRootNode();
+			}
+			return activeElement;
+		}
 		return this._activeElement || this.body || this.documentElement || null;
 	}
 
@@ -590,32 +602,33 @@ export default class Document extends Node implements IDocument {
 	 */
 	public close(): void {}
 
+	/* eslint-disable jsdoc/valid-types */
+
 	/**
 	 * Creates an element.
 	 *
-	 * @param tagName Tag name.
+	 * @param qualifiedName Tag name.
 	 * @param [options] Options.
-	 * @param options.is
+	 * @param [options.is] Tag name of a custom element previously defined via customElements.define().
 	 * @returns Element.
 	 */
-	public createElement(tagName: string, options?: { is: string }): IElement {
-		return this.createElementNS(NamespaceURI.html, tagName, options);
+	public createElement(qualifiedName: string, options?: { is?: string }): IElement {
+		return this.createElementNS(NamespaceURI.html, qualifiedName, options);
 	}
 
 	/**
 	 * Creates an element with the specified namespace URI and qualified name.
 	 *
-	 * @param tagName Tag name.
+	 * @param namespaceURI Namespace URI.
+	 * @param qualifiedName Tag name.
 	 * @param [options] Options.
-	 * @param namespaceURI
-	 * @param qualifiedName
-	 * @param options.is
+	 * @param [options.is] Tag name of a custom element previously defined via customElements.define().
 	 * @returns Element.
 	 */
 	public createElementNS(
 		namespaceURI: string,
 		qualifiedName: string,
-		options?: { is: string }
+		options?: { is?: string }
 	): IElement {
 		const tagName = qualifiedName.toUpperCase();
 
@@ -638,6 +651,8 @@ export default class Document extends Node implements IDocument {
 		return element;
 	}
 
+	/* eslint-enable jsdoc/valid-types */
+
 	/**
 	 * Creates a text node.
 	 *

package/src/nodes/document/DocumentReadyStateManager.ts

@@ -25,7 +25,7 @@ export default class DocumentReadyStateManager {
 	 * @returns Promise.
 	 */
 	public whenComplete(): Promise<void> {
-		return new Promise(resolve => {
+		return new Promise((resolve) => {
 			if (this.isComplete) {
 				resolve();
 			} else {

package/src/nodes/html-input-element/HTMLInputElementValueSanitizer.ts

@@ -28,7 +28,7 @@ export default class HTMLInputElementValueSanitizer {
 				if (input.multiple) {
 					return value
 						.split(',')
-						.map(token => token.trim())
+						.map((token) => token.trim())
 						.join(',');
 				}
 				return value.trim().replace(NEW_LINES_REGEXP, '');

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

@@ -1,6 +1,6 @@
 import Attr from '../../attribute/Attr';
 import CSSStyleSheet from '../../css/CSSStyleSheet';
-import ResourceFetcher from '../../fetch/ResourceFetcher';
+import ResourceFetchHandler from '../../fetch/ResourceFetchHandler';
 import HTMLElement from '../html-element/HTMLElement';
 import Document from '../document/Document';
 import IHTMLLinkElement from './IHTMLLinkElement';
@@ -199,15 +199,15 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 			this.isConnected
 		) {
 			(<Document>this.ownerDocument)._readyStateManager.startTask();
-			ResourceFetcher.fetch({ window: this.ownerDocument.defaultView, url: href })
-				.then(code => {
+			ResourceFetchHandler.fetch(this.ownerDocument, href)
+				.then((code) => {
 					const styleSheet = new CSSStyleSheet();
 					styleSheet.replaceSync(code);
 					(<CSSStyleSheet>this.sheet) = styleSheet;
 					this.dispatchEvent(new Event('load'));
 					(<Document>this.ownerDocument)._readyStateManager.endTask();
 				})
-				.catch(error => {
+				.catch((error) => {
 					this.dispatchEvent(
 						new ErrorEvent('error', {
 							message: error.message,
@@ -245,15 +245,15 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 
 			if (href !== null && rel && rel.toLowerCase() === 'stylesheet') {
 				(<Document>this.ownerDocument)._readyStateManager.startTask();
-				ResourceFetcher.fetch({ window: this.ownerDocument.defaultView, url: href })
-					.then(code => {
+				ResourceFetchHandler.fetch(this.ownerDocument, href)
+					.then((code) => {
 						const styleSheet = new CSSStyleSheet();
 						styleSheet.replaceSync(code);
 						(<CSSStyleSheet>this.sheet) = styleSheet;
 						this.dispatchEvent(new Event('load'));
 						(<Document>this.ownerDocument)._readyStateManager.endTask();
 					})
-					.catch(error => {
+					.catch((error) => {
 						this.dispatchEvent(
 							new ErrorEvent('error', {
 								message: error.message,

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

@@ -1,7 +1,7 @@
 import { Document } from '../..';
 import Event from '../../event/Event';
 import ErrorEvent from '../../event/events/ErrorEvent';
-import ResourceFetcher from '../../fetch/ResourceFetcher';
+import ResourceFetchHandler from '../../fetch/ResourceFetchHandler';
 import HTMLScriptElement from './HTMLScriptElement';
 
 /**
@@ -22,10 +22,7 @@ export default class ScriptUtility {
 			let code = null;
 			(<Document>element.ownerDocument)._readyStateManager.startTask();
 			try {
-				code = await ResourceFetcher.fetch({
-					window: element.ownerDocument.defaultView,
-					url: src
-				});
+				code = await ResourceFetchHandler.fetch(element.ownerDocument, src);
 			} catch (error) {
 				element.dispatchEvent(
 					new ErrorEvent('error', {
@@ -54,10 +51,7 @@ export default class ScriptUtility {
 		} else {
 			let code = null;
 			try {
-				code = ResourceFetcher.fetchSync({
-					window: element.ownerDocument.defaultView,
-					url: src
-				});
+				code = ResourceFetchHandler.fetchSync(element.ownerDocument, src);
 			} catch (error) {
 				element.dispatchEvent(
 					new ErrorEvent('error', {

package/src/query-selector/SelectorItem.ts

@@ -1,7 +1,8 @@
 import DOMException from '../exception/DOMException';
 import Element from '../nodes/element/Element';
 
-const ATTRIBUTE_REGEXP = /\[([a-zA-Z0-9-_]+)\]|\[([a-zA-Z0-9-_]+)([~|^$*]{0,1})[ ]*=[ ]*["']{0,1}([^"']+)["']{0,1}\]/g;
+const ATTRIBUTE_REGEXP =
+	/\[([a-zA-Z0-9-_]+)\]|\[([a-zA-Z0-9-_]+)([~|^$*]{0,1})[ ]*=[ ]*["']{0,1}([^"']+)["']{0,1}\]/g;
 const ATTRIBUTE_NAME_REGEXP = /[^a-zA-Z0-9-_$]/;
 const PSUEDO_REGEXP = /:([a-zA-Z-]+)\(([0-9n+-]+|odd|even)\)|:not\(([^)]+)\)|:([a-zA-Z-]+)/g;
 const CLASS_REGEXP = /\.([a-zA-Z0-9-_$]+)/g;
@@ -127,13 +128,13 @@ export default class SelectorItem {
 
 		switch (psuedo.toLowerCase()) {
 			case 'nth-of-type':
-				children = children.filter(child => child.tagName === element.tagName);
+				children = children.filter((child) => child.tagName === element.tagName);
 				break;
 			case 'nth-last-child':
 				children = children.reverse();
 				break;
 			case 'nth-last-of-type':
-				children = children.filter(child => child.tagName === element.tagName).reverse();
+				children = children.filter((child) => child.tagName === element.tagName).reverse();
 				break;
 		}
 
@@ -285,7 +286,7 @@ export default class SelectorItem {
 		return !!element._attributes[attributeName.toLowerCase()];
 	}
 
-	/**
+	/** .
 	 *
 	 * Matches attribute name and value.
 	 *
@@ -295,6 +296,13 @@ export default class SelectorItem {
 	 * @param [matchType] Match type.
 	 * @returns True if it is a match.
 	 */
+	/**
+	 *
+	 * @param element
+	 * @param attributeName
+	 * @param attributeValue
+	 * @param matchType
+	 */
 	private matchesAttributeNameAndValue(
 		element: Element,
 		attributeName: string,