buninu-browser 0.0.2

package/vendor/happy-dom/packages/happy-dom/src/form-data/FormData.ts

@@ -0,0 +1,291 @@
+import Blob from '../file/Blob.js';
+import * as PropertySymbol from '../PropertySymbol.js';
+import File from '../file/File.js';
+import type HTMLInputElement from '../nodes/html-input-element/HTMLInputElement.js';
+import type HTMLFormElement from '../nodes/html-form-element/HTMLFormElement.js';
+import type BrowserWindow from '../window/BrowserWindow.js';
+import type HTMLButtonElement from '../nodes/html-button-element/HTMLButtonElement.js';
+import DOMExceptionNameEnum from '../exception/DOMExceptionNameEnum.js';
+
+type FormDataEntry = {
+	name: string;
+	value: string | File;
+};
+
+/**
+ * FormData.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/FormData
+ */
+export default class FormData implements Iterable<[string, string | File]> {
+	// Injected by WindowContextClassExtender
+	protected declare [PropertySymbol.window]: BrowserWindow;
+
+	#entries: FormDataEntry[] = [];
+
+	/**
+	 * Constructor.
+	 *
+	 * @param [form] Form.
+	 * @param [submitter] The element that triggered the submission if this came from a form submit.
+	 */
+	constructor(form?: HTMLFormElement, submitter?: HTMLInputElement | HTMLButtonElement) {
+		if (!form) {
+			return;
+		}
+
+		if (submitter) {
+			const formProxy = form[PropertySymbol.proxy] ? form[PropertySymbol.proxy] : form;
+			if (submitter.form !== formProxy) {
+				throw new this[PropertySymbol.window].DOMException(
+					'The specified element is not owned by this form element',
+					DOMExceptionNameEnum.notFoundError
+				);
+			}
+			const isSubmitButton =
+				(submitter[PropertySymbol.tagName] === 'INPUT' &&
+					(submitter.type === 'submit' || submitter.type === 'image')) ||
+				(submitter[PropertySymbol.tagName] === 'BUTTON' && submitter.type === 'submit');
+			if (!isSubmitButton) {
+				throw new this[PropertySymbol.window].TypeError(
+					'The specified element is not a submit button'
+				);
+			}
+		}
+
+		const items = form[PropertySymbol.getFormControlItems]();
+
+		for (const item of items) {
+			const name = item.name;
+
+			if (name) {
+				switch (item[PropertySymbol.tagName]) {
+					case 'INPUT':
+						if ((<HTMLInputElement>item).disabled) {
+							break;
+						}
+
+						switch ((<HTMLInputElement>item).type) {
+							case 'file':
+								if ((<HTMLInputElement>item)[PropertySymbol.files].length === 0) {
+									this.append(name, new File([], '', { type: 'application/octet-stream' }));
+								} else {
+									for (const file of (<HTMLInputElement>item)[PropertySymbol.files]) {
+										this.append(name, file);
+									}
+								}
+								break;
+							case 'checkbox':
+							case 'radio':
+								if ((<HTMLInputElement>item).checked) {
+									this.append(name, (<HTMLInputElement>item).value);
+								}
+								break;
+							case 'submit':
+							case 'reset':
+							case 'button':
+								if (item === submitter && (<HTMLInputElement>item).value) {
+									this.append(name, (<HTMLInputElement>item).value);
+								}
+								break;
+							default:
+								this.append(name, (<HTMLInputElement>item).value);
+								break;
+						}
+						break;
+					case 'BUTTON':
+						if (item === submitter && (<HTMLButtonElement>item).value) {
+							this.append(name, (<HTMLButtonElement>item).value);
+						}
+						break;
+					case 'TEXTAREA':
+					case 'SELECT':
+						this.append(name, (<HTMLInputElement>item).value);
+						break;
+				}
+			}
+		}
+	}
+
+	/**
+	 * For each.
+	 *
+	 * @param callback Callback.
+	 * @param thisArg thisArg.
+	 */
+	public forEach(
+		callback: (value: string | File, key: string, parent: this) => void,
+		thisArg?: any
+	): void {
+		for (const entry of this.#entries) {
+			callback.call(thisArg, entry.value, entry.name, this);
+		}
+	}
+
+	/**
+	 * Appends a new value onto an existing key.
+	 *
+	 * @param name Name.
+	 * @param value Value.
+	 * @param [filename] Filename.
+	 */
+	public append(name: string, value: string | Blob | File, filename?: string): void {
+		if (filename && !(value instanceof Blob)) {
+			throw new this[PropertySymbol.window].TypeError(
+				'Failed to execute "append" on "FormData": parameter 2 is not of type "Blob".'
+			);
+		}
+		this.#entries.push({
+			name,
+			value: this.#parseValue(value, filename)
+		});
+	}
+
+	/**
+	 * Removes a value.
+	 *
+	 * @param name Name.
+	 */
+	public delete(name: string): void {
+		const newEntries: FormDataEntry[] = [];
+		for (const entry of this.#entries) {
+			if (entry.name !== name) {
+				newEntries.push(entry);
+			}
+		}
+		this.#entries = newEntries;
+	}
+
+	/**
+	 * Returns value.
+	 *
+	 * @param name Name.
+	 * @returns Value.
+	 */
+	public get(name: string): string | File | null {
+		for (const entry of this.#entries) {
+			if (entry.name === name) {
+				return entry.value;
+			}
+		}
+		return null;
+	}
+
+	/**
+	 * Returns all values associated with the given name.
+	 *
+	 * @param name Name.
+	 * @returns Values.
+	 */
+	public getAll(name: string): Array<string | File> {
+		const values: Array<string | File> = [];
+		for (const entry of this.#entries) {
+			if (entry.name === name) {
+				values.push(entry.value);
+			}
+		}
+		return values;
+	}
+
+	/**
+	 * Returns whether a FormData object contains a certain key.
+	 *
+	 * @param name Name.
+	 * @returns "true" if the FormData object contains the key.
+	 */
+	public has(name: string): boolean {
+		for (const entry of this.#entries) {
+			if (entry.name === name) {
+				return true;
+			}
+		}
+		return false;
+	}
+
+	/**
+	 * Sets a new value for an existing key inside a FormData object, or adds the key/value if it does not already exist.
+	 *
+	 * @param name Name.
+	 * @param value Value.
+	 * @param [filename] Filename.
+	 */
+	public set(name: string, value: string | Blob | File, filename?: string): void {
+		for (const entry of this.#entries) {
+			if (entry.name === name) {
+				entry.value = this.#parseValue(value, filename);
+				return;
+			}
+		}
+		this.append(name, value);
+	}
+
+	/**
+	 * Returns an iterator, allowing you to go through all keys of the key/value pairs contained in this object.
+	 *
+	 * @returns Iterator.
+	 */
+	public *keys(): ArrayIterator<string> {
+		for (const entry of this.#entries) {
+			yield entry.name;
+		}
+	}
+
+	/**
+	 * Returns an iterator, allowing you to go through all values of the key/value pairs contained in this object.
+	 *
+	 * @returns Iterator.
+	 */
+	public *values(): ArrayIterator<string | File> {
+		for (const entry of this.#entries) {
+			yield entry.value;
+		}
+	}
+
+	/**
+	 * Returns an iterator, allowing you to go through all key/value pairs contained in this object.
+	 *
+	 * @returns Iterator.
+	 */
+	public *entries(): ArrayIterator<[string, string | File]> {
+		for (const entry of this.#entries) {
+			yield [entry.name, entry.value];
+		}
+	}
+
+	/**
+	 * Iterator.
+	 *
+	 * @returns Iterator.
+	 */
+	public *[Symbol.iterator](): ArrayIterator<[string, string | File]> {
+		for (const entry of this.#entries) {
+			yield [entry.name, entry.value];
+		}
+	}
+
+	/**
+	 * Parses a value.
+	 *
+	 * @param value Value.
+	 * @param [filename] Filename.
+	 * @returns Parsed value.
+	 */
+	#parseValue(value: string | Blob | File, filename?: string): string | File {
+		if (value instanceof File) {
+			if (filename) {
+				const file = new File([], filename, { type: value.type, lastModified: value.lastModified });
+				file[PropertySymbol.buffer] = value[PropertySymbol.buffer];
+				return file;
+			}
+			return value;
+		}
+
+		if (value instanceof Blob) {
+			const file = new File([], 'blob', { type: value.type });
+			file[PropertySymbol.buffer] = value[PropertySymbol.buffer];
+			return file;
+		}
+
+		return String(value);
+	}
+}

