happy-dom 2.41.0 → 2.43.1

package/src/dom-token-list/DOMTokenList.ts

@@ -0,0 +1,219 @@
+import DOMException from '../exception/DOMException';
+import Element from '../nodes/element/Element';
+import IDOMTokenList from './IDOMTokenList';
+
+/**
+ * DOM Token List.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList.
+ */
+export default class DOMTokenList implements IDOMTokenList {
+	public readonly length = 0;
+	private _ownerElement: Element;
+	private _attributeName: string;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param ownerElement Owner element.
+	 * @param attributeName Attribute name.
+	 */
+	constructor(ownerElement: Element, attributeName) {
+		this._ownerElement = ownerElement;
+		this._attributeName = attributeName;
+		this._updateIndices();
+	}
+
+	/**
+	 * Set value.
+	 *
+	 * @param value Value.
+	 */
+	public set value(value: string) {
+		this._ownerElement.setAttributeNS(null, this._attributeName, value);
+	}
+
+	/**
+	 * Get value.
+	 */
+	public get value(): string {
+		return this._ownerElement.getAttributeNS(null, this._attributeName);
+	}
+
+	/**
+	 * Get ClassName.
+	 *
+	 * @param index Index.
+	 * */
+	public item(index: number | string): string {
+		index = typeof index === 'number' ? index : 0;
+		return index >= 0 && this[index] ? this[index] : null;
+	}
+
+	/**
+	 * Replace Token.
+	 *
+	 * @param token Token.
+	 * @param newToken NewToken.
+	 */
+	public replace(token: string, newToken: string): boolean {
+		const attr = this._ownerElement.getAttributeNS(null, this._attributeName);
+		const list = attr ? attr.split(' ') : [];
+		const index = list.indexOf(token);
+		if (index === -1) {
+			return false;
+		}
+		list[index] = newToken;
+		this._ownerElement.setAttributeNS(null, this._attributeName, list.join(' '));
+		return true;
+	}
+
+	/**
+	 * Supports.
+	 *
+	 * @param token Token.
+	 */
+	public supports(token: string): boolean {
+		// TODO: Only implemented for classList, which does not have any supported tokens
+		throw new DOMException(
+			`Failed to execute '${token}' on 'DOMTokenList': DOMTokenList has no supported tokens.`,
+			'TypeError'
+		);
+	}
+
+	/**
+	 * Returns an iterator, allowing you to go through all values of the key/value pairs contained in this object.
+	 *
+	 *
+	 */
+	public values(): IterableIterator<string> {
+		const attr = this._ownerElement.getAttributeNS(null, this._attributeName);
+		return (attr ? attr.split(' ') : []).values();
+	}
+
+	/**
+	 * Returns an iterator, allowing you to go through all key/value pairs contained in this object.
+	 *
+	 *
+	 */
+	public entries(): IterableIterator<[number, string]> {
+		const attr = this._ownerElement.getAttributeNS(null, this._attributeName);
+		return (attr ? attr.split(' ') : []).entries();
+	}
+
+	/**
+	 * Executes a provided callback function once for each DOMTokenList element.
+	 *
+	 * @param callback
+	 * @param thisArg
+	 */
+	public forEach(callback: (currentValue, currentIndex, listObj) => void, thisArg?: this): void {
+		const attr = this._ownerElement.getAttributeNS(null, this._attributeName);
+		return (attr ? attr.split(' ') : []).forEach(callback, thisArg);
+	}
+
+	/**
+	 * Returns an iterator, allowing you to go through all keys of the key/value pairs contained in this object.
+	 *
+	 */
+	public keys(): IterableIterator<number> {
+		const attr = this._ownerElement.getAttributeNS(null, this._attributeName);
+		return (attr ? attr.split(' ') : []).keys();
+	}
+
+	/**
+	 * Adds tokens.
+	 *
+	 * @param tokens Tokens.
+	 */
+	public add(...tokens: string[]): void {
+		const attr = this._ownerElement.getAttributeNS(null, this._attributeName);
+		const list = attr ? attr.split(' ') : [];
+
+		for (const token of tokens) {
+			const index = list.indexOf(token);
+			if (index === -1) {
+				list.push(token);
+			} else {
+				list[index] = token;
+			}
+		}
+
+		this._ownerElement.setAttributeNS(null, this._attributeName, list.join(' '));
+	}
+
+	/**
+	 * Removes tokens.
+	 *
+	 * @param tokens Tokens.
+	 */
+	public remove(...tokens: string[]): void {
+		const attr = this._ownerElement.getAttributeNS(null, this._attributeName);
+		const list = attr ? attr.split(' ') : [];
+
+		for (const token of tokens) {
+			const index = list.indexOf(token);
+			if (index !== -1) {
+				list.splice(index, 1);
+			}
+		}
+
+		this._ownerElement.setAttributeNS(null, this._attributeName, list.join(' '));
+	}
+
+	/**
+	 * Check if the list contains a class.
+	 *
+	 * @param className Class name.
+	 * @returns TRUE if it contains.
+	 */
+	public contains(className: string): boolean {
+		const attr = this._ownerElement.getAttributeNS(null, this._attributeName);
+		return (attr ? attr.split(' ') : []).includes(className);
+	}
+
+	/**
+	 * Toggle a class name.
+	 *
+	 * @param token A string representing the class name you want to toggle.
+	 * @param [force] If included, turns the toggle into a one way-only operation. If set to `false`, then class name will only be removed, but not added. If set to `true`, then class name will only be added, but not removed.
+	 * @returns A boolean value, `true` or `false`, indicating whether class name is in the list after the call or not.
+	 */
+	public toggle(token: string, force?: boolean): boolean {
+		let shouldAdd: boolean;
+
+		if (force !== undefined) {
+			shouldAdd = force;
+		} else {
+			shouldAdd = !this.contains(token);
+		}
+
+		if (shouldAdd) {
+			this.add(token);
+			return true;
+		}
+
+		this.remove(token);
+
+		return false;
+	}
+
+	/**
+	 * Updates indices.
+	 */
+	public _updateIndices(): void {
+		const attr = this._ownerElement.getAttribute('class');
+		const list = attr ? Array.from(new Set(attr.split(' '))) : [];
+
+		for (let i = list.length - 1, max = this.length; i < max; i++) {
+			delete this[i];
+		}
+
+		for (let i = 0, max = list.length; i < max; i++) {
+			this[i] = list[i];
+		}
+
+		(<number>this.length) = list.length;
+	}
+}

