happy-dom 14.12.3 → 15.0.0

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

@@ -1,247 +0,0 @@
-import Element from '../nodes/element/Element.js';
-import * as PropertySymbol from '../PropertySymbol.js';
-
-const ATTRIBUTE_SPLIT_REGEXP = /[\t\f\n\r ]+/;
-
-/**
- * DOM Token List.
- *
- * Reference:
- * https://developer.mozilla.org/en-US/docs/Web/API/DOMTokenList.
- */
-export default class DOMTokenList {
-	#length = 0;
-	#ownerElement: Element;
-	#attributeName: string;
-
-	/**
-	 * Constructor.
-	 *
-	 * @param ownerElement Owner element.
-	 * @param attributeName Attribute name.
-	 */
-	constructor(ownerElement: Element, attributeName) {
-		this.#ownerElement = ownerElement;
-		this.#attributeName = attributeName;
-		this[PropertySymbol.updateIndices]();
-	}
-
-	/**
-	 * Returns length.
-	 *
-	 * @returns Length.
-	 */
-	public get length(): number {
-		return this.#length;
-	}
-
-	/**
-	 * Set value.
-	 *
-	 * @param value Value.
-	 */
-	public set value(value: string) {
-		this.#ownerElement.setAttribute(this.#attributeName, value);
-	}
-
-	/**
-	 * Get value.
-	 */
-	public get value(): string {
-		return this.#ownerElement.getAttribute(this.#attributeName);
-	}
-
-	/**
-	 * Returns an iterator, allowing you to go through all values of the key/value pairs contained in this object.
-	 */
-	public [Symbol.iterator](): IterableIterator<string> {
-		return this.#getTokenList().values();
-	}
-
-	/**
-	 * 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 list = this.#getTokenList();
-		const index = list.indexOf(token);
-		if (index === -1) {
-			return false;
-		}
-		list[index] = newToken;
-		this.#ownerElement.setAttribute(this.#attributeName, list.join(' '));
-		return true;
-	}
-
-	/**
-	 * Supports.
-	 *
-	 * @param _token Token.
-	 */
-	public supports(_token: string): boolean {
-		return false;
-	}
-
-	/**
-	 * Returns an iterator, allowing you to go through all values of the key/value pairs contained in this object.
-	 */
-	public values(): IterableIterator<string> {
-		return this.#getTokenList().values();
-	}
-
-	/**
-	 * Returns an iterator, allowing you to go through all key/value pairs contained in this object.
-	 */
-	public entries(): IterableIterator<[number, string]> {
-		return this.#getTokenList().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 {
-		return this.#getTokenList().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> {
-		return this.#getTokenList().keys();
-	}
-
-	/**
-	 * Adds tokens.
-	 *
-	 * @param tokens Tokens.
-	 */
-	public add(...tokens: string[]): void {
-		const list = this.#getTokenList();
-
-		for (const token of tokens) {
-			const index = list.indexOf(token);
-			if (index === -1) {
-				list.push(token);
-			} else {
-				list[index] = token;
-			}
-		}
-
-		this.#ownerElement.setAttribute(this.#attributeName, list.join(' '));
-	}
-
-	/**
-	 * Removes tokens.
-	 *
-	 * @param tokens Tokens.
-	 */
-	public remove(...tokens: string[]): void {
-		const list = this.#getTokenList();
-
-		for (const token of tokens) {
-			const index = list.indexOf(token);
-			if (index !== -1) {
-				list.splice(index, 1);
-			}
-		}
-
-		this.#ownerElement.setAttribute(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 list = this.#getTokenList();
-		return list.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 [PropertySymbol.updateIndices](): void {
-		const list = this.#getTokenList();
-
-		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];
-		}
-
-		this.#length = list.length;
-	}
-
-	/**
-	 * Returns token list from attribute value.
-	 *
-	 * @see https://infra.spec.whatwg.org/#split-on-ascii-whitespace
-	 */
-	#getTokenList(): string[] {
-		const attr = this.#ownerElement.getAttribute(this.#attributeName);
-		if (!attr) {
-			return [];
-		}
-		// It is possible to make this statement shorter by using Array.from() and Set, but this is faster when comparing using a bench test.
-		const list = [];
-		for (const item of attr.trim().split(ATTRIBUTE_SPLIT_REGEXP)) {
-			if (!list.includes(item)) {
-				list.push(item);
-			}
-		}
-		return list;
-	}
-
-	/**
-	 * Returns DOMTokenList value.
-	 */
-	public toString(): string {
-		return this.value || '';
-	}
-}

package/src/mutation-observer/MutationListener.ts

