#833@minor: Adds support for Window.navigator.clipboard and Window.na…

…vigator.permissions. Improves support for DataTransfer.

packages/happy-dom/src/clipboard/Clipboard.ts

@@ -0,0 +1,92 @@
+import DOMException from '../exception/DOMException.js';
+import IWindow from '../window/IWindow.js';
+import ClipboardItem from './ClipboardItem.js';
+import Blob from '../file/Blob.js';
+
+/**
+ * Clipboard API.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/Clipboard.
+ */
+export default class Clipboard {
+	#ownerWindow: IWindow;
+	#data: ClipboardItem[] = [];
+
+	/**
+	 * Constructor.
+	 *
+	 * @param ownerWindow Owner window.
+	 */
+	constructor(ownerWindow: IWindow) {
+		this.#ownerWindow = ownerWindow;
+	}
+
+	/**
+	 * Returns data.
+	 *
+	 * @returns Data.
+	 */
+	public async read(): Promise<ClipboardItem[]> {
+		const permissionStatus = await this.#ownerWindow.navigator.permissions.query({
+			name: 'clipboard-read'
+		});
+		if (permissionStatus.state === 'denied') {
+			throw new DOMException(`Failed to execute 'read' on 'Clipboard': The request is not allowed`);
+		}
+		return this.#data;
+	}
+
+	/**
+	 * Returns text.
+	 *
+	 * @returns Text.
+	 */
+	public async readText(): Promise<string> {
+		const permissionStatus = await this.#ownerWindow.navigator.permissions.query({
+			name: 'clipboard-read'
+		});
+		if (permissionStatus.state === 'denied') {
+			throw new DOMException(`Failed to execute 'read' on 'Clipboard': The request is not allowed`);
+		}
+		let text = '';
+		for (const item of this.#data) {
+			text += await (await item.getType('text/plain')).text();
+		}
+		return text;
+	}
+
+	/**
+	 * Writes data.
+	 *
+	 * @param data Data.
+	 */
+	public async write(data: ClipboardItem[]): Promise<void> {
+		const permissionStatus = await this.#ownerWindow.navigator.permissions.query({
+			name: 'clipboard-write'
+		});
+		if (permissionStatus.state === 'denied') {
+			throw new DOMException(
+				`Failed to execute 'write' on 'Clipboard': The request is not allowed`
+			);
+		}
+		this.#data = data;
+	}
+
+	/**
+	 * Writes text.
+	 *
+	 * @param text Text.
+	 */
+	public async writeText(text: string): Promise<void> {
+		const permissionStatus = await this.#ownerWindow.navigator.permissions.query({
+			name: 'clipboard-write'
+		});
+		if (permissionStatus.state === 'denied') {
+			throw new DOMException(
+				`Failed to execute 'write' on 'Clipboard': The request is not allowed`
+			);
+		}
+		this.#data = [new ClipboardItem({ 'text/plain': new Blob([text], { type: 'text/plain' }) })];
+	}
+}

packages/happy-dom/src/clipboard/ClipboardItem.ts

