happy-dom 5.0.0 → 5.1.0

package/src/config/NonImplemenetedElementClasses.ts

@@ -32,13 +32,10 @@ export default [
 	'HTMLMediaElement',
 	'HTMLMeterElement',
 	'HTMLModElement',
-	'HTMLOptGroupElement',
-	'HTMLOptionElement',
 	'HTMLOutputElement',
 	'HTMLPictureElement',
 	'HTMLProgressElement',
 	'HTMLQuoteElement',
-	'HTMLSelectElement',
 	'HTMLSourceElement',
 	'HTMLSpanElement',
 	'HTMLTableCaptionElement',

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

@@ -1,6 +1,6 @@
 import File from '../../file/File';
 import HTMLElement from '../html-element/HTMLElement';
-import ValidityState from './ValidityState';
+import ValidityState from '../validity-state/ValidityState';
 import DOMException from '../../exception/DOMException';
 import DOMExceptionNameEnum from '../../exception/DOMExceptionNameEnum';
 import Event from '../../event/Event';

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

@@ -2,7 +2,7 @@ import File from '../../file/File';
 import IHTMLElement from '../html-element/IHTMLElement';
 import IHTMLFormElement from '../html-form-element/IHTMLFormElement';
 import HTMLInputElementSelectionModeEnum from './HTMLInputElementSelectionModeEnum';
-import ValidityState from './ValidityState';
+import ValidityState from '../validity-state/ValidityState';
 
 /**
  * HTML Input Element.

package/src/nodes/html-opt-group-element/HTMLOptGroupElement.ts

@@ -0,0 +1,54 @@
+import HTMLElement from '../html-element/HTMLElement';
+import IHTMLOptGroupElement from './IHTMLOptGroupElement';
+
+/**
+ * HTML Opt Group Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptGroupElement.
+ */
+export default class HTMLOptGroupElement extends HTMLElement implements IHTMLOptGroupElement {
+	/**
+	 * Returns label.
+	 *
+	 * @returns Label.
+	 */
+	public get label(): string {
+		return this.getAttributeNS(null, 'label') || '';
+	}
+
+	/**
+	 * Sets label.
+	 *
+	 * @param label Label.
+	 */
+	public set label(label: string) {
+		if (!label) {
+			this.removeAttributeNS(null, 'label');
+		} else {
+			this.setAttributeNS(null, 'label', label);
+		}
+	}
+
+	/**
+	 * Returns disabled.
+	 *
+	 * @returns Disabled.
+	 */
+	public get disabled(): boolean {
+		return this.getAttributeNS(null, 'disabled') !== null;
+	}
+
+	/**
+	 * Sets disabled.
+	 *
+	 * @param disabled Disabled.
+	 */
+	public set disabled(disabled: boolean) {
+		if (!disabled) {
+			this.removeAttributeNS(null, 'disabled');
+		} else {
+			this.setAttributeNS(null, 'disabled', '');
+		}
+	}
+}

package/src/nodes/html-opt-group-element/IHTMLOptGroupElement.ts

@@ -0,0 +1,12 @@
+import IHTMLElement from '../html-element/IHTMLElement';
+
+/**
+ * HTML Opt Group Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptGroupElement.
+ */
+export default interface IHTMLOptGroupElement extends IHTMLElement {
+	disabled: boolean;
+	label: string;
+}

package/src/nodes/html-option-element/HTMLOptionElement.ts

@@ -0,0 +1,117 @@
+import HTMLElement from '../html-element/HTMLElement';
+import IHTMLElement from '../html-element/IHTMLElement';
+import IHTMLFormElement from '../html-form-element/IHTMLFormElement';
+import HTMLOptionElementValueSanitizer from './HTMLOptionElementValueSanitizer';
+import IHTMLOptionElement from './IHTMLOptionElement';
+
+/**
+ * HTML Option Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptionElement.
+ */
+export default class HTMLOptionElement extends HTMLElement implements IHTMLOptionElement {
+	public _index: number;
+
+	/**
+	 * Returns inner text, which is the rendered appearance of text.
+	 *
+	 * @returns Inner text.
+	 */
+	public get text(): string {
+		return this.innerText;
+	}
+
+	/**
+	 * Sets the inner text, which is the rendered appearance of text.
+	 *
+	 * @param innerText Inner text.
+	 */
+	public set text(text: string) {
+		this.innerText = text;
+	}
+
+	/**
+	 * Returns index.
+	 *
+	 * @returns Index.
+	 */
+	public get index(): number {
+		return this._index;
+	}
+
+	/**
+	 * Returns the parent form element.
+	 *
+	 * @returns Form.
+	 */
+	public get form(): IHTMLFormElement {
+		let parent = <IHTMLElement>this.parentNode;
+		while (parent && parent.tagName !== 'FORM') {
+			parent = <IHTMLElement>parent.parentNode;
+		}
+		return <IHTMLFormElement>parent;
+	}
+
+	/**
+	 * Returns selected.
+	 *
+	 * @returns Selected.
+	 */
+	public get selected(): boolean {
+		return this.getAttributeNS(null, 'selected') !== null;
+	}
+
+	/**
+	 * Sets selected.
+	 *
+	 * @param selected Selected.
+	 */
+	public set selected(selected: boolean) {
+		if (!selected) {
+			this.removeAttributeNS(null, 'selected');
+		} else {
+			this.setAttributeNS(null, 'selected', '');
+		}
+	}
+
+	/**
+	 * Returns disabled.
+	 *
+	 * @returns Disabled.
+	 */
+	public get disabled(): boolean {
+		return this.getAttributeNS(null, 'disabled') !== null;
+	}
+
+	/**
+	 * Sets disabled.
+	 *
+	 * @param disabled Disabled.
+	 */
+	public set disabled(disabled: boolean) {
+		if (!disabled) {
+			this.removeAttributeNS(null, 'disabled');
+		} else {
+			this.setAttributeNS(null, 'disabled', '');
+		}
+	}
+
+	/**
+	 * Returns value.
+	 *
+	 * @returns Value.
+	 */
+	public get value(): string {
+		return this.getAttributeNS(null, 'value') || '';
+	}
+
+	/**
+	 * Sets value.
+	 *
+	 * @param value Value.
+	 */
+	public set value(value: string) {
+		this.setAttributeNS(null, 'value', HTMLOptionElementValueSanitizer.sanitize(value));
+	}
+}

package/src/nodes/html-option-element/HTMLOptionElementValueSanitizer.ts

@@ -0,0 +1,15 @@
+const NEW_LINES_REGEXP = /[\n\r]/gm;
+
+/**
+ * HTML select element value sanitizer.
+ */
+export default class HTMLOptionElementValueSanitizer {
+	/**
+	 * Sanitizes a value.
+	 *
+	 * @param value Value.
+	 */
+	public static sanitize(value: string): string {
+		return value.trim().replace(NEW_LINES_REGEXP, '');
+	}
+}

package/src/nodes/html-option-element/HTMLOptionsCollection.ts

@@ -0,0 +1,94 @@
+import DOMException from '../../exception/DOMException';
+import HTMLCollection from '../element/HTMLCollection';
+import HTMLOptGroupElement from '../html-opt-group-element/HTMLOptGroupElement';
+import HTMLOptionElement from './HTMLOptionElement';
+import IHTMLOptionsCollection from './IHTMLOptionsCollection';
+
+/**
+ * HTML Options Collection.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptionsCollection.
+ */
+export default class HTMLOptionsCollection
+	extends HTMLCollection
+	implements IHTMLOptionsCollection
+{
+	public _selectedIndex: number;
+
+	/**
+	 * Returns selectedIndex.
+	 *
+	 * @returns SelectedIndex.
+	 */
+	public get selectedIndex(): number {
+		return this._selectedIndex;
+	}
+
+	/**
+	 * Sets selectedIndex.
+	 *
+	 * @param selectedIndex SelectedIndex.
+	 */
+	public set selectedIndex(selectedIndex: number) {
+		this._selectedIndex = selectedIndex;
+	}
+
+	/**
+	 * Returns item by index.
+	 *
+	 * @param index Index.
+	 */
+	public item(index: number): HTMLOptionElement | HTMLOptGroupElement {
+		return this[index];
+	}
+
+	/**
+	 *
+	 * @param element
+	 * @param before
+	 */
+	public add(
+		element: HTMLOptionElement | HTMLOptGroupElement,
+		before?: number | HTMLOptionElement | HTMLOptGroupElement
+	): void {
+		if (!before && before !== 0) {
+			this.push(element);
+			return;
+		}
+
+		if (!Number.isNaN(Number(before))) {
+			if (before < 0) {
+				return;
+			}
+
+			this.splice(<number>before, 0, element);
+			return;
+		}
+
+		const idx = this.findIndex((element) => element === before);
+		if (idx === -1) {
+			throw new DOMException(
+				"Failed to execute 'add' on 'DOMException': The node before which the new node is to be inserted is not a child of this node."
+			);
+		}
+
+		this.splice(idx, 0, element);
+	}
+
+	/**
+	 * Removes indexed element from collection.
+	 *
+	 * @param index Index.
+	 */
+	public remove(index: number): void {
+		this.splice(index, 1);
+		if (index === this.selectedIndex) {
+			if (this.length) {
+				this.selectedIndex = 0;
+			} else {
+				this.selectedIndex = -1;
+			}
+		}
+	}
+}

package/src/nodes/html-option-element/IHTMLOptionElement.ts

@@ -0,0 +1,17 @@
+import IHTMLElement from '../html-element/IHTMLElement';
+import IHTMLFormElement from '../html-form-element/IHTMLFormElement';
+
+/**
+ * HTML Option Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptionElement.
+ */
+export default interface IHTMLOptionElement extends IHTMLElement {
+	readonly form: IHTMLFormElement;
+	readonly index: number;
+	selected: boolean;
+	value: string;
+	text: string;
+	disabled: boolean;
+}

package/src/nodes/html-option-element/IHTMLOptionsCollection.ts

@@ -0,0 +1,33 @@
+import IHTMLCollection from '../element/IHTMLCollection';
+import IHTMLOptGroupElement from '../html-opt-group-element/IHTMLOptGroupElement';
+import IHTMLOptionElement from './IHTMLOptionElement';
+
+/**
+ * HTML Options Collection.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptionsCollection.
+ */
+export default interface IHTMLOptionsCollection
+	extends IHTMLCollection<IHTMLOptionElement | IHTMLOptGroupElement> {
+	selectedIndex: number;
+	length: number;
+
+	/**
+	 * Adds new option to collection.
+	 *
+	 * @param element HTMLOptionElement or HTMLOptGroupElement to add.
+	 * @param before HTMLOptionElement or index number.
+	 */
+	add(
+		element: IHTMLOptionElement | IHTMLOptGroupElement,
+		before?: number | IHTMLOptionElement | IHTMLOptGroupElement
+	): void;
+
+	/**
+	 * Removes option element from the collection.
+	 *
+	 * @param index Index.
+	 */
+	remove(index: number): void;
+}

package/src/nodes/html-select-element/HTMLSelectElement.ts

@@ -0,0 +1,239 @@
+import DOMException from '../../exception/DOMException';
+import DOMExceptionNameEnum from '../../exception/DOMExceptionNameEnum';
+import HTMLElement from '../html-element/HTMLElement';
+import IHTMLElement from '../html-element/IHTMLElement';
+import IHTMLFormElement from '../html-form-element/IHTMLFormElement';
+import ValidityState from '../validity-state/ValidityState';
+import IHTMLLabelElement from '../html-label-element/IHTMLLabelElement';
+import HTMLOptGroupElement from '../html-opt-group-element/HTMLOptGroupElement';
+import HTMLOptionElement from '../html-option-element/HTMLOptionElement';
+import HTMLOptionsCollection from '../html-option-element/HTMLOptionsCollection';
+import IHTMLOptionsCollection from '../html-option-element/IHTMLOptionsCollection';
+import INodeList from '../node/INodeList';
+import HTMLSelectElementValueSanitizer from './HTMLSelectElementValueSanitizer';
+import IHTMLSelectElement from './IHTMLSelectElement';
+
+/**
+ * HTML Select Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLSelectElement.
+ */
+export default class HTMLSelectElement extends HTMLElement implements IHTMLSelectElement {
+	public type: string;
+	public labels: INodeList<IHTMLLabelElement>;
+
+	public _value = null;
+	public _selectedIndex = -1;
+	public _options: IHTMLOptionsCollection = null;
+
+	/**
+	 * 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 disabled.
+	 *
+	 * @returns Disabled.
+	 */
+	public get disabled(): boolean {
+		return this.getAttributeNS(null, 'disabled') !== null;
+	}
+
+	/**
+	 * Sets disabled.
+	 *
+	 * @param disabled Disabled.
+	 */
+	public set disabled(disabled: boolean) {
+		if (!disabled) {
+			this.removeAttributeNS(null, 'disabled');
+		} else {
+			this.setAttributeNS(null, 'disabled', '');
+		}
+	}
+
+	/**
+	 * Returns multiple.
+	 *
+	 * @returns Multiple.
+	 */
+	public get multiple(): boolean {
+		return this.getAttributeNS(null, 'multiple') !== null;
+	}
+
+	/**
+	 * Sets multiple.
+	 *
+	 * @param multiple Multiple.
+	 */
+	public set multiple(multiple: boolean) {
+		if (!multiple) {
+			this.removeAttributeNS(null, 'multiple');
+		} else {
+			this.setAttributeNS(null, 'multiple', '');
+		}
+	}
+
+	/**
+	 * Returns autofocus.
+	 *
+	 * @returns Autofocus.
+	 */
+	public get autofocus(): boolean {
+		return this.getAttributeNS(null, 'autofocus') !== null;
+	}
+
+	/**
+	 * Sets autofocus.
+	 *
+	 * @param autofocus Autofocus.
+	 */
+	public set autofocus(autofocus: boolean) {
+		if (!autofocus) {
+			this.removeAttributeNS(null, 'autofocus');
+		} else {
+			this.setAttributeNS(null, 'autofocus', '');
+		}
+	}
+
+	/**
+	 * Returns required.
+	 *
+	 * @returns Required.
+	 */
+	public get required(): boolean {
+		return this.getAttributeNS(null, 'required') !== null;
+	}
+
+	/**
+	 * Sets required.
+	 *
+	 * @param required Required.
+	 */
+	public set required(required: boolean) {
+		if (!required) {
+			this.removeAttributeNS(null, 'required');
+		} else {
+			this.setAttributeNS(null, 'required', '');
+		}
+	}
+
+	/**
+	 * Returns value.
+	 *
+	 * @returns Value.
+	 */
+	public get value(): string {
+		return this._value;
+	}
+
+	/**
+	 * Sets value.
+	 *
+	 * @param value Value.
+	 */
+	public set value(value: string) {
+		this._value = HTMLSelectElementValueSanitizer.sanitize(value);
+
+		const idx = this.options.findIndex((o) => o.nodeValue === value);
+		if (idx > -1) {
+			this._selectedIndex = idx;
+		}
+	}
+
+	/**
+	 * Returns value.
+	 *
+	 * @returns Value.
+	 */
+	public get selectedIndex(): number {
+		return this._options ? this._options.selectedIndex : -1;
+	}
+
+	/**
+	 * Sets value.
+	 *
+	 * @param value Value.
+	 */
+	public set selectedIndex(value: number) {
+		if (this.options.length - 1 > value || value < 0) {
+			throw new DOMException(
+				'Select elements selected index must be valid',
+				DOMExceptionNameEnum.indexSizeError
+			);
+		}
+
+		this._options.selectedIndex = value;
+	}
+
+	/**
+	 * Returns the parent form element.
+	 *
+	 * @returns Form.
+	 */
+	public get form(): IHTMLFormElement {
+		let parent = <IHTMLElement>this.parentNode;
+		while (parent && parent.tagName !== 'FORM') {
+			parent = <IHTMLElement>parent.parentNode;
+		}
+		return <IHTMLFormElement>parent;
+	}
+
+	/**
+	 * Returns validity state.
+	 *
+	 * @returns Validity state.
+	 */
+	public get validity(): ValidityState {
+		return new ValidityState(this);
+	}
+
+	/**
+	 * Returns "true" if it will validate.
+	 *
+	 * @returns "true" if it will validate.
+	 */
+	public get willValidate(): boolean {
+		return (
+			this.type !== 'hidden' &&
+			this.type !== 'reset' &&
+			this.type !== 'button' &&
+			!this.disabled &&
+			!this['readOnly']
+		);
+	}
+
+	/**
+	 * Returns options.
+	 *
+	 * @returns Options.
+	 */
+	public get options(): IHTMLOptionsCollection {
+		if (this._options === null) {
+			this._options = new HTMLOptionsCollection();
+			const childs = <INodeList<IHTMLElement>>this.childNodes;
+			for (const child of childs) {
+				if (child.tagName === 'OPTION') {
+					this._options.add(<HTMLOptionElement | HTMLOptGroupElement>child);
+				}
+			}
+		}
+
+		return this._options;
+	}
+}

package/src/nodes/html-select-element/HTMLSelectElementValueSanitizer.ts

@@ -0,0 +1,15 @@
+const NEW_LINES_REGEXP = /[\n\r]/gm;
+
+/**
+ * HTML select element value sanitizer.
+ */
+export default class HTMLSelectElementValueSanitizer {
+	/**
+	 * Sanitizes a value.
+	 *
+	 * @param value Value.
+	 */
+	public static sanitize(value: string): string {
+		return value.replace(NEW_LINES_REGEXP, '');
+	}
+}

package/src/nodes/html-select-element/IHTMLSelectElement.ts

@@ -0,0 +1,27 @@
+import IHTMLElement from '../html-element/IHTMLElement';
+import IHTMLFormElement from '../html-form-element/IHTMLFormElement';
+import IHTMLLabelElement from '../html-label-element/IHTMLLabelElement';
+import INodeList from '../node/INodeList';
+import IHTMLOptionsCollection from '../html-option-element/IHTMLOptionsCollection';
+import ValidityState from '../validity-state/ValidityState';
+
+/**
+ * HTML Select Element.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/HTMLSelectElement.
+ */
+export default interface IHTMLSelectElement extends IHTMLElement {
+	readonly form: IHTMLFormElement;
+	readonly labels: INodeList<IHTMLLabelElement>;
+	type: string;
+	autofocus: boolean;
+	disabled: boolean;
+	options: IHTMLOptionsCollection;
+	selectedIndex: number;
+	validity: ValidityState;
+	value: string;
+	willValidate: boolean;
+	name: string;
+	multiple: boolean;
+}