happy-dom 12.7.0 → 12.8.1

package/src/nodes/element/ElementNamedNodeMap.ts

@@ -103,7 +103,7 @@ export default class ElementNamedNodeMap extends NamedNodeMap {
 					record.type = MutationTypeEnum.attributes;
 					record.attributeName = item.name;
 					record.oldValue = observer.options.attributeOldValue ? oldValue : null;
-					observer.callback([record]);
+					observer.callback([record], observer.observer);
 				}
 			}
 		}
@@ -164,7 +164,7 @@ export default class ElementNamedNodeMap extends NamedNodeMap {
 					record.type = MutationTypeEnum.attributes;
 					record.attributeName = removedItem.name;
 					record.oldValue = observer.options.attributeOldValue ? removedItem.value : null;
-					observer.callback([record]);
+					observer.callback([record], observer.observer);
 				}
 			}
 		}

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

@@ -1167,43 +1167,69 @@ export default class HTMLInputElement extends HTMLElement implements IHTMLInputE
 	 * @override
 	 */
 	public override dispatchEvent(event: Event): boolean {
+		// Do nothing if the input element is disabled and the event is a click event.
 		if (event.type === 'click' && event.eventPhase === EventPhaseEnum.none && this.disabled) {
 			return false;
 		}
 
+		let previousCheckedValue: boolean | null = null;
+
+		// The checkbox or radio button has to be checked before the click event is dispatched, so that event listeners can check the checked value.
+		// However, the value has to be restored if preventDefault() is called on the click event.
 		if (
-			event.type === 'click' &&
 			(event.eventPhase === EventPhaseEnum.atTarget ||
 				event.eventPhase === EventPhaseEnum.bubbling) &&
-			(this.type === 'checkbox' || this.type === 'radio')
+			event.type === 'click'
 		) {
-			this._setChecked(this.type === 'checkbox' ? !this.checked : true);
+			const inputType = this.type;
+			if (inputType === 'checkbox' || inputType === 'radio') {
+				previousCheckedValue = this.checked;
+				this._setChecked(inputType === 'checkbox' ? !previousCheckedValue : true);
+			}
 		}
 
 		const returnValue = super.dispatchEvent(event);
 
 		if (
-			event.type === 'click' &&
+			!event.defaultPrevented &&
 			(event.eventPhase === EventPhaseEnum.atTarget ||
 				event.eventPhase === EventPhaseEnum.bubbling) &&
-			(!this.readOnly || this.type === 'checkbox' || this.type === 'radio')
+			event.type === 'click' &&
+			this.isConnected
 		) {
-			if (this.type === 'checkbox' || this.type === 'radio') {
-				this.dispatchEvent(new Event('input', { bubbles: true, cancelable: true }));
-				this.dispatchEvent(new Event('change', { bubbles: true, cancelable: true }));
-			} else if (this.type === 'submit') {
-				const form = <IHTMLFormElement>this._formNode;
-				if (form) {
-					form.requestSubmit();
-				}
-			} else if (this.type === 'reset' && this.isConnected) {
-				const form = <IHTMLFormElement>this._formNode;
-				if (form) {
-					form.reset();
+			const inputType = this.type;
+			if (!this.readOnly || inputType === 'checkbox' || inputType === 'radio') {
+				if (inputType === 'checkbox' || inputType === 'radio') {
+					this.dispatchEvent(new Event('input', { bubbles: true, cancelable: true }));
+					this.dispatchEvent(new Event('change', { bubbles: true, cancelable: true }));
+				} else if (inputType === 'submit') {
+					const form = <IHTMLFormElement>this._formNode;
+					if (form) {
+						form.requestSubmit();
+					}
+				} else if (inputType === 'reset' && this.isConnected) {
+					const form = <IHTMLFormElement>this._formNode;
+					if (form) {
+						form.reset();
+					}
 				}
 			}
 		}
 
+		// Restore checked state if preventDefault() is triggered on the click event.
+		if (
+			event.defaultPrevented &&
+			(event.eventPhase === EventPhaseEnum.atTarget ||
+				event.eventPhase === EventPhaseEnum.bubbling) &&
+			event.type === 'click' &&
+			previousCheckedValue !== null
+		) {
+			const inputType = this.type;
+			if (inputType === 'checkbox' || inputType === 'radio') {
+				this._setChecked(previousCheckedValue);
+			}
+		}
+
 		return returnValue;
 	}
 
@@ -1233,12 +1259,13 @@ export default class HTMLInputElement extends HTMLElement implements IHTMLInputE
 	 * @returns "true" if selection is supported.
 	 */
 	private _isSelectionSupported(): boolean {
+		const inputType = this.type;
 		return (
-			this.type === 'text' ||
-			this.type === 'search' ||
-			this.type === 'url' ||
-			this.type === 'tel' ||
-			this.type === 'password'
+			inputType === 'text' ||
+			inputType === 'search' ||
+			inputType === 'url' ||
+			inputType === 'tel' ||
+			inputType === 'password'
 		);
 	}
 

package/src/nodes/node/NodeUtility.ts

@@ -81,7 +81,7 @@ export default class NodeUtility {
 					(<Node>node)._observe(observer);
 				}
 				if (observer.options.childList) {
-					observer.callback([record]);
+					observer.callback([record], observer.observer);
 				}
 			}
 		}
