happy-dom 2.50.0 → 2.51.0

package/src/fetch/ResourceFetchHandler.ts

@@ -0,0 +1,47 @@
+import RelativeURL from '../location/RelativeURL';
+import DOMException from '../exception/DOMException';
+import IDocument from '../nodes/document/IDocument';
+
+/**
+ * Helper class for performing fetch of resources.
+ */
+export default class ResourceFetchHandler {
+	/**
+	 * Returns resource data asynchonously.
+	 *
+	 * @param document Document.
+	 * @param url URL.
+	 * @returns Response.
+	 */
+	public static async fetch(document: IDocument, url: string): Promise<string> {
+		const response = await document.defaultView.fetch(url);
+		if (!response.ok) {
+			throw new DOMException(
+				`Failed to perform request to "${url}". Status code: ${response.status}`
+			);
+		}
+		return await response.text();
+	}
+
+	/**
+	 * Returns resource data synchonously.
+	 *
+	 * @param document Document.
+	 * @param url URL.
+	 * @returns Response.
+	 */
+	public static fetchSync(document: IDocument, url: string): string {
+		// We want to only load SyncRequest when it is needed to improve performance and not have direct dependencies to server side packages.
+		const syncRequest = require('sync-request');
+		const absoluteURL = RelativeURL.getAbsoluteURL(document.defaultView.location, url);
+		const response = syncRequest('GET', absoluteURL);
+
+		if (response.isError()) {
+			throw new DOMException(
+				`Failed to perform request to "${absoluteURL}". Status code: ${response.statusCode}`
+			);
+		}
+
+		return response.getBody();
+	}
+}

package/src/fetch/Response.ts

@@ -0,0 +1,149 @@
+import IResponse from './IResponse';
+import IBlob from '../file/IBlob';
+import IDocument from '../nodes/document/IDocument';
+import * as NodeFetch from 'node-fetch';
+
+/**
+ * Fetch response.
+ */
+export default class Response extends NodeFetch.Response implements IResponse {
+	public static _ownerDocument: IDocument = null;
+
+	/**
+	 * Returns array buffer.
+	 *
+	 * @returns Array buffer.
+	 */
+	public arrayBuffer(): Promise<ArrayBuffer> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.arrayBuffer()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns blob.
+	 *
+	 * @returns Blob.
+	 */
+	public blob(): Promise<IBlob> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.blob()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns buffer.
+	 *
+	 * @returns Buffer.
+	 */
+	public buffer(): Promise<Buffer> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.buffer()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns json.
+	 *
+	 * @returns JSON.
+	 */
+	public json(): Promise<unknown> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.json()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns json.
+	 *
+	 * @returns JSON.
+	 */
+	public text(): Promise<string> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.text()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Returns json.
+	 *
+	 * @returns JSON.
+	 */
+	public textConverted(): Promise<string> {
+		return new Promise((resolve, reject) => {
+			const taskID = this._handlePromiseStart();
+			super
+				.textConverted()
+				.then(this._handlePromiseEnd.bind(this, resolve, reject, taskID))
+				.catch(this._handlePromiseError.bind(this, reject));
+		});
+	}
+
+	/**
+	 * Handles promise start.
+	 *
+	 * @returns Task ID.
+	 */
+	private _handlePromiseStart(): number {
+		const taskManager = (<typeof Response>this.constructor)._ownerDocument.defaultView.happyDOM
+			.asyncTaskManager;
+		return taskManager.startTask();
+	}
+
+	/**
+	 * Handles promise end.
+	 *
+	 * @param resolve Resolve.
+	 * @param reject Reject.
+	 * @param taskID Task ID.
+	 * @param response Response.
+	 */
+	private _handlePromiseEnd(
+		resolve: (response: unknown) => void,
+		reject: (error: Error) => void,
+		taskID: number,
+		response: unknown
+	): void {
+		const taskManager = (<typeof Response>this.constructor)._ownerDocument.defaultView.happyDOM
+			.asyncTaskManager;
+		if (taskManager.getTaskCount() === 0) {
+			reject(new Error('Failed to complete fetch request. Task was canceled.'));
+		} else {
+			resolve(response);
+			taskManager.endTask(taskID);
+		}
+	}
+
+	/**
+	 * Handles promise error.
+	 *
+	 * @param error
+	 * @param reject
+	 */
+	private _handlePromiseError(reject: (error: Error) => void, error: Error): void {
+		const taskManager = (<typeof Response>this.constructor)._ownerDocument.defaultView.happyDOM
+			.asyncTaskManager;
+		reject(error);
+		taskManager.cancelAll(error);
+	}
+}

