happy-dom 14.12.3 → 15.1.0

package/src/nodes/html-media-element/TimeRanges.ts

@@ -0,0 +1,73 @@
+import * as PropertySymbol from '../../PropertySymbol.js';
+
+/**
+ * When loading a media resource for use by an <audio> or <video> element, the TimeRanges interface is used for representing the time ranges of the media resource that have been buffered, the time ranges that have been played, and the time ranges that are seekable.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/TimeRanges
+ */
+export default class TimeRanges {
+	/**
+	 * Constructor.
+	 *
+	 * @param [illegalConstructorSymbol] Illegal constructor symbol.
+	 */
+	constructor(illegalConstructorSymbol?: symbol) {
+		if (illegalConstructorSymbol !== PropertySymbol.illegalConstructor) {
+			throw new TypeError('Illegal constructor');
+		}
+	}
+
+	/**
+	 * Returns length.
+	 */
+	public get length(): number {
+		return 0;
+	}
+
+	/**
+	 * Returns `Symbol.toStringTag`.
+	 *
+	 * @returns `Symbol.toStringTag`.
+	 */
+	public get [Symbol.toStringTag](): string {
+		return 'TimeRanges';
+	}
+
+	/**
+	 * Returns `[object NodeList]`.
+	 *
+	 * @returns `[object NodeList]`.
+	 */
+	public toLocaleString(): string {
+		return '[object TimeRanges]';
+	}
+
+	/**
+	 * Returns `[object NodeList]`.
+	 *
+	 * @returns `[object NodeList]`.
+	 */
+	public toString(): string {
+		return '[object TimeRanges]';
+	}
+
+	/**
+	 * Returns start.
+	 *
+	 * @param _index Index.
+	 * @returns Start.
+	 */
+	public start(_index: number): number {
+		return 0;
+	}
+
+	/**
+	 * Returns end.
+	 *
+	 * @param _index Index.
+	 * @returns End.
+	 */
+	public end(_index: number): number {
+		return 0;
+	}
+}

package/src/nodes/html-media-element/VTTCue.ts

@@ -0,0 +1,80 @@
+import DocumentFragment from '../document-fragment/DocumentFragment.js';
+import TextTrackCue from './TextTrackCue.js';
+import VTTRegion from './VTTRegion.js';
+import * as PropertySymbol from '../../PropertySymbol.js';
+
+/**
+ * VTTCue.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/VTTCue
+ */
+export default class VTTCue extends TextTrackCue {
+	public region: VTTRegion | null = null;
+	public vertical: string = '';
+	public snapToLines: boolean = true;
+	public line: number = 0;
+	public lineAlign: string = '';
+	public position: string = 'auto';
+	public positionAlign: string = 'auto';
+	public size: number = 100;
+	public align: string = '';
+	public text: string = '';
+
+	/**
+	 * Constructor.
+	 *
+	 * @param startTime The start time for the cue.
+	 * @param endTime The end time for the cue.
+	 * @param text The text of the cue.
+	 */
+	constructor(startTime: number, endTime: number, text: string) {
+		super(PropertySymbol.illegalConstructor);
+
+		const window = this[PropertySymbol.window];
+
+		// TODO: Can we find a better solution for counting arguments by using the "arguments" property?
+
+		let argumentCount = 0;
+
+		if (startTime !== undefined) {
+			argumentCount++;
+		}
+		if (endTime !== undefined) {
+			argumentCount++;
+		}
+		if (text !== undefined) {
+			argumentCount++;
+		}
+
+		if (argumentCount < 3) {
+			throw new window.TypeError(
+				`Failed to construct 'VTTCue': 3 arguments required, but only ${argumentCount} present.`
+			);
+		}
+
+		startTime = Number(startTime);
+		endTime = Number(endTime);
+
+		if (isNaN(startTime) || isNaN(endTime)) {
+			throw new window.TypeError(
+				`Failed to construct 'VTTCue': The provided double value is non-finite.`
+			);
+		}
+
+		this.startTime = startTime;
+		this.endTime = endTime;
+		this.text = String(text);
+	}
+
+	/**
+	 * Returns the cue as HTML.
+	 *
+	 * @returns DocumentFragment
+	 */
+	public getCueAsHTML(): DocumentFragment {
+		const window = this[PropertySymbol.window];
+		const fragment = window.document.createDocumentFragment();
+		fragment.appendChild(window.document.createTextNode(this.text));
+		return fragment;
+	}
+}

package/src/nodes/html-media-element/VTTRegion.ts

@@ -0,0 +1,15 @@
+/**
+ * VTTRegion.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/VTTRegion
+ */
+export default class VTTRegion {
+	public id: string = '';
+	public width: number = 100;
+	public lines: number = 3;
+	public regionAnchorX: number = 0;
+	public regionAnchorY: number = 100;
+	public viewportAnchorX: number = 0;
+	public viewportAnchorY: number = 100;
+	public scroll: string = 'none';
+}