package/src/dom-token-list/IDOMTokenList.ts

@@ -0,0 +1,19 @@
+/**
+ * IDOMTokenList.
+ */
+export default interface IDOMTokenList {
+	value: string;
+	readonly length: number;
+	item(index: number | string): string;
+	contains(token: string): boolean;
+	add(...tokens: string[]): void;
+	remove(...tokens: string[]): void;
+	toggle(token: string, force?: boolean): boolean;
+	replace(token: string, newToken: string): boolean;
+	supports(token: string): boolean;
+
+	values(): IterableIterator<string>;
+	entries(): IterableIterator<[number, string]>;
+	forEach(callback: (currentValue, currentIndex, listObj) => void, thisArg?: this): void;
+	keys(): IterableIterator<number>;
+}

package/src/nodes/document/Document.ts

@@ -21,6 +21,7 @@ import CSSStyleSheet from '../../css/CSSStyleSheet';
 import DOMException from '../../exception/DOMException';
 import CookieUtility from '../../cookie/CookieUtility';
 import IElement from '../element/IElement';
+import IHTMLScriptElement from '../html-script-element/IHTMLScriptElement';
 import IHTMLElement from '../html-element/IHTMLElement';
 import IDocumentType from '../document-type/IDocumentType';
 import INode from '../node/INode';
@@ -240,6 +241,15 @@ export default class Document extends Node implements IDocument {
 		return this._defaultView.location;
 	}
 