package/src/file/Blob.ts

@@ -1,3 +1,5 @@
+import IBlob from './IBlob';
+
 /**
  * Reference:
  * https://developer.mozilla.org/en-US/docs/Web/API/Blob.
@@ -5,7 +7,7 @@
  * Based on:
  * https://github.com/jsdom/jsdom/blob/master/lib/jsdom/living/file-api/Blob-impl.js (MIT licensed).
  */
-export default class Blob {
+export default class Blob implements IBlob {
 	public readonly _buffer: Buffer = null;
 	public readonly type: string = '';
 
@@ -108,6 +110,15 @@ export default class Blob {
 		return blob;
 	}
 
+	/**
+	 * Returns a Promise that resolves to a text.
+	 *
+	 * @returns Text.
+	 */
+	public async text(): Promise<string> {
+		return this._buffer.toString();
+	}
+
 	/**
 	 * Closes the blob.
 	 *

package/src/file/IBlob.ts

@@ -0,0 +1,10 @@
+/**
+ * Reference:
+ * https://developer.mozilla.org/en-US/docs/Web/API/Blob.
+ */
+export default interface IBlob {
+	readonly type: string;
+	readonly size: number;
+	slice(start?: number, end?: number): IBlob;
+	text(): Promise<string>;
+}

package/src/form-data/IFormData.ts

@@ -0,0 +1,33 @@
+import Stream from 'stream';
+import HTTP from 'http';
+
+interface IHeaders {
+	[key: string]: unknown;
+}
+
+interface IAppendOptions {
+	header?: string | IHeaders;
+	knownLength?: number;
+	filename?: string;
+	filepath?: string;
+	contentType?: string;
+}
+
+interface ISubmitOptions extends HTTP.RequestOptions {
+	protocol?: 'https:' | 'http:';
+}
+
+export default interface IFormData extends Stream.Readable {
+	append(key: string, value: unknown, options?: IAppendOptions | string): void;
+	getHeaders(userHeaders?: IHeaders): { [key: string]: IHeaders };
+	submit(
+		params: string | ISubmitOptions,
+		callback?: (error: Error | null, response: HTTP.IncomingMessage) => void
+	): HTTP.ClientRequest;
+	getBuffer(): Buffer;
+	setBoundary(boundary: string): void;
+	getBoundary(): string;
+	getLength(callback: (err: Error | null, length: number) => void): void;
+	getLengthSync(): number;
+	hasKnownLength(): boolean;
+}

package/src/index.ts

@@ -14,9 +14,7 @@ import DOMException from './exception/DOMException';
 import History from './history/History';
 import CSSStyleDeclaration from './css/CSSStyleDeclaration';
 import Screen from './screen/Screen';
-import AsyncTaskManager from './window/AsyncTaskManager';
-import IResponse from './window/IResponse';
-import IFetchOptions from './window/IFetchOptions';
+import AsyncTaskManager from './async-task-manager/AsyncTaskManager';
 import NodeFilter from './tree-walker/NodeFilter';
 import Event from './event/Event';
 import EventTarget from './event/EventTarget';
@@ -101,7 +99,7 @@ import XMLParser from './xml-parser/XMLParser';
 import XMLSerializer from './xml-serializer/XMLSerializer';
 import CSSStyleSheet from './css/CSSStyleSheet';
 import Storage from './storage/Storage';
-import URLSearchParams from './url-search-params/URLSearchParams';
+import { URLSearchParams } from 'url';
 import Selection from './selection/Selection';
 
 export {
@@ -123,8 +121,6 @@ export {
 	CSSStyleDeclaration,
 	Screen,
 	AsyncTaskManager,
-	IResponse,
-	IFetchOptions,
 	NodeFilter,
 	Event,
 	EventTarget,

package/src/nodes/html-link-element/HTMLLinkElement.ts

@@ -1,6 +1,6 @@
 import Attr from '../../attribute/Attr';
 import CSSStyleSheet from '../../css/CSSStyleSheet';
-import ResourceFetcher from '../../fetch/ResourceFetcher';
+import ResourceFetchHandler from '../../fetch/ResourceFetchHandler';
 import HTMLElement from '../html-element/HTMLElement';
 import Document from '../document/Document';
 import IHTMLLinkElement from './IHTMLLinkElement';
@@ -199,7 +199,7 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 			this.isConnected
 		) {
 			(<Document>this.ownerDocument)._readyStateManager.startTask();
-			ResourceFetcher.fetch({ window: this.ownerDocument.defaultView, url: href })
+			ResourceFetchHandler.fetch(this.ownerDocument, href)
 				.then((code) => {
 					const styleSheet = new CSSStyleSheet();
 					styleSheet.replaceSync(code);
@@ -245,7 +245,7 @@ export default class HTMLLinkElement extends HTMLElement implements IHTMLLinkEle
 
 			if (href !== null && rel && rel.toLowerCase() === 'stylesheet') {
 				(<Document>this.ownerDocument)._readyStateManager.startTask();
-				ResourceFetcher.fetch({ window: this.ownerDocument.defaultView, url: href })
+				ResourceFetchHandler.fetch(this.ownerDocument, href)
 					.then((code) => {
 						const styleSheet = new CSSStyleSheet();
 						styleSheet.replaceSync(code);

package/src/nodes/html-script-element/ScriptUtility.ts

@@ -1,7 +1,7 @@
 import { Document } from '../..';
 import Event from '../../event/Event';
 import ErrorEvent from '../../event/events/ErrorEvent';
-import ResourceFetcher from '../../fetch/ResourceFetcher';
+import ResourceFetchHandler from '../../fetch/ResourceFetchHandler';
 import HTMLScriptElement from './HTMLScriptElement';
 
 /**
@@ -22,10 +22,7 @@ export default class ScriptUtility {
 			let code = null;
 			(<Document>element.ownerDocument)._readyStateManager.startTask();
 			try {
-				code = await ResourceFetcher.fetch({
-					window: element.ownerDocument.defaultView,
-					url: src
-				});
+				code = await ResourceFetchHandler.fetch(element.ownerDocument, src);
 			} catch (error) {
 				element.dispatchEvent(
 					new ErrorEvent('error', {
@@ -54,10 +51,7 @@ export default class ScriptUtility {
 		} else {
 			let code = null;
 			try {
-				code = ResourceFetcher.fetchSync({
-					window: element.ownerDocument.defaultView,
-					url: src
-				});
+				code = ResourceFetchHandler.fetchSync(element.ownerDocument, src);
 			} catch (error) {
 				element.dispatchEvent(
 					new ErrorEvent('error', {

package/src/window/IWindow.ts

@@ -60,13 +60,15 @@ import UIEvent from '../event/UIEvent';
 import ErrorEvent from '../event/events/ErrorEvent';
 import StorageEvent from '../event/events/StorageEvent';
 import Screen from '../screen/Screen';
-import AsyncTaskManager from './AsyncTaskManager';
-import IResponse from './IResponse';
+import AsyncTaskManager from '../async-task-manager/AsyncTaskManager';
+import IResponse from '../fetch/IResponse';
+import IResponseInit from '../fetch/IResponseInit';
+import IRequest from '../fetch/IRequest';
+import IRequestInit from '../fetch/IRequestInit';
+import IHeaders from '../fetch/IHeaders';
 import Storage from '../storage/Storage';
-import IFetchOptions from './IFetchOptions';
 import NodeFilter from '../tree-walker/NodeFilter';
 import Window from './Window';
-import URLSearchParams from '../url-search-params/URLSearchParams';
 import HTMLCollection from '../nodes/element/HTMLCollection';
 import NodeList from '../nodes/node/NodeList';
 import Selection from '../selection/Selection';
@@ -76,6 +78,7 @@ import MimeType from '../navigator/MimeType';
 import MimeTypeArray from '../navigator/MimeTypeArray';
 import Plugin from '../navigator/Plugin';
 import PluginArray from '../navigator/PluginArray';
+import { URLSearchParams } from 'url';
 
 /**
  * Window.
@@ -141,7 +144,9 @@ export default interface IWindow extends IEventTarget {
 	readonly Location: typeof Location;
 	readonly CustomElementRegistry: typeof CustomElementRegistry;
 	readonly Window: typeof Window;
-	readonly Headers: typeof Map;
+	readonly Headers: { new (init?: string[][] | Record<string, string> | IHeaders): IHeaders };
+	readonly Request: { new (input: string | IRequest, init?: IRequestInit): IRequest };
+	readonly Response: { new (body?: unknown | null, init?: IResponseInit): IResponse };
 	readonly XMLSerializer: typeof XMLSerializer;
 	readonly ResizeObserver: typeof ResizeObserver;
 	readonly CSSStyleSheet: typeof CSSStyleSheet;
@@ -221,7 +226,6 @@ export default interface IWindow extends IEventTarget {
 	/**
 	 * Sets a timer which executes a function once the timer expires.
 	 *
-	 * @override
 	 * @param callback Function to be executed.
 	 * @param [delay=0] Delay in ms.
 	 * @returns Timeout ID.
@@ -231,7 +235,6 @@ export default interface IWindow extends IEventTarget {
 	/**
 	 * Cancels a timeout previously established by calling setTimeout().
 	 *
-	 * @override
 	 * @param id ID of the timeout.
 	 */
 	clearTimeout(id: NodeJS.Timeout): void;
@@ -239,7 +242,6 @@ export default interface IWindow extends IEventTarget {
 	/**
 	 * Calls a function with a fixed time delay between each call.
 	 *
-	 * @override
 	 * @param callback Function to be executed.
 	 * @param [delay=0] Delay in ms.
 	 * @returns Interval ID.
@@ -249,7 +251,6 @@ export default interface IWindow extends IEventTarget {
 	/**
 	 * Cancels a timed repeating action which was previously established by a call to setInterval().
 	 *
-	 * @override
 	 * @param id ID of the interval.
 	 */
 	clearInterval(id: NodeJS.Timeout): void;
@@ -257,7 +258,6 @@ export default interface IWindow extends IEventTarget {
 	/**
 	 * Mock animation frames with timeouts.
 	 *
-	 * @override
 	 * @param {Function} callback Callback.
 	 * @returns {NodeJS.Timeout} Timeout ID.
 	 */
@@ -266,18 +266,16 @@ export default interface IWindow extends IEventTarget {
 	/**
 	 * Mock animation frames with timeouts.
 	 *
-	 * @override
 	 * @param {NodeJS.Timeout} id Timeout ID.
 	 */
 	cancelAnimationFrame(id: NodeJS.Timeout): void;
 
 	/**
-	 * Provides a global fetch() method that provides an easy, logical way to fetch resources asynchronously across the network.
+	 * This method provides an easy, logical way to fetch resources asynchronously across the network.
 	 *
-	 * @override
-	 * @param url URL to resource.
-	 * @param [options] Options.
+	 * @param url URL.
+	 * @param [init] Init.
 	 * @returns Promise.
 	 */
-	fetch(url: string, options?: IFetchOptions): Promise<IResponse>;
+	fetch(url: string, init?: IRequestInit): Promise<IResponse>;
 }

package/src/window/Window.ts

@@ -63,14 +63,15 @@ import UIEvent from '../event/UIEvent';
 import ErrorEvent from '../event/events/ErrorEvent';
 import StorageEvent from '../event/events/StorageEvent';
 import Screen from '../screen/Screen';
-import AsyncTaskManager from './AsyncTaskManager';
-import IResponse from './IResponse';
-import AsyncTaskTypeEnum from './AsyncTaskTypeEnum';
-import RelativeURL from '../location/RelativeURL';
+import AsyncTaskManager from '../async-task-manager/AsyncTaskManager';
+import IResponse from '../fetch/IResponse';
+import IResponseInit from '../fetch/IResponseInit';
+import IRequest from '../fetch/IRequest';
+import IRequestInit from '../fetch/IRequestInit';
+import IHeaders from '../fetch/IHeaders';
+import IHeadersInit from '../fetch/IHeadersInit';
 import Storage from '../storage/Storage';
-import IFetchOptions from './IFetchOptions';
 import IWindow from './IWindow';
-import URLSearchParams from '../url-search-params/URLSearchParams';
 import HTMLCollection from '../nodes/element/HTMLCollection';
 import NodeList from '../nodes/node/NodeList';
 import MediaQueryList from '../match-media/MediaQueryList';
@@ -81,8 +82,8 @@ import MimeType from '../navigator/MimeType';
 import MimeTypeArray from '../navigator/MimeTypeArray';
 import Plugin from '../navigator/Plugin';
 import PluginArray from '../navigator/PluginArray';
-
-const FETCH_RESPONSE_TYPE_METHODS = ['blob', 'json', 'text'];
+import FetchHandler from '../fetch/FetchHandler';
+import { URLSearchParams } from 'url';
 
 /**
  * Handles the Window.
@@ -94,7 +95,7 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 			return await this.happyDOM.asyncTaskManager.whenComplete();
 		},
 		cancelAsync: (): void => {
-			this.happyDOM.asyncTaskManager.cancelAllTasks();
+			this.happyDOM.asyncTaskManager.cancelAll();
 		},
 		asyncTaskManager: new AsyncTaskManager()
 	};
@@ -152,7 +153,6 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 	public readonly Location = Location;
 	public readonly CustomElementRegistry = CustomElementRegistry;
 	public readonly Window = Window;
-	public readonly Headers = Map;
 	public readonly XMLSerializer = XMLSerializer;
 	public readonly ResizeObserver = ResizeObserver;
 	public readonly CSSStyleSheet = CSSStyleSheet;
@@ -200,7 +200,6 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 	public readonly performance = PerfHooks.performance;
 
 	// Node.js Globals
-	public Array = global ? global.Array : null;
 	public ArrayBuffer = global ? global.ArrayBuffer : null;
 	public Boolean = global ? global.Boolean : null;
 	public Buffer = null;
@@ -262,6 +261,7 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 
 	// Private properties
 	private _objectClass: typeof globalThis.Object = null;
+	private _arrayClass: typeof globalThis.Array = null;
 	private _functionClass: typeof globalThis.Function = null;
 
 	/**
@@ -315,6 +315,21 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 		return this._objectClass;
 	}
 
+	/**
+	 * Returns Array class.
+	 *
+	 * @returns Array class.
+	 */
+	public get Array(): typeof globalThis.Array {
+		if (this._arrayClass) {
+			return this._arrayClass;
+		}
+		// When inside a VM global.Object is not the same as [].constructor
+		// We will therefore run the code inside the VM to get the real constructor
+		this._arrayClass = <typeof globalThis.Array>this.eval('[].constructor');
+		return this._arrayClass;
+	}
+
 	/**
 	 * Returns Function class.
 	 *
@@ -339,6 +354,43 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 		return new CSS();
 	}
 
+	/**
+	 * Returns Headers class.
+	 *
+	 * @returns Headers.
+	 */
+	public get Headers(): {
+		new (init?: IHeadersInit): IHeaders;
+	} {
+		return require('../fetch/Headers').default;
+	}
+
+	/**
+	 * Returns Request class.
+	 *
+	 * @returns Request.
+	 */
+	public get Request(): {
+		new (input: string | { href: string } | IRequest, init?: IRequestInit): IRequest;
+	} {
+		const Request = require('../fetch/Request').default;
+		Request._ownerDocument = Request._ownerDocument || this.document;
+		return Request;
+	}
+
+	/**
+	 * Returns Response class.
+	 *
+	 * @returns Response.
+	 */
+	public get Response(): {
+		new (body?: NodeJS.ReadableStream | null, init?: IResponseInit): IResponse;
+	} {
+		const Response = require('../fetch/Response').default;
+		Response._ownerDocument = Response._ownerDocument || this.document;
+		return Response;
+	}
+
 	/**
 	 * Evaluates code.
 	 *
@@ -509,65 +561,14 @@ export default class Window extends EventTarget implements IWindow, NodeJS.Globa
 	}
 
 	/**
-	 * Provides a global fetch() method that provides an easy, logical way to fetch resources asynchronously across the network.
+	 * This method provides an easy, logical way to fetch resources asynchronously across the network.
 	 *
 	 * @override
-	 * @param url URL to resource.
-	 * @param [options] Options.
+	 * @param url URL.
+	 * @param [init] Init.
 	 * @returns Promise.
 	 */
-	public async fetch(url: string, options?: IFetchOptions): Promise<IResponse> {
-		return new Promise((resolve, reject) => {
-			let fetch = null;
-
-			try {
-				fetch = require('node-fetch');
-			} catch (error) {
-				throw new Error('Failed to perform fetch. "node-fetch" could not be loaded.');
-			}
-
-			this.happyDOM.asyncTaskManager.startTask(AsyncTaskTypeEnum.fetch);
-
-			fetch(RelativeURL.getAbsoluteURL(this.location, url), options)
-				.then((response) => {
-					if (this.happyDOM.asyncTaskManager.getRunningCount(AsyncTaskTypeEnum.fetch) === 0) {
-						reject(new Error('Failed to complete fetch request. Task was canceled.'));
-					} else {
-						for (const methodName of FETCH_RESPONSE_TYPE_METHODS) {
-							const asyncMethod = response[methodName];
-							response[methodName] = () => {
-								return new Promise((resolve, reject) => {
-									this.happyDOM.asyncTaskManager.startTask(AsyncTaskTypeEnum.fetch);
-
-									asyncMethod
-										.call(response)
-										.then((response) => {
-											if (
-												this.happyDOM.asyncTaskManager.getRunningCount(AsyncTaskTypeEnum.fetch) ===
-												0
-											) {
-												reject(new Error('Failed to complete fetch request. Task was canceled.'));
-											} else {
-												resolve(response);
-												this.happyDOM.asyncTaskManager.endTask(AsyncTaskTypeEnum.fetch);
-											}
-										})
-										.catch((error) => {
-											reject(error);
-											this.happyDOM.asyncTaskManager.endTask(AsyncTaskTypeEnum.fetch, error);
-										});
-								});
-							};
-						}
-
-						resolve(response);
-						this.happyDOM.asyncTaskManager.endTask(AsyncTaskTypeEnum.fetch);
-					}
-				})
-				.catch((error) => {
-					reject(error);
-					this.happyDOM.asyncTaskManager.endTask(AsyncTaskTypeEnum.fetch, error);
-				});
-		});
+	public async fetch(url: string, init?: IRequestInit): Promise<IResponse> {
+		return await FetchHandler.fetch(this.document, url, init);
 	}
 }

package/lib/fetch/ResourceFetcher.d.ts

@@ -1,30 +0,0 @@
-import Window from '../window/Window';
-/**
- * Helper class for performing an asynchonous or synchrounous request to a resource.
- */
-export default class ResourceFetcher {
-    /**
-     * Returns resource data asynchonously.
-     *
-     * @param options Options.
-     * @param options.window Location.
-     * @param options.url URL.
-     * @returns Response.
-     */
-    static fetch(options: {
-        window: Window;
-        url: string;
-    }): Promise<string>;
-    /**
-     * Returns resource data synchonously.
-     *
-     * @param options Options.
-     * @param options.window Location.
-     * @param options.url URL.
-     * @returns Response.
-     */
-    static fetchSync(options: {
-        window: Window;
-        url: string;
-    }): string;
-}