@@ -0,0 +1,59 @@
+import DOMException from '../exception/DOMException.js';
+import Blob from '../file/Blob.js';
+
+/**
+ * Clipboard Item API.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/ClipboardItem.
+ */
+export default class ClipboardItem {
+	public readonly presentationStyle: 'unspecified' | 'inline' | 'attachment' = 'unspecified';
+	#data: { [mimeType: string]: Blob };
+
+	/**
+	 * Constructor.
+	 *
+	 * @param data Data.
+	 * @param [options] Options.
+	 * @param [options.presentationStyle] Presentation style.
+	 */
+	constructor(
+		data: { [mimeType: string]: Blob },
+		options?: { presentationStyle?: 'unspecified' | 'inline' | 'attachment' }
+	) {
+		for (const mimeType of Object.keys(data)) {
+			if (mimeType !== data[mimeType].type) {
+				throw new DOMException(`Type ${mimeType} does not match the blob's type`);
+			}
+		}
+		this.#data = data;
+		if (options?.presentationStyle) {
+			this.presentationStyle = options.presentationStyle;
+		}
+	}
+
+	/**
+	 * Returns types.
+	 *
+	 * @returns Types.
+	 */
+	public get types(): string[] {
+		return Object.keys(this.#data);
+	}
+
+	/**
+	 * Returns data by type.
+	 *
+	 * @param type Type.
+	 * @returns Data.
+	 */
+	public async getType(type: string): Promise<Blob> {
+		if (!this.#data[type]) {
+			throw new DOMException(
+				"Failed to execute 'getType' on 'ClipboardItem': The type was not found"
+			);
+		}
+		return this.#data[type];
+	}
+}

packages/happy-dom/src/event/DataTransfer.ts

@@ -7,7 +7,21 @@ import DataTransferItemList from './DataTransferItemList.js';
 export default class DataTransfer {
 	public dropEffect = 'none';
 	public effectAllowed = 'none';
-	public files: File[] = [];
 	public readonly items: DataTransferItemList = new DataTransferItemList();
 	public readonly types: string[] = [];
+
+	/**
+	 * Returns files.
+	 *
+	 * @returns Files.
+	 */
+	public get files(): File[] {
+		const files = [];
+		for (const item of this.items) {
+			if (item.kind === 'file') {
+				files.push(item.getAsFile());
+			}
+		}
+		return files;
+	}
 }

packages/happy-dom/src/event/DataTransferItem.ts

@@ -1,21 +1,26 @@
 import File from '../file/File.js';
 
 /**
+ * Data transfer item.
  *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/DataTransferItem.
  */
 export default class DataTransferItem {
-	public readonly kind: string = '';
-	public readonly type: string = '';
-	private _item: string | File = null;
+	public readonly kind: 'string' | 'file';
+	public readonly type: string;
+	#item: string | File = null;
 
 	/**
 	 * Constructor.
 	 *
 	 * @param item Item.
+	 * @param type Type.
 	 */
-	constructor(item: string | File) {
+	constructor(item: string | File, type?: string) {
 		this.kind = typeof item === 'string' ? 'string' : 'file';
-		this._item = item;
+		this.type = type ?? (this.kind === 'string' ? '' : (<File>item).type);
+		this.#item = item;
 	}
 
 	/**
@@ -25,16 +30,18 @@ export default class DataTransferItem {
 		if (this.kind === 'string') {
 			return null;
 		}
-		return <File>this._item;
+		return <File>this.#item;
 	}
 
 	/**
 	 * Returns string.
+	 *
+	 * @param callback Callback.
 	 */
-	public getAsString(): string {
+	public getAsString(callback: (text: string) => void): void {
 		if (this.kind === 'file') {
-			return null;
+			callback;
 		}
-		return <string>this._item;
+		callback(<string>this.#item);
 	}
 }

packages/happy-dom/src/event/DataTransferItemList.ts

@@ -4,16 +4,20 @@ import DataTransferItem from './DataTransferItem.js';
 /**
  *
  */
-export default class DataTransferItemList {
-	public readonly DataTransferItem: DataTransferItem[] = [];
-
+export default class DataTransferItemList extends Array<DataTransferItem> {
 	/**
 	 * Adds an item.
 	 *
 	 * @param item Item.
+	 * @param type Type.
 	 */
-	public add(item: File | string): void {
-		this.DataTransferItem.push(new DataTransferItem(item));
+	public add(item: File | string, type?: string): void {
+		if (!type && !(item instanceof File)) {
+			throw new TypeError(
+				`Failed to execute 'add' on 'DataTransferItemList': parameter 1 is not of type 'File'.`
+			);
+		}
+		this.push(new DataTransferItem(item, type));
 	}
 
 	/**
@@ -22,13 +26,15 @@ export default class DataTransferItemList {
 	 * @param index Index.
 	 */
 	public remove(index: number): void {
-		this.DataTransferItem.splice(index, 1);
+		this.splice(index, 1);
 	}
 
 	/**
 	 * Clears list.
 	 */
 	public clear(): void {
-		(<DataTransferItem[]>this.DataTransferItem) = [];
+		while (this.length) {
+			this.pop();
+		}
 	}
 }

packages/happy-dom/src/event/events/ClipboardEvent.ts

@@ -0,0 +1,22 @@
+import DataTransfer from '../DataTransfer.js';
+import Event from '../Event.js';
+import IClipboardEventInit from './IClipboardEventInit.js';
+
+/**
+ *
+ */
+export default class ClipboardEvent extends Event {
+	public clipboardData: DataTransfer | null;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param type Event type.
+	 * @param [eventInit] Event init.
+	 */
+	constructor(type: string, eventInit: IClipboardEventInit | null = null) {
+		super(type, eventInit);
+
+		this.clipboardData = eventInit?.clipboardData ?? null;
+	}
+}