+	/**
+	 * Returns scripts.
+	 *
+	 * @returns Scripts.
+	 */
+	public get scripts(): IHTMLCollection<IHTMLScriptElement> {
+		return <IHTMLCollection<IHTMLScriptElement>>this.getElementsByTagName('script');
+	}
+
 	/**
 	 * Inserts a set of Node objects or DOMString objects after the last child of the ParentNode. DOMString objects are inserted as equivalent Text nodes.
 	 *

package/src/nodes/document/IDocument.ts

@@ -12,6 +12,11 @@ import INode from '../node/INode';
 import ICharacterData from '../character-data/ICharacterData';
 import IDocumentFragment from '../document-fragment/IDocumentFragment';
 import Selection from '../../selection/Selection';
+import IHTMLCollection from '../element/IHTMLCollection';
+import IHTMLScriptElement from '../html-script-element/IHTMLScriptElement';
+import CSSStyleSheet from '../../css/CSSStyleSheet';
+import Location from '../../location/Location';
+import DocumentReadyStateEnum from './DocumentReadyStateEnum';
 
 /**
  * Document.
@@ -24,7 +29,13 @@ export default interface IDocument extends IParentNode {
 	readonly doctype: IDocumentType;
 	readonly body: IHTMLElement;
 	readonly head: IHTMLElement;
+	readonly scripts: IHTMLCollection<IHTMLScriptElement>;
 	readonly activeElement: IHTMLElement;
+	readonly styleSheets: CSSStyleSheet[];
+	readonly scrollingElement: IHTMLElement;
+	readonly location: Location;
+	readonly readyState: DocumentReadyStateEnum;
+	cookie: string;
 
 	/**
 	 * Replaces the document HTML with new HTML.
@@ -69,7 +80,7 @@ export default interface IDocument extends IParentNode {
 	 * @param  data Text data.
 	 * @returns Text node.
 	 */
-	createTextNode(data: string): ICharacterData;
+	createTextNode(data?: string): ICharacterData;
 
 	/**
 	 * Creates a comment node.
@@ -77,7 +88,7 @@ export default interface IDocument extends IParentNode {
 	 * @param  data Text data.
 	 * @returns Text node.
 	 */
-	createComment(data: string): ICharacterData;
+	createComment(data?: string): ICharacterData;
 
 	/**
 	 * Creates a document fragment.

package/src/nodes/element/Element.ts

@@ -3,7 +3,8 @@ import ShadowRoot from '../shadow-root/ShadowRoot';
 import Attr from '../../attribute/Attr';
 import DOMRect from './DOMRect';
 import Range from './Range';
-import ClassList from './ClassList';
+import DOMTokenList from '../../dom-token-list/DOMTokenList';
+import IDOMTokenList from '../../dom-token-list/IDOMTokenList';
 import QuerySelector from '../../query-selector/QuerySelector';
 import SelectorItem from '../../query-selector/SelectorItem';
 import MutationRecord from '../../mutation-observer/MutationRecord';
@@ -36,13 +37,26 @@ export default class Element extends Node implements IElement {
 	public tagName: string = null;
 	public nodeType = Node.ELEMENT_NODE;
 	public shadowRoot: IShadowRoot = null;
-	public readonly classList = new ClassList(this);
+	public _attributes: { [k: string]: Attr } = {};
 	public scrollTop = 0;
 	public scrollLeft = 0;
 	public children: IHTMLCollection<IElement> = HTMLCollectionFactory.create();
-	public _attributes: { [k: string]: Attr } = {};
 	public readonly namespaceURI: string = null;
 
+	private _classList: DOMTokenList = null;
+
+	/**
+	 * Returns class list.
+	 *
+	 * @returns Class list.
+	 */
+	public get classList(): IDOMTokenList {
+		if (!this._classList) {
+			this._classList = new DOMTokenList(this, 'class');
+		}
+		return <IDOMTokenList>this._classList;
+	}
+
 	/**
 	 * Returns ID.
 	 *
@@ -769,6 +783,8 @@ export default class Element extends Node implements IElement {
 
 		this._attributes[name] = attribute;
 
+		this._updateDomListIndices();
+
 		if (
 			this.attributeChangedCallback &&
 			(<typeof Element>this.constructor)._observedAttributes &&
@@ -842,6 +858,8 @@ export default class Element extends Node implements IElement {
 	public removeAttributeNode(attribute: Attr): void {
 		delete this._attributes[attribute.name];
 
+		this._updateDomListIndices();
+
 		if (
 			this.attributeChangedCallback &&
 			(<typeof Element>this.constructor)._observedAttributes &&
@@ -933,4 +951,13 @@ export default class Element extends Node implements IElement {
 		}
 		return name.toLowerCase();
 	}
+
+	/**
+	 * Updates DOM list indices.
+	 */
+	protected _updateDomListIndices(): void {
+		if (this._classList) {
+			this._classList._updateIndices();
+		}
+	}
 }