package/src/nodes/html-menu-element/HTMLMenuElement.ts

@@ -0,0 +1,7 @@
+import HTMLElement from '../html-element/HTMLElement.js';
+/**
+ * HTMLMenuElement
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLMenuElement
+ */
+export default class HTMLMenuElement extends HTMLElement {}

package/src/nodes/html-meter-element/HTMLMeterElement.ts

@@ -0,0 +1,210 @@
+import HTMLElement from '../html-element/HTMLElement.js';
+import HTMLLabelElement from '../html-label-element/HTMLLabelElement.js';
+import HTMLLabelElementUtility from '../html-label-element/HTMLLabelElementUtility.js';
+import NodeList from '../node/NodeList.js';
+import * as PropertySymbol from '../../PropertySymbol.js';
+
+/**
+ * HTMLMeterElement
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLMeterElement
+ */
+export default class HTMLMeterElement extends HTMLElement {
+	/**
+	 * Returns high.
+	 *
+	 * @returns High.
+	 */
+	public get high(): number {
+		if (!this.hasAttribute('high')) {
+			return 1;
+		}
+		const parsedValue = parseFloat(this.getAttribute('high') || '');
+		if (isNaN(parsedValue) || parsedValue > 1) {
+			return 1;
+		}
+		return parsedValue < 0 ? 0 : parsedValue;
+	}
+
+	/**
+	 * Sets high.
+	 *
+	 * @param high High.
+	 */
+	public set high(high: number) {
+		if (typeof high !== 'number') {
+			throw new this[PropertySymbol.window].TypeError(
+				"Failed to set the 'high' property on 'HTMLMeterElement': The provided double value is non-finite."
+			);
+		}
+
+		this.setAttribute('high', String(high));
+	}
+
+	/**
+	 * Returns low.
+	 *
+	 * @returns Low.
+	 */
+	public get low(): number {
+		if (!this.hasAttribute('low')) {
+			return 0;
+		}
+		const parsedValue = parseFloat(this.getAttribute('low') || '');
+		if (isNaN(parsedValue) || parsedValue < 0) {
+			return 0;
+		}
+		return parsedValue > 1 ? 1 : parsedValue;
+	}
+
+	/**
+	 * Sets low.
+	 *
+	 * @param low Low.
+	 */
+	public set low(low: number) {
+		if (typeof low !== 'number') {
+			throw new this[PropertySymbol.window].TypeError(
+				"Failed to set the 'low' property on 'HTMLMeterElement': The provided double value is non-finite."
+			);
+		}
+
+		this.setAttribute('low', String(low));
+	}
+
+	/**
+	 * Returns max.
+	 *
+	 * @returns Max.
+	 */
+	public get max(): number {
+		if (!this.hasAttribute('max')) {
+			return 1;
+		}
+		const parsedValue = parseFloat(this.getAttribute('max') || '');
+		if (isNaN(parsedValue) || parsedValue > 1) {
+			return 1;
+		}
+		return parsedValue < 0 ? 0 : parsedValue;
+	}
+
+	/**
+	 * Sets max.
+	 *
+	 * @param max Max.
+	 */
+	public set max(max: number) {
+		if (typeof max !== 'number') {
+			throw new this[PropertySymbol.window].TypeError(
+				"Failed to set the 'max' property on 'HTMLMeterElement': The provided double value is non-finite."
+			);
+		}
+
+		this.setAttribute('max', String(max));
+	}
+
+	/**
+	 * Returns min.
+	 *
+	 * @returns Min.
+	 */
+	public get min(): number {
+		if (!this.hasAttribute('min')) {
+			return 0;
+		}
+		const parsedValue = parseFloat(this.getAttribute('min') || '');
+		if (isNaN(parsedValue) || parsedValue < 0) {
+			return 0;
+		}
+		return parsedValue > 1 ? 1 : parsedValue;
+	}
+
+	/**
+	 * Sets min.
+	 *
+	 * @param min Min.
+	 */
+	public set min(min: number) {
+		if (typeof min !== 'number') {
+			throw new this[PropertySymbol.window].TypeError(
+				"Failed to set the 'min' property on 'HTMLMeterElement': The provided double value is non-finite."
+			);
+		}
+
+		this.setAttribute('min', String(min));
+	}
+
+	/**
+	 * Returns optimum.
+	 *
+	 * @returns Optimum.
+	 */
+	public get optimum(): number {
+		if (!this.hasAttribute('optimum')) {
+			return 0.5;
+		}
+		const parsedValue = parseFloat(this.getAttribute('optimum') || '');
+		if (isNaN(parsedValue)) {
+			return 0.5;
+		}
+		if (parsedValue < 0) {
+			return 0;
+		}
+		return parsedValue > 1 ? 1 : parsedValue;
+	}
+
+	/**
+	 * Sets optimum.
+	 *
+	 * @param optimum Optimum.
+	 */
+	public set optimum(optimum: number) {
+		if (typeof optimum !== 'number') {
+			throw new this[PropertySymbol.window].TypeError(
+				"Failed to set the 'optimum' property on 'HTMLMeterElement': The provided double value is non-finite."
+			);
+		}
+
+		this.setAttribute('optimum', String(optimum));
+	}
+
+	/**
+	 * Returns value.
+	 *
+	 * @returns Value.
+	 */
+	public get value(): number {
+		if (!this.hasAttribute('value')) {
+			return 0;
+		}
+		const parsedValue = parseFloat(this.getAttribute('value') || '');
+		if (isNaN(parsedValue) || parsedValue < 0) {
+			return 0;
+		}
+		return parsedValue > 1 ? 1 : parsedValue;
+	}
+
+	/**
+	 * Sets value.
+	 *
+	 * @param value Value.
+	 */
+	public set value(value: number) {
+		if (typeof value !== 'number') {
+			throw new this[PropertySymbol.window].TypeError(
+				"Failed to set the 'value' property on 'HTMLMeterElement': The provided double value is non-finite."
+			);
+		}
+
+		this.setAttribute('value', String(value));
+	}
+
+	/**
+	 * Returns the associated label elements.
+	 *
+	 * @returns Label elements.
+	 */
+	public get labels(): NodeList<HTMLLabelElement> {
+		return HTMLLabelElementUtility.getAssociatedLabelElements(this);
+	}
+}

