happy-dom 2.28.0 → 2.31.0

package/src/nodes/html-slot-element/HTMLSlotElement.ts

@@ -0,0 +1,110 @@
+import HTMLElement from '../html-element/HTMLElement';
+import IShadowRoot from '../shadow-root/IShadowRoot';
+import IHTMLSlotElement from './IHTMLSlotElement';
+import IText from '../text/IText';
+import IElement from '../element/IElement';
+import INode from '../node/INode';
+
+/**
+ * HTML Slot Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLSlotElement.
+ */
+export default class HTMLSlotElement extends HTMLElement implements IHTMLSlotElement {
+	/**
+	 * Returns name.
+	 *
+	 * @returns Name.
+	 */
+	public get name(): string {
+		return this.getAttributeNS(null, 'name') || '';
+	}
+
+	/**
+	 * Sets name.
+	 *
+	 * @param name Name.
+	 */
+	public set name(name: string) {
+		this.setAttributeNS(null, 'name', name);
+	}
+
+	/**
+	 * Sets the slot's manually assigned nodes to an ordered set of slottables.
+	 *
+	 * @param _nodes Nodes.
+	 */
+	public assign(..._nodes: Array<IText | IElement>): void {
+		// TODO: Do nothing for now. We need to find an example of how it is expected to work before it can be implemented.
+	}
+
+	/**
+	 * Returns assigned nodes.
+	 *
+	 * @param [options] Options.
+	 * @param [options.flatten] A boolean value indicating whether to return the assigned nodes of any available child <slot> elements (true) or not (false). Defaults to false.
+	 * @returns Nodes.
+	 */
+	public assignedNodes(options?: { flatten?: boolean }): INode[] {
+		const host = (<IShadowRoot>this.getRootNode())?.host;
+
+		// TODO: Add support for options.flatten. We need to find an example of how it is expected to work before it can be implemented.
+
+		if (host) {
+			const name = this.name;
+
+			if (name) {
+				return this.assignedElements(options);
+			}
+
+			return host.childNodes.slice();
+		}
+
+		return [];
+	}
+
+	/**
+	 * Returns assigned elements.
+	 *
+	 * @param [_options] Options.
+	 * @param [_options.flatten] A boolean value indicating whether to return the assigned elements of any available child <slot> elements (true) or not (false). Defaults to false.
+	 * @returns Nodes.
+	 */
+	public assignedElements(_options?: { flatten?: boolean }): IElement[] {
+		const host = (<IShadowRoot>this.getRootNode())?.host;
+
+		// TODO: Add support for options.flatten. We need to find an example of how it expected to work before it can be implemented.
+
+		if (host) {
+			const name = this.name;
+
+			if (name) {
+				const assignedElements = [];
+
+				for (const child of host.children) {
+					if (child.slot === name) {
+						assignedElements.push(child);
+					}
+				}
+
+				return assignedElements;
+			}
+
+			return host.children.slice();
+		}
+
+		return [];
+	}
+
+	/**
+	 * Clones a node.
+	 *
+	 * @override
+	 * @param [deep=false] "true" to clone deep.
+	 * @returns Cloned node.
+	 */
+	public cloneNode(deep = false): IHTMLSlotElement {
+		return <HTMLSlotElement>super.cloneNode(deep);
+	}
+}

package/src/nodes/html-slot-element/IHTMLSlotElement.ts

@@ -0,0 +1,47 @@
+import IHTMLElement from '../html-element/IHTMLElement';
+import IText from '../text/IText';
+import IElement from '../element/IElement';
+import INode from '../node/INode';
+
+/**
+ * HTML Slot Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLSlotElement.
+ */
+export default interface IHTMLSlotElement extends IHTMLElement {
+	name: string;
+
+	/**
+	 * Sets the slot's manually assigned nodes to an ordered set of slottables.
+	 *
+	 * @param nodes Nodes.
+	 */
+	assign(...nodes: Array<IText | IElement>): void;
+
+	/**
+	 * Returns assigned nodes.
+	 *
+	 * @param [options] Options.
+	 * @param [options.flatten] A boolean value indicating whether to return the assigned nodes of any available child <slot> elements (true) or not (false). Defaults to false.
+	 * @returns Nodes.
+	 */
+	assignedNodes(options?: { flatten?: boolean }): INode[];
+
+	/**
+	 * Returns assigned nodes.
+	 *
+	 * @param [options.flatten] A boolean value indicating whether to return the assigned elements of any available child <slot> elements (true) or not (false). Defaults to false.
+	 * @returns Nodes.
+	 */
+	assignedElements(options?: { flatten?: boolean }): IElement[];
+
+	/**
+	 * Clones a node.
+	 *
+	 * @override
+	 * @param [deep=false] "true" to clone deep.
+	 * @returns Cloned node.
+	 */
+	cloneNode(deep: boolean): IHTMLSlotElement;
+}

package/src/nodes/node/INode.ts

@@ -1,13 +1,14 @@
 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 nodeName: string;
 	readonly previousSibling: INode;

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/window/IWindow.ts

@@ -18,6 +18,7 @@ import SVGElement from '../nodes/svg-element/SVGElement';
 import HTMLScriptElement from '../nodes/html-script-element/HTMLScriptElement';
 import HTMLImageElement from '../nodes/html-image-element/HTMLImageElement';
 import DocumentFragment from '../nodes/document-fragment/DocumentFragment';
