happy-dom 7.6.6 → 7.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "happy-dom",
-	"version": "7.6.6",
+	"version": "7.7.0",
 	"license": "MIT",
 	"homepage": "https://github.com/capricorn86/happy-dom",
 	"repository": "https://github.com/capricorn86/happy-dom",
@@ -75,5 +75,5 @@
 		"ts-jest": "^27.1.3",
 		"typescript": "^4.6.2"
 	},
-	"gitHead": "e4072902f23440d68bd104027b65bf67685d4396"
+	"gitHead": "9eb21a6f922278fe17ff2d4b99f2a2898fe2053f"
 }

package/src/config/ElementTag.ts

@@ -20,9 +20,10 @@ import HTMLDialogElement from '../nodes/html-dialog-element/HTMLDialogElement';
 import HTMLButtonElement from '../nodes/html-button-element/HTMLButtonElement';
 import HTMLAudioElement from '../nodes/html-audio-element/HTMLAudioElement';
 import HTMLVideoElement from '../nodes/html-video-element/HTMLVideoElement';
+import HTMLAnchorElement from '../nodes/html-anchor-element/HTMLAnchorElement';
 
 export default {
-	A: HTMLElement,
+	A: HTMLAnchorElement,
 	ABBR: HTMLElement,
 	ADDRESS: HTMLElement,
 	AREA: HTMLElement,

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

@@ -199,7 +199,7 @@ export default class DOMTokenList implements IDOMTokenList {
 	 * Updates indices.
 	 */
 	public _updateIndices(): void {
-		const attr = this._ownerElement.getAttribute('class');
+		const attr = this._ownerElement.getAttribute(this._attributeName);
 		const list = attr ? Array.from(new Set(attr.split(' '))) : [];
 
 		for (let i = list.length - 1, max = this.length; i < max; i++) {

package/src/nodes/element/Element.ts

@@ -840,7 +840,9 @@ export default class Element extends Node implements IElement {
 
 		this._attributes[name] = attribute;
 
-		this._updateDomListIndices();
+		if (attribute.name === 'class' && this._classList) {
+			this._classList._updateIndices();
+		}
 
 		if (
 			this.attributeChangedCallback &&
@@ -936,7 +938,9 @@ export default class Element extends Node implements IElement {
 			this.ownerDocument['_cacheID']++;
 		}
 
-		this._updateDomListIndices();
+		if (attribute.name === 'class' && this._classList) {
+			this._classList._updateIndices();
+		}
 
 		if (
 			this.attributeChangedCallback &&
@@ -1033,13 +1037,4 @@ 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/html-anchor-element/HTMLAnchorElement.ts

@@ -0,0 +1,439 @@
+import HTMLElement from '../html-element/HTMLElement';
+import DOMTokenList from '../../dom-token-list/DOMTokenList';
+import IDOMTokenList from '../../dom-token-list/IDOMTokenList';
+import IHTMLAnchorElement from './IHTMLAnchorElement';
+import { URL } from 'url';
+import IAttr from '../attr/IAttr';
+import HTMLAnchorElementUtility from './HTMLAnchorElementUtility';
+
+/**
+ * HTML Anchor Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement.
+ */
+export default class HTMLAnchorElement extends HTMLElement implements IHTMLAnchorElement {
+	private _relList: DOMTokenList = null;
+	private _url: URL | null = null;
+
+	/**
+	 * Returns download.
+	 *
+	 * @returns download.
+	 */
+	public get download(): string {
+		return this.getAttribute('download') || '';
+	}
+
+	/**
+	 * Sets download.
+	 *
+	 * @param download Download.
+	 */
+	public set download(download: string) {
+		this.setAttributeNS(null, 'download', download);
+	}
+
+	/**
+	 * Returns hash.
+	 *
+	 * @returns Hash.
+	 */
+	public get hash(): string {
+		return this._url?.hash ?? '';
+	}
+
+	/**
+	 * Sets hash.
+	 *
+	 * @param hash Hash.
+	 */
+	public set hash(hash: string) {
+		if (this._url && !HTMLAnchorElementUtility.isBlobURL(this._url)) {
+			this._url.hash = hash;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns href.
+	 *
+	 * @returns Href.
+	 */
+	public get href(): string | null {
+		if (this._url) {
+			return this._url.toString();
+		}
+
+		return this.getAttributeNS(null, 'href') || '';
+	}
+
+	/**
+	 * Sets href.
+	 *
+	 * @param href Href.
+	 */
+	public set href(href: string) {
+		this.setAttributeNS(null, 'href', href);
+	}
+
+	/**
+	 * Returns hreflang.
+	 *
+	 * @returns Hreflang.
+	 */
+	public get hreflang(): string {
+		return this.getAttributeNS(null, 'hreflang') || '';
+	}
+
+	/**
+	 * Sets hreflang.
+	 *
+	 * @param hreflang Hreflang.
+	 */
+	public set hreflang(hreflang: string) {
+		this.setAttributeNS(null, 'hreflang', hreflang);
+	}
+
+	/**
+	 * Returns the hyperlink's URL's origin.
+	 *
+	 * @returns Origin.
+	 */
+	public get origin(): string {
+		return this._url?.origin ?? '';
+	}
+
+	/**
+	 * Returns ping.
+	 *
+	 * @returns Ping.
+	 */
+	public get ping(): string {
+		return this.getAttributeNS(null, 'ping') || '';
+	}
+
+	/**
+	 * Sets ping.
+	 *
+	 * @param ping Ping.
+	 */
+	public set ping(ping: string) {
+		this.setAttributeNS(null, 'ping', ping);
+	}
+
+	/**
+	 * Returns protocol.
+	 *
+	 * @returns Protocol.
+	 */
+	public get protocol(): string {
+		return this._url?.protocol ?? '';
+	}
+
+	/**
+	 * Sets protocol.
+	 *
+	 * @param protocol Protocol.
+	 */
+	public set protocol(protocol: string) {
+		if (this._url && !HTMLAnchorElementUtility.isBlobURL(this._url)) {
+			this._url.protocol = protocol;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns username.
+	 *
+	 * @returns Username.
+	 */
+	public get username(): string {
+		return this._url?.username ?? '';
+	}
+
+	/**
+	 * Sets username.
+	 *
+	 * @param username Username.
+	 */
+	public set username(username: string) {
+		if (
+			this._url &&
+			!HTMLAnchorElementUtility.isBlobURL(this._url) &&
+			this._url.host &&
+			this._url.protocol != 'file'
+		) {
+			this._url.username = username;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns password.
+	 *
+	 * @returns Password.
+	 */
+	public get password(): string {
+		return this._url?.password ?? '';
+	}
+
+	/**
+	 * Sets password.
+	 *
+	 * @param password Password.
+	 */
+	public set password(password: string) {
+		if (
+			this._url &&
+			!HTMLAnchorElementUtility.isBlobURL(this._url) &&
+			this._url.host &&
+			this._url.protocol != 'file'
+		) {
+			this._url.password = password;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns pathname.
+	 *
+	 * @returns Pathname.
+	 */
+	public get pathname(): string {
+		return this._url?.pathname ?? '';
+	}
+
+	/**
+	 * Sets pathname.
+	 *
+	 * @param pathname Pathname.
+	 */
+	public set pathname(pathname: string) {
+		if (this._url && !HTMLAnchorElementUtility.isBlobURL(this._url)) {
+			this._url.pathname = pathname;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns port.
+	 *
+	 * @returns Port.
+	 */
+	public get port(): string {
+		return this._url?.port ?? '';
+	}
+
+	/**
+	 * Sets port.
+	 *
+	 * @param port Port.
+	 */
+	public set port(port: string) {
+		if (
+			this._url &&
+			!HTMLAnchorElementUtility.isBlobURL(this._url) &&
+			this._url.host &&
+			this._url.protocol != 'file'
+		) {
+			this._url.port = port;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns host.
+	 *
+	 * @returns Host.
+	 */
+	public get host(): string {
+		return this._url?.host ?? '';
+	}
+
+	/**
+	 * Sets host.
+	 *
+	 * @param host Host.
+	 */
+	public set host(host: string) {
+		if (this._url && !HTMLAnchorElementUtility.isBlobURL(this._url)) {
+			this._url.host = host;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns hostname.
+	 *
+	 * @returns Hostname.
+	 */
+	public get hostname(): string {
+		return this._url?.hostname ?? '';
+	}
+
+	/**
+	 * Sets hostname.
+	 *
+	 * @param hostname Hostname.
+	 */
+	public set hostname(hostname: string) {
+		if (this._url && !HTMLAnchorElementUtility.isBlobURL(this._url)) {
+			this._url.hostname = hostname;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns referrerPolicy.
+	 *
+	 * @returns Referrer Policy.
+	 */
+	public get referrerPolicy(): string {
+		return this.getAttributeNS(null, 'referrerPolicy') || '';
+	}
+
+	/**
+	 * Sets referrerPolicy.
+	 *
+	 * @param referrerPolicy Referrer Policy.
+	 */
+	public set referrerPolicy(referrerPolicy: string) {
+		this.setAttributeNS(null, 'referrerPolicy', referrerPolicy);
+	}
+
+	/**
+	 * Returns rel.
+	 *
+	 * @returns Rel.
+	 */
+	public get rel(): string {
+		return this.getAttributeNS(null, 'rel') || '';
+	}
+
+	/**
+	 * Sets rel.
+	 *
+	 * @param rel Rel.
+	 */
+	public set rel(rel: string) {
+		this.setAttributeNS(null, 'rel', rel);
+	}
+
+	/**
+	 * Returns rel list.
+	 *
+	 * @returns Rel list.
+	 */
+	public get relList(): IDOMTokenList {
+		if (!this._relList) {
+			this._relList = new DOMTokenList(this, 'rel');
+		}
+		return <IDOMTokenList>this._relList;
+	}
+
+	/**
+	 * Returns search.
+	 *
+	 * @returns Search.
+	 */
+	public get search(): string {
+		return this._url?.search ?? '';
+	}
+
+	/**
+	 * Sets search.
+	 *
+	 * @param search Search.
+	 */
+	public set search(search: string) {
+		if (this._url && !HTMLAnchorElementUtility.isBlobURL(this._url)) {
+			this._url.search = search;
+			this.setAttributeNS(null, 'href', this._url.toString());
+		}
+	}
+
+	/**
+	 * Returns target.
+	 *
+	 * @returns target.
+	 */
+	public get target(): string {
+		return this.getAttributeNS(null, 'target') || '';
+	}
+
+	/**
+	 * Sets target.
+	 *
+	 * @param target Target.
+	 */
+	public set target(target: string) {
+		this.setAttributeNS(null, 'target', target);
+	}
+
+	/**
+	 * Returns text.
+	 *
+	 * @returns text.
+	 */
+	public get text(): string {
+		return this.textContent;
+	}
+
+	/**
+	 * Sets text.
+	 *
+	 * @param text Text.
+	 */
+	public set text(text: string) {
+		this.textContent = text;
+	}
+
+	/**
+	 * Returns type.
+	 *
+	 * @returns Type.
+	 */
+	public get type(): string {
+		return this.getAttributeNS(null, 'type') || '';
+	}
+
+	/**
+	 * Sets type.
+	 *
+	 * @param type Type.
+	 */
+	public set type(type: string) {
+		this.setAttributeNS(null, 'type', type);
+	}
+
+	/**
+	 * @override
+	 */
+	public override setAttributeNode(attribute: IAttr): IAttr {
+		const replacedAttribute = super.setAttributeNode(attribute);
+
+		if (attribute.name === 'rel' && this._relList) {
+			this._relList._updateIndices();
+		} else if (attribute.name === 'href') {
+			this._url = HTMLAnchorElementUtility.getUrl(this.ownerDocument, attribute.value);
+		}
+
+		return replacedAttribute;
+	}
+
+	/**
+	 * @override
+	 */
+	public override removeAttributeNode(attribute: IAttr): IAttr {
+		super.removeAttributeNode(attribute);
+
+		if (attribute.name === 'rel' && this._relList) {
+			this._relList._updateIndices();
+		} else if (attribute.name === 'href') {
+			this._url = null;
+		}
+
+		return attribute;
+	}
+}

package/src/nodes/html-anchor-element/HTMLAnchorElementUtility.ts

@@ -0,0 +1,48 @@
+import IDocument from '../document/IDocument';
+import { URL } from 'url';
+
+/**
+ * HTML Anchor Element utility.
+ */
+export default class HTMLAnchorElementUtility {
+	/**
+	 * Returns "true" if it is a blob URL.
+	 *
+	 * According to spec, if element's url is non-null, its scheme is "blob", and it has an opaque path, then the process of updating properties on the URL should be terminated.
+	 *
+	 * @see https://html.spec.whatwg.org/multipage/links.html#reinitialise-url
+	 * @param url
+	 * @param url URL.
+	 * @returns "true" if blob URL.
+	 */
+	public static isBlobURL(url: URL): boolean {
+		return (
+			url && url.protocol === 'blob:' && url.pathname.length > 1 && url.pathname.includes('://')
+		);
+	}
+
+	/**
+	 * Returns URL.
+	 *
+	 * @see https://html.spec.whatwg.org/multipage/links.html#dom-hyperlink-href
+	 * @see https://html.spec.whatwg.org/multipage/links.html#hyperlink
+	 * @param document Document.
+	 * @param href Href.
+	 * @returns URL.
+	 */
+	public static getUrl(document: IDocument, href: string | null): URL {
+		if (!href) {
+			return null;
+		}
+
+		const documentUrl = document.location.href;
+
+		try {
+			return new URL(href.trim(), documentUrl);
+		} catch (TypeError) {
+			// Ignore error
+		}
+
+		return null;
+	}
+}

package/src/nodes/html-anchor-element/IHTMLAnchorElement.ts

@@ -0,0 +1,21 @@
+import IDOMTokenList from '../../dom-token-list/IDOMTokenList';
+import IHTMLElement from '../html-element/IHTMLElement';
+import IHTMLHyperlinkElementUtils from './IHTMLHyperlinkElementUtils';
+
+/**
+ * HTML Anchor Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement.
+ */
+export default interface IHTMLAnchorElement extends IHTMLElement, IHTMLHyperlinkElementUtils {
+	readonly relList: IDOMTokenList;
+	download: string;
+	ping: string;
+	hreflang: string;
+	referrerPolicy: string;
+	rel: string;
+	target: string;
+	text: string;
+	type: string;
+}

package/src/nodes/html-anchor-element/IHTMLHyperlinkElementUtils.ts

@@ -0,0 +1,19 @@
+/**
+ * HTMLHyperlinkElementUtils.
+ *
+ * Reference:
+ * https://html.spec.whatwg.org/multipage/links.html#htmlhyperlinkelementutils.
+ */
+export default interface IHTMLHyperlinkElementUtils {
+	readonly origin: string;
+	href: string;
+	protocol: string;
+	username: string;
+	password: string;
+	host: string;
+	hostname: string;
+	port: string;
+	pathname: string;
+	search: string;
+	hash: string;
+}

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

@@ -180,17 +180,17 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 	}
 
 	/**
-	 * The setAttributeNode() method adds a new Attr node to the specified element.
-	 *
 	 * @override
-	 * @param attribute Attribute.
-	 * @returns Replaced attribute.
 	 */
-	public setAttributeNode(attribute: IAttr): IAttr {
+	public override setAttributeNode(attribute: IAttr): IAttr {
 		const replacedAttribute = super.setAttributeNode(attribute);
 		const rel = this.getAttributeNS(null, 'rel');
 		const href = this.getAttributeNS(null, 'href');
 
+		if (attribute.name === 'rel' && this._relList) {
+			this._relList._updateIndices();
+		}
+
 		if (
 			(attribute.name === 'rel' || attribute.name === 'href') &&
 			href !== null &&
@@ -233,6 +233,19 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 		return replacedAttribute;
 	}
 
+	/**
+	 * @override
+	 */
+	public override removeAttributeNode(attribute: IAttr): IAttr {
+		super.removeAttributeNode(attribute);
+
+		if (attribute.name === 'rel' && this._relList) {
+			this._relList._updateIndices();
+		}
+
+		return attribute;
+	}
+
 	/**
 	 * @override
 	 */
@@ -280,15 +293,4 @@ 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-option-element/HTMLOptionElement.ts

@@ -109,7 +109,7 @@ export default class HTMLOptionElement extends HTMLElement implements IHTMLOptio
 	 * @returns Value.
 	 */
 	public get value(): string {
-		return this.getAttributeNS(null, 'value') || '';
+		return this.getAttributeNS(null, 'value') || this.textContent;
 	}
 
 	/**