package/src/nodes/element/IElement.ts

@@ -2,7 +2,7 @@ import IShadowRoot from '../shadow-root/IShadowRoot';
 import Attr from '../../attribute/Attr';
 import DOMRect from './DOMRect';
 import Range from './Range';
-import ClassList from './ClassList';
+import IDOMTokenList from '../../dom-token-list/IDOMTokenList';
 import INode from './../node/INode';
 import IChildNode from '../child-node/IChildNode';
 import IParentNode from '../parent-node/IParentNode';
@@ -16,7 +16,7 @@ export type TInsertAdjacentPositions = 'beforebegin' | 'afterbegin' | 'beforeend
 export default interface IElement extends IChildNode, INonDocumentTypeChildNode, IParentNode {
 	readonly tagName: string;
 	readonly shadowRoot: IShadowRoot;
-	readonly classList: ClassList;
+	readonly classList: IDOMTokenList;
 	readonly namespaceURI: string;
 	scrollTop: number;
 	scrollLeft: number;

package/src/nodes/html-label-element/HTMLLabelElement.ts

@@ -10,8 +10,6 @@ import IHTMLLabelElement from './IHTMLLabelElement';
  * https://developer.mozilla.org/en-US/docs/Web/API/HTMLLabelElement.
  */
 export default class HTMLLabelElement extends HTMLElement implements IHTMLLabelElement {
-	public _htmlFor: string = null;
-
 	/**
 	 * Returns a string containing the ID of the labeled control. This reflects the "for" attribute.
 	 *
@@ -73,8 +71,6 @@ export default class HTMLLabelElement extends HTMLElement implements IHTMLLabelE
 	 * @returns Cloned node.
 	 */
 	public cloneNode(deep = false): IHTMLLabelElement {
-		const clone = <HTMLLabelElement>super.cloneNode(deep);
-		clone._htmlFor = this._htmlFor;
-		return clone;
+		return <HTMLLabelElement>super.cloneNode(deep);
 	}
 }

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

@@ -7,6 +7,8 @@ import IHTMLLinkElement from './IHTMLLinkElement';
 import Event from '../../event/Event';
 import ErrorEvent from '../../event/events/ErrorEvent';
 import INode from '../../nodes/node/INode';
+import DOMTokenList from '../../dom-token-list/DOMTokenList';
+import IDOMTokenList from '../../dom-token-list/IDOMTokenList';
 
 /**
  * HTML Link Element.
@@ -19,6 +21,19 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 	public onload: (event: Event) => void = null;
 	public readonly sheet: CSSStyleSheet = null;
 	public _evaluateCSS = true;
+	private _relList: DOMTokenList = null;
+
+	/**
+	 * Returns rel list.
+	 *
+	 * @returns Rel list.
+	 */
+	public get relList(): IDOMTokenList {
+		if (!this._relList) {
+			this._relList = new DOMTokenList(this, 'rel');
+		}
+		return <IDOMTokenList>this._relList;
+	}
 
 	/**
 	 * Returns as.
@@ -259,4 +274,15 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 			}
 		}
 	}
+
+	/**
+	 * Updates DOM list indices.
+	 */
+	protected _updateDomListIndices(): void {
+		super._updateDomListIndices();
+
+		if (this._relList) {
+			this._relList._updateIndices();
+		}
+	}
 }

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