package/vendor/happy-dom/packages/happy-dom/src/history/History.ts

@@ -0,0 +1,220 @@
+import type IBrowserFrame from '../browser/types/IBrowserFrame.js';
+import HistoryScrollRestorationEnum from './HistoryScrollRestorationEnum.js';
+import * as PropertySymbol from '../PropertySymbol.js';
+import BrowserFrameURL from '../browser/utilities/BrowserFrameURL.js';
+import DOMExceptionNameEnum from '../exception/DOMExceptionNameEnum.js';
+import type BrowserWindow from '../window/BrowserWindow.js';
+
+/**
+ * History API.
+ *
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/History.
+ */
+export default class History {
+	#browserFrame: IBrowserFrame | null;
+	#window: BrowserWindow;
+
+	/**
+	 * Constructor.
+	 *
+	 * @param browserFrame Browser frame.
+	 * @param window Owner window.
+	 */
+	constructor(browserFrame: IBrowserFrame, window: BrowserWindow) {
+		if (!browserFrame) {
+			throw new TypeError('Illegal constructor');
+		}
+
+		this.#browserFrame = browserFrame;
+		this.#window = window;
+	}
+
+	/**
+	 * Returns the history length.
+	 *
+	 * @returns History length.
+	 */
+	public get length(): number {
+		return this.#browserFrame?.[PropertySymbol.history].items.length || 0;
+	}
+
+	/**
+	 * Returns an any value representing the state at the top of the history stack. This is a way to look at the state without having to wait for a popstate event.
+	 *
+	 * @returns State.
+	 */
+	public get state(): object | null {
+		return this.#browserFrame?.[PropertySymbol.history].currentItem.state || null;
+	}
+
+	/**
+	 * Returns scroll restoration.
+	 *
+	 * @returns Sroll restoration.
+	 */
+	public get scrollRestoration(): HistoryScrollRestorationEnum {
+		return (
+			this.#browserFrame?.[PropertySymbol.history].currentItem.scrollRestoration ||
+			HistoryScrollRestorationEnum.auto
+		);
+	}
+
+	/**
+	 * Sets scroll restoration.
+	 *
+	 * @param scrollRestoration Sroll restoration.
+	 */
+	public set scrollRestoration(scrollRestoration: HistoryScrollRestorationEnum) {
+		switch (scrollRestoration) {
+			case HistoryScrollRestorationEnum.auto:
+			case HistoryScrollRestorationEnum.manual:
+				const currentItem = this.#browserFrame?.[PropertySymbol.history].currentItem;
+				if (currentItem) {
+					currentItem.scrollRestoration = scrollRestoration;
+				}
+				break;
+		}
+	}
+
+	/**
+	 * Goes to the previous page in session history.
+	 */
+	public back(): void {
+		if (!this.#window.closed) {
+			this.#browserFrame?.goBack();
+		}
+	}
+
+	/**
+	 * Goes to the next page in session history.
+	 */
+	public forward(): void {
+		if (!this.#window.closed) {
+			this.#browserFrame?.goForward();
+		}
+	}
+
+	/**
+	 * Load a specific page from the session history.
+	 *
+	 * @param delta Delta.
+	 * @param _delta
+	 */
+	public go(delta: number): void {
+		if (!this.#window.closed) {
+			this.#browserFrame?.goSteps(delta);
+		}
+	}
+
+	/**
+	 * Pushes the given data onto the session history stack.
+	 *
+	 * @param state State.
+	 * @param _unused Unused.
+	 * @param [url] URL.
+	 */
+	public pushState(state: any, _unused: any, url?: string | URL): void {
+		if (!this.#browserFrame || this.#window.closed) {
+			return;
+		}
+
+		const history = this.#browserFrame?.[PropertySymbol.history];
+
+		if (!history) {
+			return;
+		}
+
+		if (arguments.length < 2) {
+			throw new this.#window.TypeError(
+				`Failed to execute 'pushState' on 'History': 2 arguments required, but only ${arguments.length} present.`
+			);
+		}
+
+		const location = this.#window[PropertySymbol.location];
+		const newURL = url ? BrowserFrameURL.getRelativeURL(this.#browserFrame, url) : location;
+
+		if (url && newURL.origin !== location.origin) {
+			throw new this.#window.DOMException(
+				`Failed to execute 'pushState' on 'History': A history state object with URL '${url.toString()}' cannot be created in a document with origin '${
+					location.origin
+				}' and URL '${location.href}'.`,
+				DOMExceptionNameEnum.securityError
+			);
+		}
+
+		history.currentItem.popState = true;
+
+		history.push({
+			title: this.#window.document.title,
+			href: newURL.href,
+			state,
+			popState: true,
+			scrollRestoration: history.currentItem.scrollRestoration,
+			method: history.currentItem.method || 'GET',
+			formData: history.currentItem.formData || null
+		});
+
+		location[PropertySymbol.setURL](this.#browserFrame, history.currentItem.href);
+	}
+
+	/**
+	 * This method modifies the current history entry, replacing it with a new state.
+	 *
+	 * @param state State.
+	 * @param _unused Unused.
+	 * @param [url] URL.
+	 */
+	public replaceState(state: any, _unused: any, url?: string | URL): void {
+		if (!this.#browserFrame || this.#window.closed) {
+			return;
+		}
+
+		const history = this.#browserFrame?.[PropertySymbol.history];
+
+		if (!history) {
+			return;
+		}
+
+		if (arguments.length < 2) {
+			throw new this.#window.TypeError(
+				`Failed to execute 'pushState' on 'History': 2 arguments required, but only ${arguments.length} present.`
+			);
+		}
+
+		const location = this.#window[PropertySymbol.location];
+		const newURL = url ? BrowserFrameURL.getRelativeURL(this.#browserFrame, url) : location;
+
+		if (url && newURL.origin !== location.origin) {
+			throw new this.#window.DOMException(
+				`Failed to execute 'pushState' on 'History': A history state object with URL '${url.toString()}' cannot be created in a document with origin '${
+					location.origin
+				}' and URL '${location.href}'.`,
+				DOMExceptionNameEnum.securityError
+			);
+		}
+
+		history.replace({
+			title: this.#window.document.title,
+			href: newURL.href,
+			state,
+			popState: history.currentItem.popState,
+			scrollRestoration: history.currentItem.scrollRestoration,
+			method: history.currentItem.method,
+			formData: history.currentItem.formData
+		});
+
+		if (url) {
+			location[PropertySymbol.setURL](this.#browserFrame, history.currentItem.href);
+		}
+	}
+
+	/**
+	 * Destroys the history.
+	 *
+	 * This will make sure that the History API can't access page data from the next history item.
+	 */
+	public [PropertySymbol.destroy](): void {
+		this.#browserFrame = null;
+	}
+}