@@ -121,7 +121,7 @@ export default class NodeUtility {
 			for (const observer of (<Node>ancestorNode)._observers) {
 				(<Node>node)._unobserve(observer);
 				if (observer.options.childList) {
-					observer.callback([record]);
+					observer.callback([record], observer.observer);
 				}
 			}
 		}
@@ -208,7 +208,7 @@ export default class NodeUtility {
 					(<Node>newNode)._observe(observer);
 				}
 				if (observer.options.childList) {
-					observer.callback([record]);
+					observer.callback([record], observer.observer);
 				}
 			}
 		}

package/src/permissions/PermissionNameEnum.ts

@@ -0,0 +1,32 @@
+enum PermissionNameEnum {
+	geolocation = 'geolocation',
+	notifications = 'notifications',
+	push = 'push',
+	midi = 'midi',
+	camera = 'camera',
+	microphone = 'microphone',
+	backgroundFetch = 'background-fetch',
+	backgroundSync = 'background-sync',
+	persistentStorage = 'persistent-storage',
+	ambientLightSensor = 'ambient-light-sensor',
+	accelerometer = 'accelerometer',
+	gyroscope = 'gyroscope',
+	magnetometer = 'magnetometer',
+	screenWakeLock = 'screen-wake-lock',
+	nfc = 'nfc',
+	displayCapture = 'display-capture',
+	accessibilityEvents = 'accessibility-events',
+	clipboardRead = 'clipboard-read',
+	clipboardWrite = 'clipboard-write',
+	paymentHandler = 'payment-handler',
+	idleDetection = 'idle-detection',
+	periodicBackgroundSync = 'periodic-background-sync',
+	systemWakeLock = 'system-wake-lock',
+	storageAccess = 'storage-access',
+	windowManagement = 'window-management',
+	windowPlacement = 'window-placement',
+	localFonts = 'local-fonts',
+	topLevelStorageAccess = 'top-level-storage-access'
+}
+
+export default PermissionNameEnum;

package/src/permissions/PermissionStatus.ts

@@ -0,0 +1,23 @@
+import EventTarget from '../event/EventTarget.js';
+import Event from '../event/Event.js';
+
+/**
+ * Permission status.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/PermissionStatus
+ */
+export default class PermissionStatus extends EventTarget {
+	public state: 'granted' | 'denied' | 'prompt';
+	public onchange: ((event: Event) => void) | null = null;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param [state] State.
+	 */
+	constructor(state: 'granted' | 'denied' | 'prompt' = 'granted') {
+		super();
+		this.state = state;
+	}
+}

package/src/permissions/Permissions.ts

