happy-dom 2.40.3 → 2.43.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happy-dom",
-	"version": "2.40.3",
+	"version": "2.43.0",
 	"license": "MIT",
 	"homepage": "https://github.com/capricorn86/happy-dom",
 	"repository": "https://github.com/capricorn86/happy-dom",
@@ -75,5 +75,5 @@
 		"ts-jest": "^26.5.6",
 		"typescript": "^4.2.4"
 	},
-	"gitHead": "21157fb2f62e2827ce4de8a93f06c03deec138ae"
+	"gitHead": "ac202fdcad3d4e5b6a85d98728526ffca1a3b6d8"
 }

package/src/css/CSSStyleDeclaration.ts

@@ -4898,7 +4898,7 @@ export default class CSSStyleDeclaration {
 	 * @returns Item.
 	 */
 	public item(index: number): string {
-		return this[String(index)] || '';
+		return this[index] || '';
 	}
 
 	/**

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/index.ts

@@ -106,6 +106,7 @@ import ChildLessElements from './config/ChildLessElements';
 import CSSStyleSheet from './css/CSSStyleSheet';
 import Storage from './storage/Storage';
 import URLSearchParams from './url-search-params/URLSearchParams';
+import Selection from './selection/Selection';
 
 export {
 	AsyncWindow,
@@ -215,5 +216,6 @@ export {
 	ChildLessElements,
 	CSSStyleSheet,
 	Storage,
-	URLSearchParams
+	URLSearchParams,
+	Selection
 };

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';
@@ -35,6 +36,7 @@ import IHTMLStyleElement from '../html-style-element/IHTMLStyleElement';
 import DocumentReadyStateEnum from './DocumentReadyStateEnum';
 import DocumentReadyStateManager from './DocumentReadyStateManager';
 import Location from '../../location/Location';
+import Selection from '../../selection/Selection';
 
 /**
  * Document.
@@ -239,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.
 	 *
@@ -699,6 +710,15 @@ export default class Document extends Node implements IDocument {
 		return adopted;
 	}
 
+	/**
+	 * Returns selection.
+	 *
+	 * @returns Selection.
+	 */
+	public getSelection(): Selection {
+		return new Selection();
+	}
+
 	/**
 	 * @override
 	 */

package/src/nodes/document/IDocument.ts

@@ -11,6 +11,12 @@ import IParentNode from '../parent-node/IParentNode';
 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.
@@ -23,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.
@@ -68,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.
@@ -76,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.
@@ -152,4 +164,11 @@ export default interface IDocument extends IParentNode {
 	 * @returns Adopted node.
 	 */
 	adoptNode(node: INode): INode;
+
+	/**
+	 * Returns selection.
+	 *
+	 * @returns Selection.
+	 */
+	getSelection(): Selection;
 }

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/selection/Selection.ts

@@ -0,0 +1,140 @@
+import INode from '../nodes/node/INode';
+
+/**
+ * Selection.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/Selection.
+ */
+export default class Selection {
+	public readonly anchorNode: INode = null;
+	public readonly anchorOffset: number = 0;
+	public readonly baseNode: INode = null;
+	public readonly baseOffset: number = 0;
+	public readonly extentNode: INode = null;
+	public readonly extentOffset: number = 0;
+	public readonly focusNode: INode = null;
+	public readonly focusOffset: number = 0;
+	public readonly isCollapsed: boolean = true;
+	public readonly rangeCount: number = 0;
+	public readonly type: string = 'None';
+
+	/**
+	 * Adds a range.
+	 *
+	 * @param _range Range.
+	 */
+	public addRange(_range: object): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Collapses the current selection to a single point.
+	 *
+	 * @param _node Node.
+	 * @param _offset Offset.
+	 */
+	public collapse(_node: INode, _offset?: number): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Collapses the selection to the end.
+	 */
+	public collapseToEnd(): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Collapses the selection to the start.
+	 */
+	public collapseToStart(): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Indicates whether a specified node is part of the selection.
+	 *
+	 * @param _node Node.
+	 * @param _partialContainer Partial container.
+	 * @returns Always returns "true" for now.
+	 */
+	public containsNode(_node: INode, _partialContainer?: INode): boolean {
+		return true;
+	}
+
+	/**
+	 * Deletes the selected text from the document's DOM.
+	 */
+	public deleteFromDocument(): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Moves the focus of the selection to a specified point.
+	 *
+	 * @param _node Node.
+	 * @param _offset Offset.
+	 */
+	public extend(_node: INode, _offset?: number): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Moves the focus of the selection to a specified point.
+	 *
+	 * @param _index Index.
+	 */
+	public getRangeAt(_index: number): object {
+		throw new Error('Not a valid index.');
+	}
+
+	/**
+	 * Removes a range from a selection.
+	 *
+	 * @param _range Range.
+	 */
+	public removeRange(_range: object): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Removes all ranges.
+	 */
+	public removeAllRanges(): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Selects all children.
+	 *
+	 * @param _parentNode Parent node.
+	 */
+	public selectAllChildren(_parentNode: INode): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Sets the selection to be a range including all or parts of two specified DOM nodes, and any content located between them.
+	 *
+	 * @param _anchorNode Anchor node.
+	 * @param _anchorOffset Anchor offset.
+	 * @param _focusNode Focus node.
+	 * @param _focusOffset Focus offset.
+	 */
+	public setBaseAndExtent(
+		_anchorNode: INode,
+		_anchorOffset: number,
+		_focusNode: INode,
+		_focusOffset: number
+	): void {
+		// Do nothing.
+	}
+
+	/**
+	 * Returns string currently being represented by the selection object.
+	 */
+	public toString(): string {
+		return '';
+	}
+}