happy-dom 2.27.0 → 2.29.0

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

@@ -0,0 +1,221 @@
+import Node from '../node/Node';
+import CharacterDataUtility from './CharacterDataUtility';
+import ICharacterData from './ICharacterData';
+import IElement from '../element/IElement';
+import NonDocumentChildNodeUtility from '../child-node/NonDocumentChildNodeUtility';
+import ChildNodeUtility from '../child-node/ChildNodeUtility';
+import MutationRecord from '../../mutation-observer/MutationRecord';
+import MutationTypeEnum from '../../mutation-observer/MutationTypeEnum';
+
+/**
+ * Character data base class.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/CharacterData.
+ */
+export default abstract class CharacterData extends Node implements ICharacterData {
+	protected _data = '';
+
+	/**
+	 * Constructor.
+	 *
+	 * @param [data] Data.
+	 */
+	constructor(data?: string) {
+		super();
+
+		if (data) {
+			this._data = data;
+		}
+	}
+
+	/**
+	 * Returns text content.
+	 *
+	 * @returns Text content.
+	 */
+	public get length(): number {
+		return this._data.length;
+	}
+
+	/**
+	 * Returns text content.
+	 *
+	 * @returns Text content.
+	 */
+	public get data(): string {
+		return this._data;
+	}
+
+	/**
+	 * Sets text content.
+	 *
+	 * @param textContent Text content.
+	 */
+	public set data(data: string) {
+		const oldValue = this._data;
+		this._data = data;
+
+		// MutationObserver
+		if (this._observers.length > 0) {
+			for (const observer of this._observers) {
+				if (observer.options.characterData) {
+					const record = new MutationRecord();
+					record.type = MutationTypeEnum.characterData;
+					record.oldValue = observer.options.characterDataOldValue ? oldValue : null;
+					observer.callback([record]);
+				}
+			}
+		}
+	}
+
+	/**
+	 * Returns text content.
+	 *
+	 * @returns Text content.
+	 */
+	public get textContent(): string {
+		return this._data;
+	}
+
+	/**
+	 * Sets text content.
+	 *
+	 * @param textContent Text content.
+	 */
+	public set textContent(textContent: string) {
+		this.data = textContent;
+	}
+
+	/**
+	 * Returns node value.
+	 *
+	 * @returns Node value.
+	 */
+	public get nodeValue(): string {
+		return this._data;
+	}
+
+	/**
+	 * Sets node value.
+	 *
+	 * @param nodeValue Node value.
+	 */
+	public set nodeValue(nodeValue: string) {
+		this.textContent = nodeValue;
+	}
+
+	/**
+	 * Appends the given DOMString to the CharacterData.data string; when this method returns, data contains the concatenated DOMString.
+	 *
+	 * @param data Data.
+	 */
+	public appendData(data: string): void {
+		CharacterDataUtility.appendData(this, data);
+	}
+
+	/**
+	 * Removes the specified amount of characters, starting at the specified offset, from the CharacterData.data string; when this method returns, data contains the shortened DOMString.
+	 *
+	 * @param offset Offset.
+	 * @param count Count.
+	 */
+	public deleteData(offset: number, count: number): void {
+		CharacterDataUtility.deleteData(this, offset, count);
+	}
+
+	/**
+	 * Inserts the specified characters, at the specified offset, in the CharacterData.data string; when this method returns, data contains the modified DOMString.
+	 *
+	 * @param offset Offset.
+	 * @param data Data.
+	 */
+	public insertData(offset: number, data: string): void {
+		CharacterDataUtility.insertData(this, offset, data);
+	}
+
+	/**
+	 * Replaces the specified amount of characters, starting at the specified offset, with the specified DOMString; when this method returns, data contains the modified DOMString.
+	 *
+	 * @param offset Offset.
+	 * @param count Count.
+	 * @param data Data.
+	 */
+	public replaceData(offset: number, count: number, data: string): void {
+		CharacterDataUtility.replaceData(this, offset, count, data);
+	}
+
+	/**
+	 * Returns a DOMString containing the part of CharacterData.data of the specified length and starting at the specified offset.
+	 *
+	 * @param offset Offset.
+	 * @param count Count.
+	 */
+	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.
+	 */
+	public remove(): void {
+		ChildNodeUtility.remove(this);
+	}
+
+	/**
+	 * The Node.replaceWith() method replaces this Node in the children list of its parent with a set of Node or DOMString objects.
+	 *
+	 * @param nodes List of Node or DOMString.
+	 */
+	public replaceWith(...nodes: (Node | string)[]): void {
+		ChildNodeUtility.replaceWith(this, ...nodes);
+	}
+
+	/**
+	 * Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just before this ChildNode. DOMString objects are inserted as equivalent Text nodes.
+	 *
+	 * @param nodes List of Node or DOMString.
+	 */
+	public before(...nodes: (string | Node)[]): void {
+		ChildNodeUtility.before(this, ...nodes);
+	}
+
+	/**
+	 * Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just after this ChildNode. DOMString objects are inserted as equivalent Text nodes.
+	 *
+	 * @param nodes List of Node or DOMString.
+	 */
+	public after(...nodes: (string | Node)[]): void {
+		ChildNodeUtility.after(this, ...nodes);
+	}
+
+	/**
+	 * Clones a node.
+	 *
+	 * @override
+	 * @param [deep=false] "true" to clone deep.
+	 * @returns Cloned node.
+	 */
+	public cloneNode(deep = false): ICharacterData {
+		const clone = <CharacterData>super.cloneNode(deep);
+		clone._data = this._data;
+		return clone;
+	}
+}

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