@@ -1,4 +1,5 @@
 import CSSStyleSheet from '../../css/CSSStyleSheet';
+import IDOMTokenList from '../../dom-token-list/IDOMTokenList';
 import IHTMLElement from '../html-element/IHTMLElement';
 
 /**
@@ -9,6 +10,7 @@ import IHTMLElement from '../html-element/IHTMLElement';
  */
 export default interface IHTMLLinkElement extends IHTMLElement {
 	readonly sheet: CSSStyleSheet;
+	readonly relList: IDOMTokenList;
 	as: string;
 	crossOrigin: string;
 	href: string;

package/src/query-selector/SelectorItem.ts

@@ -27,10 +27,11 @@ export default class SelectorItem {
 	 * @param selector Selector.
 	 */
 	constructor(selector: string) {
+		const isNotPseudo = selector.includes(':not(');
+
 		this.isAll = selector === '*';
 		this.isID = !this.isAll ? selector.startsWith('#') : false;
-		this.isAttribute =
-			!this.isAll && !this.isID && selector.includes('[') && !selector.includes(':not(');
+		this.isAttribute = !this.isAll && !this.isID && selector.includes('[') && !isNotPseudo;
 		this.isPseudo = !this.isAll && !this.isID && selector.includes(':');
 		this.isClass = !this.isAll && !this.isID && new RegExp(CLASS_REGEXP, 'g').test(selector);
 		this.tagName = !this.isAll && !this.isID ? selector.match(TAG_NAME_REGEXP) : null;
@@ -48,7 +49,6 @@ export default class SelectorItem {
 	 */
 	public match(element: Element): boolean {
 		const selector = this.selector;
-		let match;
 
 		// Is all (*)
 		if (this.isAll) {
@@ -68,29 +68,13 @@ export default class SelectorItem {
 		}
 
 		// Class match
-		if (this.isClass) {
-			const regexp = new RegExp(CLASS_REGEXP, 'g');
-
-			while ((match = regexp.exec(selector))) {
-				if (!element.classList.contains(match[1])) {
-					return false;
-				}
-			}
+		if (this.isClass && !this.matchesClass(element, selector)) {
+			return false;
 		}
 
 		// Pseudo match
-		if (this.isPseudo) {
-			const regexp = new RegExp(PSUEDO_REGEXP, 'g');
-
-			while ((match = regexp.exec(selector))) {
-				if (match[1] && !this.matchesNthChild(element, match[1], match[2])) {
-					return false;
-				} else if (match[3] && this.matchesAttribute(element, match[3])) {
-					return false;
-				} else if (match[4] && !this.matchesPsuedo(element, match[4])) {
-					return false;
-				}
-			}
+		if (this.isPseudo && !this.matchesPsuedo(element, selector)) {
+			return false;
 		}
 
 		// Attribute match
@@ -101,6 +85,35 @@ export default class SelectorItem {
 		return true;
 	}
 
+	/**
+	 * Matches a psuedo selector.
+	 *
+	 * @param element Element.
+	 * @param selector Selector.
+	 * @returns True if it is a match.
+	 */
+	private matchesPsuedo(element: Element, selector: string): boolean {
+		const regexp = new RegExp(PSUEDO_REGEXP, 'g');
+		let match: RegExpMatchArray;
+
+		while ((match = regexp.exec(selector))) {
+			const isNotClass = match[3] && match[3].trim()[0] === '.';
+			if (match[1] && !this.matchesNthChild(element, match[1], match[2])) {
+				return false;
+			} else if (
+				match[3] &&
+				((isNotClass && this.matchesClass(element, match[3])) ||
+					(!isNotClass && this.matchesAttribute(element, match[3])))
+			) {
+				return false;
+			} else if (match[4] && !this.matchesPsuedoExpression(element, match[4])) {
+				return false;
+			}
+		}
+
+		return true;
+	}
+
 	/**
 	 * Matches a nth-child selector.
 	 *
@@ -158,13 +171,13 @@ export default class SelectorItem {
 	}
 
 	/**
-	 * Matches a psuedo selector.
+	 * Matches a psuedo selector expression.
 	 *
 	 * @param element Element.
 	 * @param psuedo Psuedo name.
 	 * @returns True if it is a match.
 	 */
-	private matchesPsuedo(element: Element, psuedo: string): boolean {
+	private matchesPsuedoExpression(element: Element, psuedo: string): boolean {
 		const parent = <Element>element.parentNode;
 
 		if (!parent) {
@@ -220,7 +233,7 @@ export default class SelectorItem {
 	 */
 	private matchesAttribute(element: Element, selector: string): boolean {
 		const regexp = new RegExp(ATTRIBUTE_REGEXP, 'g');
-		let match;
+		let match: RegExpMatchArray;
 
 		while ((match = regexp.exec(selector))) {
 			const isPsuedo = match.index > 0 && selector[match.index] === '(';
@@ -236,6 +249,29 @@ export default class SelectorItem {
 		return true;
 	}
 
+	/**
+	 * Matches class.
+	 *
+	 * @param element Element.
+	 * @param selector Selector.
+	 * @returns True if it is a match.
+	 */
+	private matchesClass(element: Element, selector: string): boolean {
+		const regexp = new RegExp(CLASS_REGEXP, 'g');
+		const classList = element.className.split(' ');
+		let previousIndex = 0;
+		let match: RegExpMatchArray;
+
+		while ((match = regexp.exec(selector)) && match.index === previousIndex) {
+			if (!classList.includes(match[1])) {
+				return false;
+			}
+			previousIndex = match.index + match[0].length - 1;
+		}
+
+		return true;
+	}
+
 	/**
 	 * Matches attribute name only.
 	 *

package/src/window/IWindow.ts

@@ -69,11 +69,12 @@ import URLSearchParams from '../url-search-params/URLSearchParams';
 import HTMLCollection from '../nodes/element/HTMLCollection';
 import NodeList from '../nodes/node/NodeList';
 import Selection from '../selection/Selection';
+import IEventTarget from '../event/IEventTarget';
 
 /**
  * Window.
  */
-export default interface IWindow {
+export default interface IWindow extends IEventTarget {
 	// Public Properties
 	readonly happyDOM: {
 		whenAsyncComplete: () => Promise<void>;
@@ -166,6 +167,7 @@ export default interface IWindow {
 	readonly top: IWindow;
 	readonly parent: IWindow;
 	readonly window: IWindow;
+	readonly globalThis: IWindow;
 	readonly screen: Screen;
 	readonly innerWidth: number;
 	readonly innerHeight: number;

package/src/window/Window.ts

@@ -178,6 +178,7 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 	public readonly top = this;
 	public readonly parent = this;
 	public readonly window = this;
+	public readonly globalThis = this;
 	public readonly screen = new Screen();
 	public readonly innerWidth = 1024;
 	public readonly innerHeight = 768;

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

@@ -1,40 +0,0 @@
-import Element from './Element';
-/**
- * Class list.
- */
-export default class ClassList {
-    private _ownerElement;
-    /**
-     * Adds class names.
-     *
-     * @param ownerElement Owner element.
-     */
-    constructor(ownerElement: Element);
-    /**
-     * Adds class names.
-     *
-     * @param classNames Class names.
-     */
-    add(...classNames: string[]): void;
-    /**
-     * Adds class names.
-     *
-     * @param classNames Class names.
-     */
-    remove(...classNames: string[]): void;
-    /**
-     * Check if the list contains a class.
-     *
-     * @param className Class name.
-     * @returns TRUE if it contains.
-     */
-    contains(className: string): boolean;
-    /**
-     * Toggle a class name.
-     *
-     * @param className A string representing the class name you want to toggle.
-     * @param force If included, turns the toggle into a one way-only operation. If set to `false`, then class name will only be removed, but not added. If set to `true`, then class name will only be added, but not removed.
-     * @returns A boolean value, `true` or `false`, indicating whether class name is in the list after the call or not.
-     */
-    toggle(className: string, force?: boolean): boolean;
-}