@@ -1,94 +0,0 @@
-import IMutationObserverInit from './IMutationObserverInit.js';
-import MutationObserver from './MutationObserver.js';
-import MutationRecord from './MutationRecord.js';
-import Node from '../nodes/node/Node.js';
-import BrowserWindow from '../window/BrowserWindow.js';
-
-/**
- * Mutation Observer Listener.
- */
-export default class MutationListener {
-	public readonly target: Node;
-	public options: IMutationObserverInit;
-	#window: BrowserWindow;
-	#observer: MutationObserver;
-	#callback: (record: MutationRecord[], observer: MutationObserver) => void;
-	#records: MutationRecord[] | null = [];
-	#immediate: NodeJS.Immediate | null = null;
-
-	/**
-	 * Constructor.
-	 *
-	 * @param init Options.
-	 * @param init.window Window.
-	 * @param init.options Options.
-	 * @param init.target Target.
-	 * @param init.observer Observer.
-	 * @param init.callback Callback.
-	 */
-	constructor(init: {
-		window: BrowserWindow;
-		options: IMutationObserverInit;
-		target: Node;
-		observer: MutationObserver;
-		callback: (record: MutationRecord[], observer: MutationObserver) => void;
-	}) {
-		this.options = init.options;
-		this.target = init.target;
-		this.#window = init.window;
-		this.#observer = init.observer;
-		this.#callback = init.callback;
-	}
-
-	/**
-	 * Reports mutations.
-	 *
-	 * @param record Record.
-	 */
-	public report(record: MutationRecord): void {
-		if (!this.#records) {
-			return;
-		}
-
-		this.#records.push(record);
-
-		if (this.#immediate) {
-			this.#window.cancelAnimationFrame(this.#immediate);
-		}
-
-		this.#immediate = this.#window.requestAnimationFrame(() => {
-			const records = this.#records;
-			if (records?.length > 0) {
-				this.#records = [];
-				this.#callback(records, this.#observer);
-			}
-		});
-	}
-
-	/**
-	 * Destroys the listener.
-	 */
-	public takeRecords(): MutationRecord[] {
-		if (this.#immediate) {
-			this.#window.cancelAnimationFrame(this.#immediate);
-		}
-		const records = this.#records;
-		this.#records = [];
-		return records;
-	}
-
-	/**
-	 * Destroys the listener.
-	 */
-	public destroy(): void {
-		if (this.#immediate) {
-			this.#window.cancelAnimationFrame(this.#immediate);
-		}
-		(<null>this.options) = null;
-		(<null>this.target) = null;
-		(<null>this.#observer) = null;
-		(<null>this.#callback) = null;
-		(<null>this.#immediate) = null;
-		(<null>this.#records) = null;
-	}
-}

package/src/named-node-map/NamedNodeMap.ts

@@ -1,232 +0,0 @@
-import * as PropertySymbol from '../PropertySymbol.js';
-import Attr from '../nodes/attr/Attr.js';
-import DOMException from '../exception/DOMException.js';
-import DOMExceptionNameEnum from '../exception/DOMExceptionNameEnum.js';
-
-/**
- * Named Node Map.
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/API/NamedNodeMap
- */
-export default class NamedNodeMap {
-	[index: number]: Attr;
-	public length = 0;
-	protected [PropertySymbol.namedItems]: { [k: string]: Attr } = {};
-
-	/**
-	 * Returns string.
-	 *
-	 * @returns string.
-	 */
-	public get [Symbol.toStringTag](): string {
-		return 'NamedNodeMap';
-	}
-
-	/**
-	 * Iterator.
-	 *
-	 * @returns Iterator.
-	 */
-	public *[Symbol.iterator](): IterableIterator<Attr> {
-		for (let i = 0, max = this.length; i < max; i++) {
-			yield this[i];
-		}
-	}
-
-	/**
-	 * Returns item by index.
-	 *
-	 * @param index Index.
-	 */
-	public item(index: number): Attr | null {
-		return index >= 0 && this[index] ? this[index] : null;
-	}
-
-	/**
-	 * Returns named item.
-	 *
-	 * @param name Name.
-	 * @returns Item.
-	 */
-	public getNamedItem(name: string): Attr | null {
-		return this[PropertySymbol.namedItems][name] || null;
-	}
-
-	/**
-	 * Returns item by name and namespace.
-	 *
-	 * @param namespace Namespace.
-	 * @param localName Local name of the attribute.
-	 * @returns Item.
-	 */
-	public getNamedItemNS(namespace: string, localName: string): Attr | null {
-		const attribute = this.getNamedItem(localName);
-
-		if (
-			attribute &&
-			attribute[PropertySymbol.namespaceURI] === namespace &&
-			attribute.localName === localName
-		) {
-			return attribute;
-		}
-
-		for (let i = 0, max = this.length; i < max; i++) {
-			if (this[i][PropertySymbol.namespaceURI] === namespace && this[i].localName === localName) {
-				return this[i];
-			}
-		}
-
-		return null;
-	}
-
-	/**
-	 * Sets named item.
-	 *
-	 * @param item Item.
-	 * @returns Replaced item.
-	 */
-	public setNamedItem(item: Attr): Attr | null {
-		return this[PropertySymbol.setNamedItemWithoutConsequences](item);
-	}
-
-	/**
-	 * Adds a new namespaced item.
-	 *
-	 * @alias setNamedItem()
-	 * @param item Item.
-	 * @returns Replaced item.
-	 */
-	public setNamedItemNS(item: Attr): Attr | null {
-		return this.setNamedItem(item);
-	}
-
-	/**
-	 * Removes an item.
-	 *
-	 * @throws DOMException
-	 * @param name Name of item.
-	 * @returns Removed item.
-	 */
-	public removeNamedItem(name: string): Attr {
-		const item = this[PropertySymbol.removeNamedItem](name);
-		if (!item) {
-			throw new DOMException(
-				`Failed to execute 'removeNamedItem' on 'NamedNodeMap': No item with name '${name}' was found.`,
-				DOMExceptionNameEnum.notFoundError
-			);
-		}
-		return item;
-	}
-
-	/**
-	 * Removes a namespaced item.
-	 *
-	 * @param namespace Namespace.
-	 * @param localName Local name of the item.
-	 * @returns Removed item.
-	 */
-	public removeNamedItemNS(namespace: string, localName: string): Attr | null {
-		const attribute = this.getNamedItemNS(namespace, localName);
-		if (attribute) {
-			return this.removeNamedItem(attribute[PropertySymbol.name]);
-		}
-		return null;
-	}
-
-	/**
-	 * Sets named item without calling listeners for certain attributes.
-	 *
-	 * @param item Item.
-	 * @returns Replaced item.
-	 */
-	public [PropertySymbol.setNamedItemWithoutConsequences](item: Attr): Attr | null {
-		if (item[PropertySymbol.name]) {
-			const replacedItem = this[PropertySymbol.namedItems][item[PropertySymbol.name]] || null;
-
-			this[PropertySymbol.namedItems][item[PropertySymbol.name]] = item;
-
-			if (replacedItem) {
-				this[PropertySymbol.removeNamedItemIndex](replacedItem);
-			}
-
-			this[this.length] = item;
-			this.length++;
-
-			if (this[PropertySymbol.isValidPropertyName](item[PropertySymbol.name])) {
-				this[item[PropertySymbol.name]] = item;
-			}
-
-			return replacedItem;
-		}
-		return null;
-	}
-
-	/**
-	 * Removes an item without throwing if it doesn't exist.
-	 *
-	 * @param name Name of item.
-	 * @returns Removed item, or null if it didn't exist.
-	 */
-	public [PropertySymbol.removeNamedItem](name: string): Attr | null {
-		return this[PropertySymbol.removeNamedItemWithoutConsequences](name);
-	}
-
-	/**
-	 * Removes an item without calling listeners for certain attributes.
-	 *
-	 * @param name Name of item.
-	 * @returns Removed item, or null if it didn't exist.
-	 */
-	public [PropertySymbol.removeNamedItemWithoutConsequences](name: string): Attr | null {
-		const removedItem = this[PropertySymbol.namedItems][name] || null;
-
-		if (!removedItem) {
-			return null;
-		}
-
-		this[PropertySymbol.removeNamedItemIndex](removedItem);
-
-		if (this[name] === removedItem) {
-			delete this[name];
-		}
-
-		delete this[PropertySymbol.namedItems][name];
-
-		return removedItem;
-	}
-
-	/**
-	 * Removes an item from index.
-	 *
-	 * @param item Item.
-	 */
-	protected [PropertySymbol.removeNamedItemIndex](item: Attr): void {
-		for (let i = 0; i < this.length; i++) {
-			if (this[i] === item) {
-				for (let b = i; b < this.length; b++) {
-					if (b < this.length - 1) {
-						this[b] = this[b + 1];
-					} else {
-						delete this[b];
-					}
-				}
-				this.length--;
-				break;
-			}
-		}
-	}
-
-	/**
-	 * Returns "true" if the property name is valid.
-	 *
-	 * @param name Name.
-	 * @returns True if the property name is valid.
-	 */
-	protected [PropertySymbol.isValidPropertyName](name: string): boolean {
-		return (
-			!!name &&
-			!this.constructor.prototype.hasOwnProperty(name) &&
-			(isNaN(Number(name)) || name.includes('.'))
-		);
-	}
-}

package/src/nodes/element/DatasetFactory.ts

@@ -1,86 +0,0 @@
-import Element from './Element.js';
-import * as PropertySymbol from '../../PropertySymbol.js';
-import HTMLElementNamedNodeMap from '../html-element/HTMLElementNamedNodeMap.js';
-import DatasetUtility from './DatasetUtility.js';
-import IDataset from './IDataset.js';
-
-/**
- * Dataset factory.
- *
- * Reference:
- * https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset
- */
-export default class DatasetFactory {
-	/**
-	 * @param element The parent element.
-	 */
-	public static createDataset(element: Element): IDataset {
-		// Build the initial dataset record from all data attributes.
-		const dataset: IDataset = {};
-
-		for (let i = 0, max = element[PropertySymbol.attributes].length; i < max; i++) {
-			const attribute = element[PropertySymbol.attributes][i];
-			if (attribute[PropertySymbol.name].startsWith('data-')) {
-				const key = DatasetUtility.kebabToCamelCase(
-					attribute[PropertySymbol.name].replace('data-', '')
-				);
-				dataset[key] = attribute[PropertySymbol.value];
-			}
-		}
-
-		// Documentation for Proxy:
-		// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy
-		return new Proxy(dataset, {
-			get(dataset: IDataset, key: string): string {
-				const attribute = element[PropertySymbol.attributes].getNamedItem(
-					'data-' + DatasetUtility.camelCaseToKebab(key)
-				);
-				if (attribute) {
-					return (dataset[key] = attribute[PropertySymbol.value]);
-				}
-				delete dataset[key];
-				return undefined;
-			},
-			set(dataset: IDataset, key: string, value: string): boolean {
-				element.setAttribute('data-' + DatasetUtility.camelCaseToKebab(key), value);
-				dataset[key] = value;
-				return true;
-			},
-			deleteProperty(dataset: IDataset, key: string): boolean {
-				(<HTMLElementNamedNodeMap>element[PropertySymbol.attributes])[
-					PropertySymbol.removeNamedItem
-				]('data-' + DatasetUtility.camelCaseToKebab(key));
-				return delete dataset[key];
-			},
-			ownKeys(dataset: IDataset): string[] {
-				// According to Mozilla we have to update the dataset object (target) to contain the same keys as what we return:
-				// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/ownKeys
-				// "The result List must contain the keys of all non-configurable own properties of the target object."
-				const keys = [];
-				const deleteKeys = [];
-				for (let i = 0, max = element[PropertySymbol.attributes].length; i < max; i++) {
-					const attribute = element[PropertySymbol.attributes][i];
-					if (attribute[PropertySymbol.name].startsWith('data-')) {
-						const key = DatasetUtility.kebabToCamelCase(
-							attribute[PropertySymbol.name].replace('data-', '')
-						);
-						keys.push(key);
-						dataset[key] = attribute[PropertySymbol.value];
-						if (!dataset[key]) {
-							deleteKeys.push(key);
-						}
-					}
-				}
-				for (const key of deleteKeys) {
-					delete dataset[key];
-				}
-				return keys;
-			},
-			has(_dataset: IDataset, key: string): boolean {
-				return !!element[PropertySymbol.attributes].getNamedItem(
-					'data-' + DatasetUtility.camelCaseToKebab(key)
-				);
-			}
-		});
-	}
-}

package/src/nodes/element/DatasetUtility.ts

@@ -1,33 +0,0 @@
-/**
- * Dataset utility.
- *
- * Reference:
- * https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset
- */
-export default class DatasetUtility {
-	/**
-	 * Transforms a kebab cased string to camel case.
-	 *
-	 * @param text Text string.
-	 * @returns Camel cased string.
-	 */
-	public static kebabToCamelCase(text: string): string {
-		const parts = text.split('-');
-		for (let i = 0, max = parts.length; i < max; i++) {
-			parts[i] = i > 0 ? parts[i].charAt(0).toUpperCase() + parts[i].slice(1) : parts[i];
-		}
-		return parts.join('');
-	}
-
-	/**
-	 * Transforms a camel cased string to kebab case.
-	 *
-	 * @param text Text string.
-	 * @returns Kebab cased string.
-	 */
-	public static camelCaseToKebab(text: string): string {
-		return text
-			.toString()
-			.replace(/[A-Z]+(?![a-z])|[A-Z]/g, ($, ofs) => (ofs ? '-' : '') + $.toLowerCase());
-	}
-}