@@ -1,7 +1,8 @@
+import INode from '../node/INode';
 import IChildNode from '../child-node/IChildNode';
 import INonDocumentTypeChildNode from '../child-node/INonDocumentTypeChildNode';
 
-export default interface ICharacterData extends IChildNode, INonDocumentTypeChildNode {
+export default interface ICharacterData extends INode, IChildNode, INonDocumentTypeChildNode {
 	data: string;
 	readonly length: number;
 
@@ -52,5 +53,5 @@ export default interface ICharacterData extends IChildNode, INonDocumentTypeChil
 	 * @param [deep=false] "true" to clone deep.
 	 * @returns Cloned node.
 	 */
-	cloneNode(deep: boolean): ICharacterData;
+	cloneNode(deep?: boolean): ICharacterData;
 }

package/src/nodes/comment/Comment.ts

@@ -1,31 +1,12 @@
 import Node from '../node/Node';
-import MutationRecord from '../../mutation-observer/MutationRecord';
-import MutationTypeEnum from '../../mutation-observer/MutationTypeEnum';
-import CharacterDataUtility from '../character-data/CharacterDataUtility';
-import IElement from '../element/IElement';
-import NonDocumentChildNodeUtility from '../child-node/NonDocumentChildNodeUtility';
-import ChildNodeUtility from '../child-node/ChildNodeUtility';
+import CharacterData from '../character-data/CharacterData';
 import IComment from './IComment';
 
 /**
  * Comment node.
  */
-export default class Comment extends Node implements IComment {
+export default class Comment extends CharacterData implements IComment {
 	public readonly nodeType = Node.COMMENT_NODE;
-	private _data = '';
-
-	/**
-	 * Constructor.
-	 *
-	 * @param [comment] Comment.
-	 */
-	constructor(comment?: string) {
-		super();
-
-		if (comment) {
-			this._data = comment;
-		}
-	}
 
 	/**
 	 * Node name.
@@ -36,100 +17,6 @@ export default class Comment extends Node implements IComment {
 		return '#comment';
 	}
 
-	/**
-	 * Returns text content.
-	 *
-	 * @returns Text content.
-	 */
-	public get length(): number {
-		return this._data.length;
-	}
-
-	/**
-	 * Returns text content.
-	 *
-	 * @returns Text content.
-	 */
-	public get data(): string {
-		return this._data;
-	}
-
-	/**
-	 * Sets text content.
-	 *
-	 * @param textContent Text content.
-	 */
-	public set data(data: string) {
-		const oldValue = this._data;
-		this._data = data;
-
-		// MutationObserver
-		if (this._observers.length > 0) {
-			for (const observer of this._observers) {
-				if (observer.options.characterData) {
-					const record = new MutationRecord();
-					record.type = MutationTypeEnum.characterData;
-					record.oldValue = observer.options.characterDataOldValue ? oldValue : null;
-					observer.callback([record]);
-				}
-			}
-		}
-	}
-
-	/**
-	 * Returns text content.
-	 *
-	 * @returns Text content.
-	 */
-	public get textContent(): string {
-		return this._data;
-	}
-
-	/**
-	 * Sets text content.
-	 *
-	 * @param textContent Text content.
-	 */
-	public set textContent(textContent: string) {
-		this.data = textContent;
-	}
-
-	/**
-	 * Returns node value.
-	 *
-	 * @returns Node value.
-	 */
-	public get nodeValue(): string {
-		return this._data;
-	}
-
-	/**
-	 * Sets node value.
-	 *
-	 * @param nodeValue Node value.
-	 */
-	public set nodeValue(nodeValue: string) {
-		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);
-	}
-
 	/**
 	 * Converts to string.
 	 *
@@ -139,90 +26,6 @@ export default class Comment extends Node implements IComment {
 		return '[object Comment]';
 	}
 
-	/**
-	 * Appends the given DOMString to the CharacterData.data string; when this method returns, data contains the concatenated DOMString.
-	 *
-	 * @param data Data.
-	 */
-	public appendData(data: string): void {
-		CharacterDataUtility.appendData(this, data);
-	}
-
-	/**
-	 * Removes the specified amount of characters, starting at the specified offset, from the CharacterData.data string; when this method returns, data contains the shortened DOMString.
-	 *
-	 * @param offset Offset.
-	 * @param count Count.
-	 */
-	public deleteData(offset: number, count: number): void {
-		CharacterDataUtility.deleteData(this, offset, count);
-	}
-
-	/**
-	 * Inserts the specified characters, at the specified offset, in the CharacterData.data string; when this method returns, data contains the modified DOMString.
-	 *
-	 * @param offset Offset.
-	 * @param data Data.
-	 */
-	public insertData(offset: number, data: string): void {
-		CharacterDataUtility.insertData(this, offset, data);
-	}
-
-	/**
-	 * Removes the object from its parent children list.
-	 */
-	public remove(): void {
-		ChildNodeUtility.remove(this);
-	}
-
-	/**
-	 * The Node.replaceWith() method replaces this Node in the children list of its parent with a set of Node or DOMString objects.
-	 *
-	 * @param nodes List of Node or DOMString.
-	 */
-	public replaceWith(...nodes: (Node | string)[]): void {
-		ChildNodeUtility.replaceWith(this, ...nodes);
-	}
-
-	/**
-	 * Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just before this ChildNode. DOMString objects are inserted as equivalent Text nodes.
-	 *
-	 * @param nodes List of Node or DOMString.
-	 */
-	public before(...nodes: (string | Node)[]): void {
-		ChildNodeUtility.before(this, ...nodes);
-	}
-
-	/**
-	 * Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just after this ChildNode. DOMString objects are inserted as equivalent Text nodes.
-	 *
-	 * @param nodes List of Node or DOMString.
-	 */
-	public after(...nodes: (string | Node)[]): void {
-		ChildNodeUtility.after(this, ...nodes);
-	}
-
-	/**
-	 * Replaces the specified amount of characters, starting at the specified offset, with the specified DOMString; when this method returns, data contains the modified DOMString.
-	 *
-	 * @param offset Offset.
-	 * @param count Count.
-	 * @param data Data.
-	 */
-	public replaceData(offset: number, count: number, data: string): void {
-		CharacterDataUtility.replaceData(this, offset, count, data);
-	}
-
-	/**
-	 * Returns a DOMString containing the part of CharacterData.data of the specified length and starting at the specified offset.
-	 *
-	 * @param offset Offset.
-	 * @param count Count.
-	 */
-	public substringData(offset: number, count: number): string {
-		return CharacterDataUtility.substringData(this, offset, count);
-	}
-
 	/**
 	 * Clones a node.
 	 *
@@ -231,8 +34,6 @@ export default class Comment extends Node implements IComment {
 	 * @returns Cloned node.
 	 */
 	public cloneNode(deep = false): IComment {
-		const clone = <Comment>super.cloneNode(deep);
-		clone._data = this._data;
-		return clone;
+		return <Comment>super.cloneNode(deep);
 	}
 }

package/src/nodes/comment/IComment.ts

@@ -8,5 +8,5 @@ export default interface IComment extends ICharacterData {
 	 * @param [deep=false] "true" to clone deep.
 	 * @returns Cloned node.
 	 */
-	cloneNode(deep: boolean): IComment;
+	cloneNode(deep?: boolean): IComment;
 }

package/src/nodes/document/Document.ts

@@ -24,7 +24,8 @@ import IElement from '../element/IElement';
 import IHTMLElement from '../html-element/IHTMLElement';
 import IDocumentType from '../document-type/IDocumentType';
 import INode from '../node/INode';
-import ICharacterData from '../character-data/ICharacterData';
+import IComment from '../comment/IComment';
+import IText from '../text/IText';
 import IDocumentFragment from '../document-fragment/IDocumentFragment';
 import INodeList from '../node/INodeList';
 import IHTMLCollection from '../element/IHTMLCollection';
@@ -578,7 +579,7 @@ export default class Document extends Node implements IDocument {
 	 * @param [data] Text data.
 	 * @returns Text node.
 	 */
-	public createTextNode(data?: string): ICharacterData {
+	public createTextNode(data?: string): IText {
 		Text.ownerDocument = this;
 		return new Text(data);
 	}
@@ -589,7 +590,7 @@ export default class Document extends Node implements IDocument {
 	 * @param [data] Text data.
 	 * @returns Text node.
 	 */
-	public createComment(data?: string): ICharacterData {
+	public createComment(data?: string): IComment {
 		Comment.ownerDocument = this;
 		return new Comment(data);
 	}

package/src/nodes/element/HTMLCollection.ts

@@ -0,0 +1,16 @@
+import IHTMLCollection from './IHTMLCollection';
+import INode from '../node/INode';
+
+/**
+ * Class list.
+ */
+export default class HTMLCollection extends Array implements IHTMLCollection<INode> {
+	/**
+	 * Returns item by index.
+	 *
+	 * @param index Index.
+	 */
+	public item(index: number): INode {
+		return index >= 0 && this[index] ? this[index] : null;
+	}
+}

package/src/nodes/html-style-element/HTMLStyleElement.ts

@@ -9,6 +9,8 @@ import IHTMLStyleElement from './IHTMLStyleElement';
  * https://developer.mozilla.org/en-US/docs/Web/API/HTMLStyleElement.
  */
 export default class HTMLStyleElement extends HTMLElement implements IHTMLStyleElement {
+	private _styleSheet: CSSStyleSheet | null = null;
+
 	/**
 	 * Returns CSS style sheet.
 	 *
@@ -18,9 +20,11 @@ export default class HTMLStyleElement extends HTMLElement implements IHTMLStyleE
 		if (!this.isConnected) {
 			return null;
 		}
-		const styleSheet = new CSSStyleSheet();
-		styleSheet.replaceSync(this.innerText);
-		return styleSheet;
+		if (!this._styleSheet) {
+			this._styleSheet = new CSSStyleSheet();
+			this._styleSheet.replaceSync(this.innerText);
+		}
+		return this._styleSheet;
 	}
 
 	/**

package/src/nodes/node/INode.ts

@@ -1,20 +1,21 @@
 import IEventTarget from '../../event/IEventTarget';
 import IDocument from '../document/IDocument';
 import IElement from '../element/IElement';
+import INodeList from './INodeList';
 
 export default interface INode extends IEventTarget {
 	readonly ownerDocument: IDocument;
 	readonly parentNode: INode;
 	readonly parentElement: IElement;
 	readonly nodeType: number;
-	readonly childNodes: INode[];
+	readonly childNodes: INodeList<INode>;
 	readonly isConnected: boolean;
-	readonly nodeValue: string;
 	readonly nodeName: string;
 	readonly previousSibling: INode;
 	readonly nextSibling: INode;
 	readonly firstChild: INode;
 	readonly lastChild: INode;
+	nodeValue: string;
 	textContent: string;
 	connectedCallback?(): void;
 	disconnectedCallback?(): void;

package/src/nodes/node/Node.ts

@@ -67,6 +67,13 @@ export default class Node extends EventTarget implements INode {
 		return null;
 	}
 
+	/**
+	 * Sets node value.
+	 */
+	public set nodeValue(_nodeValue: string) {
+		// Do nothing
+	}
+
 	/**
 	 * Node name.
 	 *

package/src/nodes/node/NodeList.ts

@@ -0,0 +1,16 @@
+import INodeList from './INodeList';
+import INode from './INode';
+
+/**
+ * Class list.
+ */
+export default class NodeList extends Array implements INodeList<INode> {
+	/**
+	 * Returns item by index.
+	 *
+	 * @param index Index.
+	 */
+	public item(index: number): INode {
+		return index >= 0 && this[index] ? this[index] : null;
+	}
+}

package/src/nodes/text/IText.ts

@@ -8,5 +8,5 @@ export default interface IText extends ICharacterData {
 	 * @param [deep=false] "true" to clone deep.
 	 * @returns Cloned node.
 	 */
-	cloneNode(deep: boolean): IText;
+	cloneNode(deep?: boolean): IText;
 }