@@ -0,0 +1,45 @@
+import PermissionStatus from './PermissionStatus.js';
+import PermissionNameEnum from './PermissionNameEnum.js';
+
+/**
+ * Permissions API.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/Permissions.
+ */
+export default class Permissions {
+	#permissionStatus: {
+		[name in PermissionNameEnum]?: PermissionStatus;
+	} = {};
+
+	/**
+	 * Returns scroll restoration.
+	 *
+	 * @param permissionDescriptor Permission descriptor.
+	 * @param permissionDescriptor.name Permission name.
+	 * @param [permissionDescriptor.userVisibleOnly] User visible only.
+	 * @param [permissionDescriptor.sysex] Sysex.
+	 * @returns Permission status.
+	 */
+	public async query(permissionDescriptor: {
+		name: string;
+		userVisibleOnly?: boolean;
+		sysex?: boolean;
+	}): Promise<PermissionStatus> {
+		if (this.#permissionStatus[permissionDescriptor.name]) {
+			return this.#permissionStatus[permissionDescriptor.name];
+		}
+
+		if (
+			!Object.values(PermissionNameEnum).includes(<PermissionNameEnum>permissionDescriptor.name)
+		) {
+			throw new Error(
+				`Failed to execute 'query' on 'Permissions': Failed to read the 'name' property from 'PermissionDescriptor': The provided value '${permissionDescriptor.name}' is not a valid enum value of type PermissionName.`
+			);
+		}
+
+		this.#permissionStatus[permissionDescriptor.name] = new PermissionStatus('granted');
+
+		return this.#permissionStatus[permissionDescriptor.name];
+	}
+}

package/src/window/IWindow.ts

@@ -46,6 +46,7 @@ import { URLSearchParams } from 'url';
 import URL from '../url/URL.js';
 import Location from '../location/Location.js';
 import MutationObserver from '../mutation-observer/MutationObserver.js';
+import MutationRecord from '../mutation-observer/MutationRecord.js';
 import DOMParser from '../dom-parser/DOMParser.js';
 import XMLSerializer from '../xml-serializer/XMLSerializer.js';
 import ResizeObserver from '../resize-observer/ResizeObserver.js';
@@ -126,12 +127,17 @@ import RadioNodeList from '../nodes/html-form-element/RadioNodeList.js';
 import ValidityState from '../validity-state/ValidityState.js';
 import INodeJSGlobal from './INodeJSGlobal.js';
 import VirtualConsolePrinter from '../console/VirtualConsolePrinter.js';
