happy-dom 2.37.0 → 2.40.0

package/src/css/CSSUnitValue.ts

@@ -0,0 +1,26 @@
+import CSSUnits from './CSSUnits';
+
+/**
+ * CSS unit value.
+ */
+export default class CSSUnitValue {
+	public unit: string = null;
+	public value: number = null;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param value Value.
+	 * @param unit Unit.
+	 */
+	constructor(value: number, unit: string) {
+		if (typeof value !== 'number') {
+			throw new TypeError('The provided double value is non-finite');
+		}
+		if (!CSSUnits.includes(unit)) {
+			throw new TypeError('Invalid unit: ' + unit);
+		}
+		this.value = value;
+		this.unit = unit;
+	}
+}

package/src/css/CSSUnits.ts

@@ -0,0 +1,31 @@
+export default [
+	'Hz',
+	'Q',
+	'ch',
+	'cm',
+	'deg',
+	'dpcm',
+	'dpi',
+	'dppx',
+	'em',
+	'ex',
+	'fr',
+	'grad',
+	'in',
+	'kHz',
+	'mm',
+	'ms',
+	'number',
+	'pc',
+	'percent',
+	'pt',
+	'px',
+	'rad',
+	'rem',
+	's',
+	'turn',
+	'vh',
+	'vmax',
+	'vmin',
+	'vw'
+];

package/src/index.ts

@@ -74,6 +74,8 @@ import HTMLSlotElement from './nodes/html-slot-element/HTMLSlotElement';
 import IHTMLSlotElement from './nodes/html-slot-element/IHTMLSlotElement';
 import HTMLLabelElement from './nodes/html-label-element/HTMLLabelElement';
 import IHTMLLabelElement from './nodes/html-label-element/IHTMLLabelElement';
+import HTMLMetaElement from './nodes/html-meta-element/HTMLMetaElement';
+import IHTMLMetaElement from './nodes/html-meta-element/IHTMLMetaElement';
 import SVGElement from './nodes/svg-element/SVGElement';
 import ISVGElement from './nodes/svg-element/ISVGElement';
 import SVGGraphicsElement from './nodes/svg-element/SVGGraphicsElement';