package/vendor/happy-dom/packages/happy-dom/src/history/HistoryItemList.ts

@@ -0,0 +1,72 @@
+import HistoryScrollRestorationEnum from './HistoryScrollRestorationEnum.js';
+import type IHistoryItem from './IHistoryItem.js';
+
+/**
+ * History item list.
+ */
+export default class HistoryItemList {
+	public currentItem: IHistoryItem = {
+		title: '',
+		href: 'about:blank',
+		state: null,
+		popState: false,
+		scrollRestoration: HistoryScrollRestorationEnum.auto,
+		method: 'GET',
+		formData: null
+	};
+	public readonly items: IHistoryItem[] = [this.currentItem];
+
+	/**
+	 * History item list.
+	 *
+	 * @param historyItem History item.
+	 */
+	public push(historyItem: IHistoryItem): void {
+		const index = this.items.indexOf(this.currentItem);
+
+		// If the current item is not the last one, remove all items after it.
+		if (index !== this.items.length - 1) {
+			this.items.length = index + 1;
+		}
+
+		this.items.push(historyItem);
+		this.currentItem = historyItem;
+	}
+
+	/**
+	 *
+	 * @param historyItem
+	 */
+	public replace(historyItem: IHistoryItem): void {
+		const index = this.items.indexOf(this.currentItem);
+
+		// If the current item is not the last one, remove all items after it.
+		if (index !== this.items.length - 1) {
+			this.items.length = index + 1;
+		}
+
+		if (index === -1) {
+			throw new Error('Current history item not found');
+		}
+
+		this.currentItem = historyItem;
+		this.items[index] = historyItem;
+	}
+
+	/**
+	 * Clears history and sets current item to "about:blank".
+	 */
+	public clear(): void {
+		this.items.length = 0;
+		this.currentItem = {
+			title: '',
+			href: 'about:blank',
+			state: null,
+			popState: false,
+			scrollRestoration: HistoryScrollRestorationEnum.auto,
+			method: 'GET',
+			formData: null
+		};
+		this.items.push(this.currentItem);
+	}
+}

package/vendor/happy-dom/packages/happy-dom/src/history/HistoryScrollRestorationEnum.ts

@@ -0,0 +1,5 @@
+enum HistoryScrollRestorationEnum {
+	auto = 'auto',
+	manual = 'manual'
+}
+export default HistoryScrollRestorationEnum;

package/vendor/happy-dom/packages/happy-dom/src/history/IHistoryItem.ts

@@ -0,0 +1,12 @@
+import type FormData from '../form-data/FormData.js';
+import type HistoryScrollRestorationEnum from './HistoryScrollRestorationEnum.js';
+
+export default interface IHistoryItem {
+	title: string | null;
+	href: string;
+	state: any | null;
+	popState: boolean;
+	scrollRestoration: HistoryScrollRestorationEnum;
+	method: string;
+	formData: FormData | null;
+}