package/src/nodes/html-mod-element/HTMLModElement.ts

@@ -0,0 +1,54 @@
+import HTMLElement from '../html-element/HTMLElement.js';
+import * as PropertySymbol from '../../PropertySymbol.js';
+
+/**
+ * HTMLModElement
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLModElement
+ */
+export default class HTMLModElement extends HTMLElement {
+	/**
+	 * Returns source.
+	 *
+	 * @returns Source.
+	 */
+	public get cite(): string {
+		if (!this.hasAttribute('cite')) {
+			return '';
+		}
+
+		try {
+			return new URL(this.getAttribute('cite'), this[PropertySymbol.ownerDocument].location.href)
+				.href;
+		} catch (e) {
+			return this.getAttribute('cite');
+		}
+	}
+
+	/**
+	 * Sets source.
+	 *
+	 * @param cite Source.
+	 */
+	public set cite(cite: string) {
+		this.setAttribute('cite', cite);
+	}
+
+	/**
+	 * Returns date time.
+	 *
+	 * @returns Date time.
+	 */
+	public get dateTime(): string {
+		return this.getAttribute('datetime') || '';
+	}
+
+	/**
+	 * Sets date time.
+	 *
+	 * @param dateTime Date time.
+	 */
+	public set dateTime(dateTime: string) {
+		this.setAttribute('datetime', dateTime);
+	}
+}

package/src/nodes/html-o-list-element/HTMLOListElement.ts

@@ -0,0 +1,83 @@
+import HTMLElement from '../html-element/HTMLElement.js';
+/**
+ * HTMLOListElement
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLOListElement
+ */
+export default class HTMLOListElement extends HTMLElement {
+	/**
+	 * Returns reversed.
+	 *
+	 * @returns Reversed.
+	 */
+	public get reversed(): boolean {
+		return this.getAttribute('reversed') !== null;
+	}
+
+	/**
+	 * Sets reversed.
+	 *
+	 * @param reversed Reversed.
+	 */
+	public set reversed(reversed: boolean) {
+		if (!reversed) {
+			this.removeAttribute('reversed');
+		} else {
+			this.setAttribute('reversed', '');
+		}
+	}
+
+	/**
+	 * Returns start.
+	 *
+	 * @returns Start.
+	 */
+	public get start(): number {
+		if (!this.hasAttribute('start')) {
+			return 1;
+		}
+
+		const parsedValue = Number(this.getAttribute('start') || '');
+
+		if (isNaN(parsedValue)) {
+			return 1;
+		}
+
+		return parsedValue;
+	}
+
+	/**
+	 * Sets start.
+	 *
+	 * @param start Start.
+	 */
+	public set start(start: number) {
+		if (typeof start !== 'number') {
+			start = Number(start);
+		}
+
+		if (isNaN(start)) {
+			start = 0;
+		}
+
+		this.setAttribute('start', String(start));
+	}
+
+	/**
+	 * Returns type.
+	 *
+	 * @returns Type.
+	 */
+	public get type(): string {
+		return this.getAttribute('type') || '';
+	}
+
+	/**
+	 * Sets type.
+	 *
+	 * @param type Type.
+	 */
+	public set type(type: string) {
+		this.setAttribute('type', type);
+	}
+}