+import CharacterData from '../nodes/character-data/CharacterData';
 import TreeWalker from '../tree-walker/TreeWalker';
 import Event from '../event/Event';
 import CustomEvent from '../event/events/CustomEvent';
@@ -38,6 +39,7 @@ import DOMException from '../exception/DOMException';
 import FileReader from '../file/FileReader';
 import History from '../history/History';
 import CSSStyleDeclaration from '../css/CSSStyleDeclaration';
+import PointerEvent from '../event/events/PointerEvent';
 import MouseEvent from '../event/events/MouseEvent';
 import FocusEvent from '../event/events/FocusEvent';
 import WheelEvent from '../event/events/WheelEvent';
@@ -47,6 +49,7 @@ import DataTransferItemList from '../event/DataTransferItemList';
 import InputEvent from '../event/events/InputEvent';
 import UIEvent from '../event/UIEvent';
 import ErrorEvent from '../event/events/ErrorEvent';
+import StorageEvent from '../event/events/StorageEvent';
 import Screen from '../screen/Screen';
 import AsyncTaskManager from './AsyncTaskManager';
 import IResponse from './IResponse';
@@ -56,6 +59,9 @@ import HTMLStyleElement from '../nodes/html-style-element/HTMLStyleElement';
 import IFetchOptions from './IFetchOptions';
 import NodeFilter from '../tree-walker/NodeFilter';
 import Window from './Window';
+import URLSearchParams from '../url-search-params/URLSearchParams';
+import HTMLCollection from '../nodes/element/HTMLCollection';
+import NodeList from '../nodes/node/NodeList';
 
 /**
  * Window.
@@ -86,6 +92,7 @@ export default interface IWindow {
 	readonly ShadowRoot: typeof ShadowRoot;
 	readonly Element: typeof Element;
 	readonly DocumentFragment: typeof DocumentFragment;
+	readonly CharacterData: typeof CharacterData;
 	readonly NodeFilter: typeof NodeFilter;
 	readonly TreeWalker: typeof TreeWalker;
 	readonly DOMParser: typeof DOMParser;
@@ -99,11 +106,13 @@ export default interface IWindow {
 	readonly CustomEvent: typeof CustomEvent;
 	readonly AnimationEvent: typeof AnimationEvent;
 	readonly KeyboardEvent: typeof KeyboardEvent;
+	readonly PointerEvent: typeof PointerEvent;
 	readonly MouseEvent: typeof MouseEvent;
 	readonly FocusEvent: typeof FocusEvent;
 	readonly WheelEvent: typeof WheelEvent;
 	readonly InputEvent: typeof InputEvent;
 	readonly ErrorEvent: typeof ErrorEvent;
+	readonly StorageEvent: typeof StorageEvent;
 	readonly ProgressEvent: typeof ProgressEvent;
 	readonly EventTarget: typeof EventTarget;
 	readonly DataTransfer: typeof DataTransfer;
@@ -124,6 +133,9 @@ export default interface IWindow {
 	readonly History: typeof History;
 	readonly Screen: typeof Screen;
 	readonly Storage: typeof Storage;
+	readonly URLSearchParams: typeof URLSearchParams;
+	readonly HTMLCollection: typeof HTMLCollection;
+	readonly NodeList: typeof NodeList;
 
 	// Events
 	onload: (event: Event) => void;

package/src/window/Window.ts

@@ -52,6 +52,7 @@ import DataTransferItemList from '../event/DataTransferItemList';
 import InputEvent from '../event/events/InputEvent';
 import UIEvent from '../event/UIEvent';
 import ErrorEvent from '../event/events/ErrorEvent';
+import StorageEvent from '../event/events/StorageEvent';
 import Screen from '../screen/Screen';
 import AsyncTaskManager from './AsyncTaskManager';
 import IResponse from './IResponse';
@@ -63,6 +64,8 @@ import HTMLStyleElement from '../nodes/html-style-element/HTMLStyleElement';
 import IFetchOptions from './IFetchOptions';
 import IWindow from './IWindow';
 import URLSearchParams from '../url-search-params/URLSearchParams';
+import HTMLCollection from '../nodes/element/HTMLCollection';
+import NodeList from '../nodes/node/NodeList';
 
 const FETCH_RESPONSE_TYPE_METHODS = ['blob', 'json', 'text'];
 
@@ -119,6 +122,7 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 	public readonly WheelEvent = WheelEvent;
 	public readonly InputEvent = InputEvent;
 	public readonly ErrorEvent = ErrorEvent;
+	public readonly StorageEvent = StorageEvent;
 	public readonly ProgressEvent = ProgressEvent;
 	public readonly EventTarget = EventTarget;
 	public readonly DataTransfer = DataTransfer;
@@ -140,6 +144,8 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 	public readonly Screen = Screen;
 	public readonly Storage = Storage;
 	public readonly URLSearchParams = URLSearchParams;
+	public readonly HTMLCollection = HTMLCollection;
+	public readonly NodeList = NodeList;
 
 	// Events
 	public onload: (event: Event) => void = null;