@@ -181,6 +183,8 @@ export {
 	IHTMLSlotElement,
 	HTMLLabelElement,
 	IHTMLLabelElement,
+	HTMLMetaElement,
+	IHTMLMetaElement,
 	SVGElement,
 	ISVGElement,
 	SVGGraphicsElement,

package/src/nodes/html-input-element/HTMLInputElement.ts

@@ -10,6 +10,7 @@ import HTMLInputElementSelectionDirectionEnum from './HTMLInputElementSelectionD
 import IHTMLInputElement from './IHTMLInputElement';
 import IHTMLFormElement from '../html-form-element/IHTMLFormElement';
 import IHTMLElement from '../html-element/IHTMLElement';
+import HTMLInputElementValueStepping from './HTMLInputElementValueStepping';
 
 /**
  * HTML Input Element.
@@ -903,6 +904,30 @@ export default class HTMLInputElement extends HTMLElement implements IHTMLInputE
 		return true;
 	}
 
+	/**
+	 * Steps up.
+	 *
+	 * @param [increment] Increment.
+	 */
+	public stepUp(increment?: number): void {
+		const newValue = HTMLInputElementValueStepping.step(this.type, this.value, 1, increment);
+		if (newValue !== null) {
+			this.value = newValue;
+		}
+	}
+
+	/**
+	 * Steps down.
+	 *
+	 * @param [increment] Increment.
+	 */
+	public stepDown(increment?: number): void {
+		const newValue = HTMLInputElementValueStepping.step(this.type, this.value, -1, increment);
+		if (newValue !== null) {
+			this.value = newValue;
+		}
+	}
+
 	/**
 	 * Clones a node.
 	 *

package/src/nodes/html-input-element/HTMLInputElementValueStepping.ts

@@ -0,0 +1,34 @@
+import DOMException from '../../exception/DOMException';
+
+/**
+ * HTML input element value stepping.
+ */
+export default class HTMLInputElementValueStepping {
+	/**
+	 * Steps up or down.
+	 *
+	 * @param type Type.
+	 * @param value Value.
+	 * @param direction Direction.
+	 * @param [increment] Increment.
+	 * @returns New value.
+	 */
+	public static step(type: string, value: string, direction: -1 | 1, increment?: number): string {
+		switch (type) {
+			case 'number':
+				return String(
+					Number(value) + (increment !== undefined ? increment * direction : direction)
+				);
+			case 'date':
+			case 'month':
+			case 'week':
+			case 'time':
+			case 'datetime-local':
+			case 'range':
+				// TODO: Implement support for additional types
+				return null;
+			default:
+				throw new DOMException('This form element is not steppable.');
+		}
+	}
+}

package/src/nodes/html-input-element/IHTMLInputElement.ts

@@ -84,6 +84,20 @@ export default interface IHTMLInputElement extends IHTMLElement {
 	 */
 	checkValidity(): boolean;
 
+	/**
+	 * Steps up.
+	 *
+	 * @param [increment] Increment.
+	 */
+	stepUp(increment?: number): void;
+
+	/**
+	 * Steps up.
+	 *
+	 * @param [increment] Increment.
+	 */
+	stepDown(increment?: number): void;
+
 	/**
 	 * Clones a node.
 	 *

package/src/nodes/html-meta-element/HTMLMetaElement.ts

@@ -0,0 +1,81 @@
+import IHTMLMetaElement from './IHTMLMetaElement';
+import HTMLElement from '../html-element/HTMLElement';
+
+/**
+ * HTML Meta Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLMetaElement.
+ */
+export default class HTMLMetaElement extends HTMLElement implements IHTMLMetaElement {
+	/**
+	 * Returns content.
+	 *
+	 * @returns Content.
+	 */
+	public get content(): string {
+		return this.getAttributeNS(null, 'content') || '';
+	}
+
+	/**
+	 * Sets content.
+	 *
+	 * @param content Content.
+	 */
+	public set content(content: string) {
+		this.setAttributeNS(null, 'content', content);
+	}
+
+	/**
+	 * Returns httpEquiv.
+	 *
+	 * @returns HttpEquiv.
+	 */
+	public get httpEquiv(): string {
+		return this.getAttributeNS(null, 'http-equiv') || '';
+	}
+
+	/**
+	 * Sets httpEquiv.
+	 *
+	 * @param httpEquiv HttpEquiv.
+	 */
+	public set httpEquiv(httpEquiv: string) {
+		this.setAttributeNS(null, 'http-equiv', httpEquiv);
+	}
+
+	/**
+	 * 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);
+	}
+	/**
+	 * Returns scheme.
+	 *
+	 * @returns Name.
+	 */
+	public get scheme(): string {
+		return this.getAttributeNS(null, 'scheme') || '';
+	}
+
+	/**
+	 * Sets scheme.
+	 *
+	 * @param scheme Scheme.
+	 */
+	public set scheme(scheme: string) {
+		this.setAttributeNS(null, 'scheme', scheme);
+	}
+}

package/src/nodes/html-meta-element/IHTMLMetaElement.ts

@@ -0,0 +1,14 @@
+import IHTMLElement from '../html-element/IHTMLElement';
+
+/**
+ * HTML Meta Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLMetaElement.
+ */
+export default interface IHTMLMetaElement extends IHTMLElement {
+	content: string;
+	httpEquiv: string;
+	name: string;
+	scheme: string;
+}

package/src/window/IWindow.ts

@@ -17,6 +17,7 @@ import HTMLLinkElement from '../nodes/html-link-element/HTMLLinkElement';
 import HTMLStyleElement from '../nodes/html-style-element/HTMLStyleElement';
 import HTMLSlotElement from '../nodes/html-slot-element/HTMLSlotElement';
 import HTMLLabelElement from '../nodes/html-label-element/HTMLLabelElement';
+import HTMLMetaElement from '../nodes/html-meta-element/HTMLMetaElement';
 import SVGSVGElement from '../nodes/svg-element/SVGSVGElement';
 import SVGElement from '../nodes/svg-element/SVGElement';
 import HTMLScriptElement from '../nodes/html-script-element/HTMLScriptElement';
@@ -37,13 +38,15 @@ import MutationObserver from '../mutation-observer/MutationObserver';
 import DOMParser from '../dom-parser/DOMParser';
 import XMLSerializer from '../xml-serializer/XMLSerializer';
 import ResizeObserver from '../resize-observer/ResizeObserver';
-import CSSStyleSheet from '../css/CSSStyleSheet';
 import Blob from '../file/Blob';
 import File from '../file/File';
 import DOMException from '../exception/DOMException';
 import FileReader from '../file/FileReader';
 import History from '../history/History';
+import CSSStyleSheet from '../css/CSSStyleSheet';
 import CSSStyleDeclaration from '../css/CSSStyleDeclaration';
+import CSS from '../css/CSS';
+import CSSUnitValue from '../css/CSSUnitValue';
 import PointerEvent from '../event/events/PointerEvent';
 import MouseEvent from '../event/events/MouseEvent';
 import FocusEvent from '../event/events/FocusEvent';
@@ -90,6 +93,7 @@ export default interface IWindow {
 	readonly HTMLStyleElement: typeof HTMLStyleElement;
 	readonly HTMLSlotElement: typeof HTMLSlotElement;
 	readonly HTMLLabelElement: typeof HTMLLabelElement;
+	readonly HTMLMetaElement: typeof HTMLMetaElement;
 	readonly SVGSVGElement: typeof SVGSVGElement;
 	readonly SVGElement: typeof SVGElement;
 	readonly Image: typeof Image;
@@ -142,6 +146,8 @@ export default interface IWindow {
 	readonly URLSearchParams: typeof URLSearchParams;
 	readonly HTMLCollection: typeof HTMLCollection;
 	readonly NodeList: typeof NodeList;
+	readonly CSSUnitValue: typeof CSSUnitValue;
+	readonly CSS: CSS;
 
 	// Events
 	onload: (event: Event) => void;

package/src/window/Window.ts

@@ -18,6 +18,7 @@ import HTMLLinkElement from '../nodes/html-link-element/HTMLLinkElement';
 import HTMLStyleElement from '../nodes/html-style-element/HTMLStyleElement';
 import HTMLSlotElement from '../nodes/html-slot-element/HTMLSlotElement';
 import HTMLLabelElement from '../nodes/html-label-element/HTMLLabelElement';
+import HTMLMetaElement from '../nodes/html-meta-element/HTMLMetaElement';
 import SVGSVGElement from '../nodes/svg-element/SVGSVGElement';
 import SVGElement from '../nodes/svg-element/SVGElement';
 import HTMLScriptElement from '../nodes/html-script-element/HTMLScriptElement';
@@ -40,13 +41,15 @@ import ElementClass from '../config/ElementClass';
 import DOMParser from '../dom-parser/DOMParser';
 import XMLSerializer from '../xml-serializer/XMLSerializer';
 import ResizeObserver from '../resize-observer/ResizeObserver';
-import CSSStyleSheet from '../css/CSSStyleSheet';
 import Blob from '../file/Blob';
 import File from '../file/File';
 import DOMException from '../exception/DOMException';
 import FileReader from '../file/FileReader';
 import History from '../history/History';
+import CSSStyleSheet from '../css/CSSStyleSheet';
 import CSSStyleDeclaration from '../css/CSSStyleDeclaration';
+import CSS from '../css/CSS';
+import CSSUnitValue from '../css/CSSUnitValue';
 import MouseEvent from '../event/events/MouseEvent';
 import PointerEvent from '../event/events/PointerEvent';
 import FocusEvent from '../event/events/FocusEvent';
@@ -103,6 +106,7 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 	public readonly HTMLStyleElement = HTMLStyleElement;
 	public readonly HTMLLabelElement = HTMLLabelElement;
 	public readonly HTMLSlotElement = HTMLSlotElement;
+	public readonly HTMLMetaElement = HTMLMetaElement;
 	public readonly SVGSVGElement = SVGSVGElement;
 	public readonly SVGElement = SVGElement;
 	public readonly Text = Text;
@@ -155,6 +159,7 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 	public readonly HTMLCollection = HTMLCollection;
 	public readonly NodeList = NodeList;
 	public readonly MediaQueryList = MediaQueryList;
+	public readonly CSSUnitValue = CSSUnitValue;
 
 	// Events
 	public onload: (event: Event) => void = null;
@@ -278,6 +283,15 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 		}
 	}
 
+	/**
+	 * The CSS interface holds useful CSS-related methods.
+	 *
+	 * @returns CSS interface.
+	 */
+	public get CSS(): CSS {
+		return new CSS();
+	}
+
 	/**
 	 * Evaluates code.
 	 *