+import Permissions from '../permissions/Permissions.js';
+import PermissionStatus from '../permissions/PermissionStatus.js';
+import Clipboard from '../clipboard/Clipboard.js';
+import ClipboardItem from '../clipboard/ClipboardItem.js';
+import ClipboardEvent from '../event/events/ClipboardEvent.js';
 
 /**
  * Window without dependencies to server side specific packages.
  */
 export default interface IWindow extends IEventTarget, INodeJSGlobal {
-	// Public Properties
+	// Happy DOM property.
 	readonly happyDOM: {
 		whenAsyncComplete: () => Promise<void>;
 		cancelAsync: () => void;
@@ -152,8 +158,24 @@ export default interface IWindow extends IEventTarget, INodeJSGlobal {
 		setInnerHeight: (height: number) => void;
 	};
 
-	// Global classes
+	// Nodes
 	readonly Node: typeof Node;
+	readonly Attr: typeof Attr;
+	readonly SVGSVGElement: typeof SVGSVGElement;
+	readonly SVGElement: typeof SVGElement;
+	readonly Text: typeof Text;
+	readonly Comment: typeof Comment;
+	readonly ShadowRoot: typeof ShadowRoot;
+	readonly Element: typeof Element;
+	readonly DocumentFragment: typeof DocumentFragment;
+	readonly CharacterData: typeof CharacterData;
+	readonly ProcessingInstruction: typeof ProcessingInstruction;
+	readonly Document: typeof Document;
+	readonly HTMLDocument: typeof HTMLDocument;
+	readonly XMLDocument: typeof XMLDocument;
+	readonly SVGDocument: typeof SVGDocument;
+
+	// Element classes
 	readonly HTMLElement: typeof HTMLElement;
 	readonly HTMLUnknownElement: typeof HTMLUnknownElement;
 	readonly HTMLTemplateElement: typeof HTMLTemplateElement;
@@ -174,27 +196,61 @@ export default interface IWindow extends IEventTarget, INodeJSGlobal {
 	readonly HTMLBaseElement: typeof HTMLBaseElement;
 	readonly HTMLIFrameElement: typeof HTMLIFrameElement;
 	readonly HTMLDialogElement: typeof HTMLDialogElement;
-	readonly Attr: typeof Attr;
-	readonly NamedNodeMap: typeof NamedNodeMap;
-	readonly SVGSVGElement: typeof SVGSVGElement;
-	readonly SVGElement: typeof SVGElement;
-	readonly Image: typeof Image;
-	readonly Text: typeof Text;
-	readonly Comment: typeof Comment;
-	readonly ShadowRoot: typeof ShadowRoot;
-	readonly Element: typeof Element;
-	readonly DocumentFragment: typeof DocumentFragment;
-	readonly CharacterData: typeof CharacterData;
-	readonly ProcessingInstruction: typeof ProcessingInstruction;
-	readonly NodeFilter: typeof NodeFilter;
-	readonly NodeIterator: typeof NodeIterator;
-	readonly TreeWalker: typeof TreeWalker;
-	readonly DOMParser: typeof DOMParser;
-	readonly MutationObserver: typeof MutationObserver;
-	readonly Document: typeof Document;
-	readonly HTMLDocument: typeof HTMLDocument;
-	readonly XMLDocument: typeof XMLDocument;
-	readonly SVGDocument: typeof SVGDocument;
+
+	/**
+	 * Non-implemented element classes
+	 */
+	readonly HTMLHeadElement: typeof HTMLElement;
+	readonly HTMLTitleElement: typeof HTMLElement;
+	readonly HTMLBodyElement: typeof HTMLElement;
+	readonly HTMLHeadingElement: typeof HTMLElement;
+	readonly HTMLParagraphElement: typeof HTMLElement;
+	readonly HTMLHRElement: typeof HTMLElement;
+	readonly HTMLPreElement: typeof HTMLElement;
+	readonly HTMLUListElement: typeof HTMLElement;
+	readonly HTMLOListElement: typeof HTMLElement;
+	readonly HTMLLIElement: typeof HTMLElement;
+	readonly HTMLMenuElement: typeof HTMLElement;
+	readonly HTMLDListElement: typeof HTMLElement;
+	readonly HTMLDivElement: typeof HTMLElement;
+	readonly HTMLAnchorElement: typeof HTMLElement;
+	readonly HTMLAreaElement: typeof HTMLElement;
+	readonly HTMLBRElement: typeof HTMLElement;
+	readonly HTMLButtonElement: typeof HTMLElement;
+	readonly HTMLCanvasElement: typeof HTMLElement;
+	readonly HTMLDataElement: typeof HTMLElement;
+	readonly HTMLDataListElement: typeof HTMLElement;
+	readonly HTMLDetailsElement: typeof HTMLElement;
+	readonly HTMLDirectoryElement: typeof HTMLElement;
+	readonly HTMLFieldSetElement: typeof HTMLElement;
+	readonly HTMLFontElement: typeof HTMLElement;
+	readonly HTMLHtmlElement: typeof HTMLElement;
+	readonly HTMLLegendElement: typeof HTMLElement;
+	readonly HTMLMapElement: typeof HTMLElement;
+	readonly HTMLMarqueeElement: typeof HTMLElement;
+	readonly HTMLMeterElement: typeof HTMLElement;
+	readonly HTMLModElement: typeof HTMLElement;
+	readonly HTMLOutputElement: typeof HTMLElement;
+	readonly HTMLPictureElement: typeof HTMLElement;
+	readonly HTMLProgressElement: typeof HTMLElement;
+	readonly HTMLQuoteElement: typeof HTMLElement;
+	readonly HTMLSourceElement: typeof HTMLElement;
+	readonly HTMLSpanElement: typeof HTMLElement;
+	readonly HTMLTableCaptionElement: typeof HTMLElement;
+	readonly HTMLTableCellElement: typeof HTMLElement;
+	readonly HTMLTableColElement: typeof HTMLElement;
+	readonly HTMLTableElement: typeof HTMLElement;
+	readonly HTMLTimeElement: typeof HTMLElement;
+	readonly HTMLTableRowElement: typeof HTMLElement;
+	readonly HTMLTableSectionElement: typeof HTMLElement;
+	readonly HTMLFrameElement: typeof HTMLElement;
+	readonly HTMLFrameSetElement: typeof HTMLElement;
+	readonly HTMLEmbedElement: typeof HTMLElement;
+	readonly HTMLObjectElement: typeof HTMLElement;
+	readonly HTMLParamElement: typeof HTMLElement;
+	readonly HTMLTrackElement: typeof HTMLElement;
+
+	// Event classes
 	readonly Event: typeof Event;
 	readonly UIEvent: typeof UIEvent;
 	readonly CustomEvent: typeof CustomEvent;
@@ -212,6 +268,55 @@ export default interface IWindow extends IEventTarget, INodeJSGlobal {
 	readonly MessagePort: typeof MessagePort;
 	readonly ProgressEvent: typeof ProgressEvent;
 	readonly MediaQueryListEvent: typeof MediaQueryListEvent;
+	readonly ClipboardEvent: typeof ClipboardEvent;
+
+	/**
+	 * Non-implemented event classes
+	 */
+	readonly AudioProcessingEvent: typeof Event;
+	readonly BeforeInputEvent: typeof Event;
+	readonly BeforeUnloadEvent: typeof Event;
+	readonly BlobEvent: typeof Event;
+	readonly CloseEvent: typeof Event;
+	readonly CompositionEvent: typeof Event;
+	readonly CSSFontFaceLoadEvent: typeof Event;
+	readonly DeviceLightEvent: typeof Event;
+	readonly DeviceMotionEvent: typeof Event;
+	readonly DeviceOrientationEvent: typeof Event;
+	readonly DeviceProximityEvent: typeof Event;
+	readonly DOMTransactionEvent: typeof Event;
+	readonly DragEvent: typeof Event;
+	readonly EditingBeforeInputEvent: typeof Event;
+	readonly FetchEvent: typeof Event;
+	readonly GamepadEvent: typeof Event;
+	readonly HashChangeEvent: typeof Event;
+	readonly IDBVersionChangeEvent: typeof Event;
+	readonly MediaStreamEvent: typeof Event;
+	readonly MutationEvent: typeof Event;
+	readonly OfflineAudioCompletionEvent: typeof Event;
+	readonly OverconstrainedError: typeof Event;
+	readonly PageTransitionEvent: typeof Event;
+	readonly PaymentRequestUpdateEvent: typeof Event;
+	readonly PopStateEvent: typeof Event;
+	readonly RelatedEvent: typeof Event;
+	readonly RTCDataChannelEvent: typeof Event;
+	readonly RTCIdentityErrorEvent: typeof Event;
+	readonly RTCIdentityEvent: typeof Event;
+	readonly RTCPeerConnectionIceEvent: typeof Event;
+	readonly SensorEvent: typeof Event;
+	readonly SVGEvent: typeof Event;
+	readonly SVGZoomEvent: typeof Event;
+	readonly TimeEvent: typeof Event;
+	readonly TouchEvent: typeof Event;
+	readonly TrackEvent: typeof Event;
+	readonly TransitionEvent: typeof Event;
+	readonly UserProximityEvent: typeof Event;
+	readonly WebGLContextEvent: typeof Event;
+	readonly TextEvent: typeof Event;
+
+	// Other classes
+	readonly Image: typeof Image;
+	readonly NamedNodeMap: typeof NamedNodeMap;
 	readonly EventTarget: typeof EventTarget;
 	readonly DataTransfer: typeof DataTransfer;
 	readonly DataTransferItem: typeof DataTransferItem;
@@ -268,6 +373,17 @@ export default interface IWindow extends IEventTarget, INodeJSGlobal {
 	readonly AbortSignal: typeof AbortSignal;
 	readonly RadioNodeList: typeof RadioNodeList;
 	readonly ValidityState: typeof ValidityState;
+	readonly Permissions: typeof Permissions;
+	readonly PermissionStatus: typeof PermissionStatus;
+	readonly Clipboard: typeof Clipboard;
+	readonly ClipboardItem: typeof ClipboardItem;
+
+	readonly NodeFilter: typeof NodeFilter;
+	readonly NodeIterator: typeof NodeIterator;
+	readonly TreeWalker: typeof TreeWalker;
+	readonly DOMParser: typeof DOMParser;
+	readonly MutationObserver: typeof MutationObserver;
+	readonly MutationRecord: typeof MutationRecord;
 
 	// Events
 	onload: (event: Event) => void;