happy-dom 17.6.2 → 18.0.0

package/src/browser/BrowserContext.ts

@@ -17,6 +17,7 @@ export default class BrowserContext implements IBrowserContext {
 	public readonly cookieContainer: ICookieContainer = new CookieContainer();
 	public readonly responseCache: IResponseCache = new ResponseCache();
 	public readonly preflightResponseCache: IPreflightResponseCache = new PreflightResponseCache();
+	public readonly closed: boolean = false;
 
 	/**
 	 * Constructor.
@@ -31,25 +32,31 @@ export default class BrowserContext implements IBrowserContext {
 	 * Aborts all ongoing operations and destroys the context.
 	 */
 	public async close(): Promise<void> {
-		if (!this.browser) {
+		if (this.closed) {
 			return;
 		}
+
+		if (this.browser.contexts[0] === this) {
+			throw new Error(
+				'Cannot close the default context. Use `browser.close()` to close the browser instead.'
+			);
+		}
+
+		(<boolean>this.closed) = true;
+
 		await Promise.all(this.pages.slice().map((page) => page.close()));
+
 		const browser = this.browser;
 		const index = browser.contexts.indexOf(this);
+
 		if (index !== -1) {
 			browser.contexts.splice(index, 1);
 		}
+
 		(<BrowserPage[]>this.pages) = [];
-		(<Browser | null>this.browser) = null;
-		(<ICookieContainer | null>this.cookieContainer) = null;
+		this.cookieContainer.clearCookies();
 		this.responseCache.clear();
 		this.preflightResponseCache.clear();
-		(<ResponseCache | null>this.responseCache) = null;
-		(<PreflightResponseCache | null>this.preflightResponseCache) = null;
-		if (browser.contexts.length === 0) {
-			browser.close();
-		}
 	}
 
 	/**

package/src/browser/BrowserFrame.ts

@@ -23,7 +23,8 @@ export default class BrowserFrame implements IBrowserFrame {
 	public readonly parentFrame: BrowserFrame | null = null;
 	public readonly page: BrowserPage;
 	public readonly window: BrowserWindow;
-	public [PropertySymbol.asyncTaskManager] = new AsyncTaskManager(this);
+	public readonly closed: boolean = false;
+	public [PropertySymbol.asyncTaskManager]: AsyncTaskManager = new AsyncTaskManager(this);
 	public [PropertySymbol.listeners]: { navigation: Array<() => void> } = { navigation: [] };
 	public [PropertySymbol.openerFrame]: IBrowserFrame | null = null;
 	public [PropertySymbol.openerWindow]: BrowserWindow | CrossOriginBrowserWindow | null = null;

package/src/browser/BrowserPage.ts

@@ -22,6 +22,7 @@ export default class BrowserPage implements IBrowserPage {
 	public readonly context: BrowserContext;
 	public readonly console: Console;
 	public readonly viewport: IBrowserPageViewport = Object.assign({}, DefaultBrowserPageViewport);
+	public readonly closed: boolean = false;
 
 	/**
 	 * Constructor.

package/src/browser/detached-browser/DetachedBrowser.ts

@@ -9,6 +9,7 @@ import BrowserWindow from '../../window/BrowserWindow.js';
 import * as PropertySymbol from '../../PropertySymbol.js';
 import BrowserErrorCaptureEnum from '../enums/BrowserErrorCaptureEnum.js';
 import BrowserExceptionObserver from '../utilities/BrowserExceptionObserver.js';
+import BrowserContext from '../BrowserContext.js';
 
 /**
  * Detached browser used when constructing a Window instance without a browser.
@@ -20,7 +21,7 @@ export default class DetachedBrowser implements IBrowser {
 	public readonly windowClass: new (
 		browserFrame: IBrowserFrame,
 		options?: { url?: string; width?: number; height?: number }
-	) => BrowserWindow | null;
+	) => BrowserWindow;
 	public [PropertySymbol.exceptionObserver]: BrowserExceptionObserver | null = null;
 
 	/**
@@ -48,6 +49,15 @@ export default class DetachedBrowser implements IBrowser {
 		this.contexts.push(new DetachedBrowserContext(this));
 	}
 
+	/**
+	 * Returns true if the browser is closed.
+	 *
+	 * @returns True if the browser is closed.
+	 */
+	public get closed(): boolean {
+		return this.contexts.length === 0;
+	}
+
 	/**
 	 * Returns the default context.
 	 *
@@ -64,10 +74,12 @@ export default class DetachedBrowser implements IBrowser {
 	 * Aborts all ongoing operations and destroys the browser.
 	 */
 	public async close(): Promise<void> {
-		await Promise.all(this.contexts.slice().map((context) => context.close()));
-		(<DetachedBrowserContext[]>this.contexts) = [];
-		(<Console | null>this.console) = null;
-		(<(new (browserFrame: IBrowserFrame) => BrowserWindow) | null>this.windowClass) = null;
+		if (this.contexts.length === 0) {
+			return;
+		}
+		const contexts = this.contexts;
+		(<BrowserContext[]>this.contexts) = [];
+		await Promise.all(contexts.map((context) => context.close()));
 	}
 
 	/**

package/src/browser/detached-browser/DetachedBrowserContext.ts

@@ -17,6 +17,7 @@ export default class DetachedBrowserContext implements IBrowserContext {
 	public readonly cookieContainer: ICookieContainer = new CookieContainer();
 	public readonly responseCache: IResponseCache = new ResponseCache();
 	public readonly preflightResponseCache: IPreflightResponseCache = new PreflightResponseCache();
+	public readonly closed: boolean = false;
 
 	/**
 	 * Constructor.
@@ -33,25 +34,31 @@ export default class DetachedBrowserContext implements IBrowserContext {
 	 * Aborts all ongoing operations and destroys the context.
 	 */
 	public async close(): Promise<void> {
-		if (!this.browser) {
+		if (this.closed) {
 			return;
 		}
+
+		if (this.browser.contexts[0] === this) {
+			throw new Error(
+				'Cannot close the default context. Use `browser.close()` to close the browser instead.'
+			);
+		}
+
+		(<boolean>this.closed) = true;
+
 		await Promise.all(this.pages.slice().map((page) => page.close()));
+
 		const browser = this.browser;
 		const index = browser.contexts.indexOf(this);
+
 		if (index !== -1) {
 			browser.contexts.splice(index, 1);
 		}
+
 		(<DetachedBrowserPage[]>this.pages) = [];
-		(<DetachedBrowser | null>this.browser) = null;
-		(<ICookieContainer | null>this.cookieContainer) = null;
+		this.cookieContainer.clearCookies();
 		this.responseCache.clear();
 		this.preflightResponseCache.clear();
-		(<ResponseCache | null>this.responseCache) = null;
-		(<PreflightResponseCache | null>this.preflightResponseCache) = null;
-		if (browser.contexts.length === 0) {
-			browser.close();
-		}
 	}
 
 	/**

package/src/browser/detached-browser/DetachedBrowserFrame.ts

@@ -19,12 +19,14 @@ import HistoryScrollRestorationEnum from '../../history/HistoryScrollRestoration
  * Browser frame used when constructing a Window instance without a browser.
  */
 export default class DetachedBrowserFrame implements IBrowserFrame {
+	// When constructing a detached Window instance, it needs to inject the window into the frame.
+	public declare window: BrowserWindow;
+
 	public readonly childFrames: DetachedBrowserFrame[] = [];
 	public readonly parentFrame: DetachedBrowserFrame | null = null;
 	public readonly page: DetachedBrowserPage;
-	// Needs to be injected from the outside when the browser frame is constructed.
-	public window: BrowserWindow;
-	public [PropertySymbol.asyncTaskManager] = new AsyncTaskManager(this);
+	public readonly closed: boolean = false;
+	public [PropertySymbol.asyncTaskManager]: AsyncTaskManager = new AsyncTaskManager(this);
 	public [PropertySymbol.listeners]: { navigation: Array<() => void> } = { navigation: [] };
 	public [PropertySymbol.openerFrame]: IBrowserFrame | null = null;
 	public [PropertySymbol.openerWindow]: BrowserWindow | CrossOriginBrowserWindow | null = null;
@@ -49,13 +51,14 @@ export default class DetachedBrowserFrame implements IBrowserFrame {
 	 */
 	constructor(page: DetachedBrowserPage) {
 		this.page = page;
+
 		if (page.context.browser.contexts[0]?.pages[0]?.mainFrame) {
 			this.window = new this.page.context.browser.windowClass(this);
-		}
 
-		// Attach process level error capturing.
-		if (page.context.browser[PropertySymbol.exceptionObserver]) {
-			page.context.browser[PropertySymbol.exceptionObserver].observe(this.window);
+			// Attach process level error capturing.
+			if (page.context.browser[PropertySymbol.exceptionObserver]) {
+				page.context.browser[PropertySymbol.exceptionObserver].observe(this.window);
+			}
 		}
 	}
 

package/src/browser/detached-browser/DetachedBrowserPage.ts

@@ -22,6 +22,7 @@ export default class DetachedBrowserPage implements IBrowserPage {
 	public readonly context: DetachedBrowserContext;
 	public readonly console: Console;
 	public readonly viewport: IBrowserPageViewport = Object.assign({}, DefaultBrowserPageViewport);
+	public readonly closed: boolean = false;
 
 	/**
 	 * Constructor.
@@ -86,7 +87,7 @@ export default class DetachedBrowserPage implements IBrowserPage {
 				.then(() => {
 					// As we are in a detached page, a context or browser should not exist without a page as there are no references to them.
 					if (context.pages[0] === this) {
-						context.close().then(resolve).catch(reject);
+						context.browser.close().then(resolve).catch(reject);
 					} else {
 						resolve();
 					}

package/src/browser/types/IBrowser.ts

@@ -14,6 +14,7 @@ export default interface IBrowser {
 	readonly contexts: IBrowserContext[];
 	readonly settings: IBrowserSettings;
 	readonly console: Console | null;
+	readonly closed: boolean;
 	readonly [PropertySymbol.exceptionObserver]: BrowserExceptionObserver | null;
 
 	/**

package/src/browser/types/IBrowserContext.ts

@@ -13,6 +13,7 @@ export default interface IBrowserContext {
 	readonly cookieContainer: ICookieContainer;
 	readonly responseCache: IResponseCache;
 	readonly preflightResponseCache: IPreflightResponseCache;
+	readonly closed: boolean;
 
 	/**
 	 * Aborts all ongoing operations and destroys the context.

package/src/browser/types/IBrowserFrame.ts

@@ -19,6 +19,7 @@ export default interface IBrowserFrame {
 	readonly page: IBrowserPage;
 	readonly window: BrowserWindow;
 	readonly document: Document;
+	readonly closed: boolean;
 	content: string;
 	url: string;
 	[PropertySymbol.history]: IHistoryItem[];

package/src/browser/types/IBrowserPage.ts

@@ -18,6 +18,7 @@ export default interface IBrowserPage {
 	readonly console: Console;
 	readonly frames: IBrowserFrame[];
 	readonly viewport: IBrowserPageViewport;
+	readonly closed: boolean;
 	content: string;
 	url: string;
 

package/src/browser/utilities/BrowserFrameFactory.ts

@@ -1,6 +1,5 @@
 import IBrowserFrame from '../types/IBrowserFrame.js';
 import * as PropertySymbol from '../../PropertySymbol.js';
-import BrowserWindow from '../../window/BrowserWindow.js';
 import IBrowserPage from '../types/IBrowserPage.js';
 
 /**
@@ -28,7 +27,13 @@ export default class BrowserFrameFactory {
 	 * @param frame Frame.
 	 */
 	public static destroyFrame(frame: IBrowserFrame): Promise<void> {
-		const exceptionObserver = frame.page?.context?.browser?.[PropertySymbol.exceptionObserver];
+		const exceptionObserver = frame.page.context.browser[PropertySymbol.exceptionObserver];
+
+		if (frame.closed) {
+			return Promise.resolve();
+		}
+
+		(<boolean>frame.closed) = true;
 
 		// Using Promise instead of async/await to prevent usage of a microtask
 		return new Promise((resolve, reject) => {
@@ -52,8 +57,7 @@ export default class BrowserFrameFactory {
 							exceptionObserver.disconnect(frame.window);
 						}
 
-						(<IBrowserPage | null>frame.page) = null;
-						(<BrowserWindow | null>frame.window) = null;
+						(<object>frame.window) = { closed: true };
 						frame[PropertySymbol.openerFrame] = null;
 						frame[PropertySymbol.openerWindow] = null;
 
@@ -75,8 +79,7 @@ export default class BrowserFrameFactory {
 								exceptionObserver.disconnect(frame.window);
 							}
 
-							(<IBrowserPage | null>frame.page) = null;
-							(<BrowserWindow | null>frame.window) = null;
+							(<object>frame.window) = { closed: true };
 							frame[PropertySymbol.openerFrame] = null;
 							frame[PropertySymbol.openerWindow] = null;
 

package/src/browser/utilities/BrowserFrameNavigator.ts

@@ -34,7 +34,7 @@ export default class BrowserFrameNavigator {
 		windowClass: new (
 			browserFrame: IBrowserFrame,
 			options?: { url?: string; width?: number; height?: number }
-		) => BrowserWindow | null;
+		) => BrowserWindow;
 		frame: IBrowserFrame;
 		url: string;
 		goToOptions?: IGoToOptions;
@@ -267,13 +267,13 @@ export default class BrowserFrameNavigator {
 		windowClass: new (
 			browserFrame: IBrowserFrame,
 			options?: { url?: string; width?: number; height?: number }
-		) => BrowserWindow | null;
+		) => BrowserWindow;
 		frame: IBrowserFrame;
 		goToOptions?: IGoToOptions;
 	}): Promise<Response | null> {
 		const { windowClass, frame, goToOptions } = options;
 		const history = frame[PropertySymbol.history];
-		let historyItem: IHistoryItem;
+		let historyItem: IHistoryItem | null = null;
 
 		for (let i = history.length - 1; i >= 0; i--) {
 			if (history[i].isCurrent) {
@@ -326,13 +326,13 @@ export default class BrowserFrameNavigator {
 		windowClass: new (
 			browserFrame: IBrowserFrame,
 			options?: { url?: string; width?: number; height?: number }
-		) => BrowserWindow | null;
+		) => BrowserWindow;
 		frame: IBrowserFrame;
 		goToOptions?: IGoToOptions;
 	}): Promise<Response | null> {
 		const { windowClass, frame, goToOptions } = options;
 		const history = frame[PropertySymbol.history];
-		let historyItem: IHistoryItem;
+		let historyItem: IHistoryItem | null = null;
 
 		for (let i = history.length - 1; i >= 0; i--) {
 			if (history[i].isCurrent) {
@@ -386,7 +386,7 @@ export default class BrowserFrameNavigator {
 		windowClass: new (
 			browserFrame: IBrowserFrame,
 			options?: { url?: string; width?: number; height?: number }
-		) => BrowserWindow | null;
+		) => BrowserWindow;
 		frame: IBrowserFrame;
 		goToOptions?: IGoToOptions;
 		steps?: number;
@@ -397,7 +397,7 @@ export default class BrowserFrameNavigator {
 
 		const { windowClass, frame, goToOptions, steps } = options;
 		const history = frame[PropertySymbol.history];
-		let historyItem: IHistoryItem;
+		let historyItem: IHistoryItem | null = null;
 
 		for (let i = history.length - 1; i >= 0; i--) {
 			if (history[i].isCurrent) {
@@ -450,13 +450,13 @@ export default class BrowserFrameNavigator {
 		windowClass: new (
 			browserFrame: IBrowserFrame,
 			options?: { url?: string; width?: number; height?: number }
-		) => BrowserWindow | null;
+		) => BrowserWindow;
 		frame: IBrowserFrame;
 		goToOptions?: IGoToOptions;
 	}): Promise<Response | null> {
 		const { windowClass, frame, goToOptions } = options;
 		const history = frame[PropertySymbol.history];
-		let historyItem: IHistoryItem;
+		let historyItem: IHistoryItem | null = null;
 
 		for (let i = history.length - 1; i >= 0; i--) {
 			if (history[i].isCurrent) {

package/src/browser/utilities/BrowserFrameURL.ts

@@ -12,7 +12,7 @@ export default class BrowserFrameURL {
 	 * @param url URL.
 	 * @returns Relative URL.
 	 */
-	public static getRelativeURL(frame: IBrowserFrame, url: string | URL): URL {
+	public static getRelativeURL(frame: IBrowserFrame, url?: string | URL | null): URL {
 		url = url ? String(url) : 'about:blank';
 
 		if (url.startsWith('about:') || url.startsWith('javascript:')) {

package/src/browser/utilities/BrowserPageUtility.ts

@@ -1,7 +1,5 @@
 import IBrowserFrame from '../types/IBrowserFrame.js';
 import IBrowserPage from '../types/IBrowserPage.js';
-import IVirtualConsolePrinter from '../../console/IVirtualConsolePrinter.js';
-import IBrowserContext from '../types/IBrowserContext.js';
 import BrowserFrameFactory from './BrowserFrameFactory.js';
 
 /**
@@ -24,27 +22,22 @@ export default class BrowserPageUtility {
 	 * @param page Page.
 	 */
 	public static closePage(page: IBrowserPage): Promise<void> {
+		if (page.closed) {
+			return Promise.resolve();
+		}
+
+		(<boolean>page.closed) = true;
+
+		const index = page.context.pages.indexOf(page);
+
+		if (index !== -1) {
+			page.context.pages.splice(index, 1);
+		}
+
+		page.virtualConsolePrinter.close();
+
 		// Using Promise instead of async/await to prevent microtask
-		return new Promise((resolve, reject) => {
-			if (!page.mainFrame) {
-				resolve();
-				return;
-			}
-
-			const index = page.context.pages.indexOf(page);
-			if (index !== -1) {
-				page.context.pages.splice(index, 1);
-			}
-
-			BrowserFrameFactory.destroyFrame(page.mainFrame)
-				.then(() => {
-					(<IVirtualConsolePrinter | null>page.virtualConsolePrinter) = null;
-					(<IBrowserFrame | null>page.mainFrame) = null;
-					(<IBrowserContext | null>page.context) = null;
-					resolve();
-				})
-				.catch((error) => reject(error));
-		});
+		return BrowserFrameFactory.destroyFrame(page.mainFrame);
 	}
 
 	/**

package/src/config/IHTMLElementTagNameMap.ts

@@ -63,16 +63,7 @@ import HTMLTrackElement from '../nodes/html-track-element/HTMLTrackElement.js';
 import HTMLUListElement from '../nodes/html-u-list-element/HTMLUListElement.js';
 import HTMLVideoElement from '../nodes/html-video-element/HTMLVideoElement.js';
 
-// Makes it work with custom elements when they declare their own interface.
-declare global {
-	/* eslint-disable @typescript-eslint/naming-convention */
-	/* eslint-disable @typescript-eslint/no-empty-interface */
-	interface HTMLElementTagNameMap {}
-	/* eslint-enable @typescript-eslint/naming-convention */
-	/* eslint-enable @typescript-eslint/no-empty-interface */
-}
-
-export default interface IHTMLElementTagNameMap extends HTMLElementTagNameMap {
+export default interface IHTMLElementTagNameMap {
 	a: HTMLAnchorElement;
 	abbr: HTMLElement;
 	address: HTMLElement;

package/src/console/IVirtualConsoleLogEntry.ts

@@ -5,6 +5,6 @@ import VirtualConsoleLogTypeEnum from './enums/VirtualConsoleLogTypeEnum.js';
 export default interface IVirtualConsoleLogEntry {
 	type: VirtualConsoleLogTypeEnum;
 	level: VirtualConsoleLogLevelEnum;
-	message: Array<string | object>;
+	message: Array<string | any>;
 	group: IVirtualConsoleLogGroup | null;
 }

package/src/console/VirtualConsole.ts

@@ -12,7 +12,7 @@ import { ConsoleConstructor } from 'console';
 export default class VirtualConsole implements Console {
 	// This is needed as the interface for the NodeJS Console also have a reference to the ConsoleConstructor class as a property for some reason.
 	// This is not part of the browser specs.
-	public Console: ConsoleConstructor;
+	public declare Console: ConsoleConstructor;
 
 	#printer: IVirtualConsolePrinter;
 	#count: { [label: string]: number } = {};

package/src/console/VirtualConsolePrinter.ts

@@ -13,6 +13,16 @@ export default class VirtualConsolePrinter implements IVirtualConsolePrinter {
 		print: Array<(event: Event) => void>;
 		clear: Array<(event: Event) => void>;
 	} = { print: [], clear: [] };
+	#closed = false;
+
+	/**
+	 * Returns closed state.
+	 *
+	 * @returns True if the printer is closed.
+	 */
+	public get closed(): boolean {
+		return this.#closed;
+	}
 
 	/**
 	 * Writes to the output.
@@ -20,6 +30,9 @@ export default class VirtualConsolePrinter implements IVirtualConsolePrinter {
 	 * @param logEntry Log entry.
 	 */
 	public print(logEntry: IVirtualConsoleLogEntry): void {
+		if (this.#closed) {
+			return;
+		}
 		this.#logEntries.push(logEntry);
 		this.dispatchEvent(new Event('print'));
 	}
@@ -28,10 +41,25 @@ export default class VirtualConsolePrinter implements IVirtualConsolePrinter {
 	 * Clears the output.
 	 */
 	public clear(): void {
+		if (this.#closed) {
+			return;
+		}
 		this.#logEntries = [];
 		this.dispatchEvent(new Event('clear'));
 	}
 
+	/**
+	 * Clears and closes the virtual console printer.
+	 */
+	public close(): void {
+		if (this.#closed) {
+			return;
+		}
+		this.#logEntries = [];
+		this.#listeners = { print: [], clear: [] };
+		this.#closed = true;
+	}
+
 	/**
 	 * Adds an event listener.
 	 *
@@ -39,6 +67,9 @@ export default class VirtualConsolePrinter implements IVirtualConsolePrinter {
 	 * @param listener Listener.
 	 */
 	public addEventListener(eventType: 'print' | 'clear', listener: (event: Event) => void): void {
+		if (this.#closed) {
+			return;
+		}
 		if (!this.#listeners[eventType]) {
 			throw new Error(`Event type "${eventType}" is not supported.`);
 		}
@@ -52,6 +83,9 @@ export default class VirtualConsolePrinter implements IVirtualConsolePrinter {
 	 * @param listener Listener.
 	 */
 	public removeEventListener(eventType: 'print' | 'clear', listener: (event: Event) => void): void {
+		if (this.#closed) {
+			return;
+		}
 		if (!this.#listeners[eventType]) {
 			throw new Error(`Event type "${eventType}" is not supported.`);
 		}
@@ -67,11 +101,18 @@ export default class VirtualConsolePrinter implements IVirtualConsolePrinter {
 	 * @param event Event.
 	 */
 	public dispatchEvent(event: Event): void {
-		if (!this.#listeners[event.type]) {
-			throw new Error(`Event type "${event.type}" is not supported.`);
+		if (this.#closed) {
+			return;
 		}
-		for (const listener of this.#listeners[event.type]) {
-			listener(event);
+		switch (event.type) {
+			case 'print':
+			case 'clear':
+				for (const listener of this.#listeners[event.type]) {
+					listener(event);
+				}
+				break;
+			default:
+				throw new Error(`Event type "${event.type}" is not supported.`);
 		}
 	}
 

package/src/console/utilities/VirtualConsoleLogEntryStringifier.ts

@@ -27,7 +27,7 @@ export default class VirtualConsoleLogEntryStringifier {
 				try {
 					output += JSON.stringify(part);
 				} catch (error) {
-					output += new Error('Failed to JSON stringify object in log entry.').stack.replace(
+					output += new Error('Failed to JSON stringify object in log entry.').stack!.replace(
 						/\n    at/gm,
 						'\n    ' + tabbing + 'at'
 					);

package/src/cookie/CookieContainer.ts

@@ -21,13 +21,13 @@ export default class CookieContainer implements ICookieContainer {
 	 * @param cookies Cookies.
 	 */
 	public addCookies(cookies: IOptionalCookie[]): void {
-		const indexMap: { [k: string]: number } = {};
+		const indexMap: Map<string, number> = new Map();
 		const getKey = (cookie: ICookie): string =>
 			`${cookie.key}-${cookie.originURL.hostname}-${cookie.path}-${typeof cookie.value}`;
 
 		// Creates a map of cookie key, domain, path and value to index.
 		for (let i = 0, max = this.#cookies.length; i < max; i++) {
-			indexMap[getKey(this.#cookies[i])] = i;
+			indexMap.set(getKey(this.#cookies[i]), i);
 		}
 
 		for (const cookie of cookies) {
@@ -35,14 +35,14 @@ export default class CookieContainer implements ICookieContainer {
 
 			if (newCookie && newCookie.key && newCookie.originURL) {
 				// Remove existing cookie with same name, domain and path.
-				const index = indexMap[getKey(newCookie)];
+				const index = indexMap.get(getKey(newCookie));
 
 				if (index !== undefined) {
 					this.#cookies.splice(index, 1);
 				}
 
 				if (!CookieExpireUtility.hasExpired(newCookie)) {
-					indexMap[getKey(newCookie)] = this.#cookies.length;
+					indexMap.set(getKey(newCookie), this.#cookies.length);
 					this.#cookies.push(newCookie);
 				}
 			}
@@ -71,4 +71,11 @@ export default class CookieContainer implements ICookieContainer {
 
 		return cookies;
 	}
+
+	/**
+	 * Clears all cookies.
+	 */
+	public clearCookies(): void {
+		this.#cookies = [];
+	}
 }

package/src/cookie/DefaultCookie.ts

@@ -3,8 +3,8 @@ import ICookie from './ICookie.js';
 
 export default <ICookie>{
 	// Required
-	key: null,
-	originURL: null,
+	key: null!,
+	originURL: null!,
 
 	// Optional
 	value: null,

package/src/cookie/ICookieContainer.ts

@@ -23,5 +23,10 @@ export default interface ICookieContainer {
 	 * @param [httpOnly] "true" if only http cookies should be returned.
 	 * @returns Cookies.
 	 */
-	getCookies(url: URL | null, httpOnly?: boolean): ICookie[];
+	getCookies(url?: URL | null, httpOnly?: boolean): ICookie[];
+
+	/**
+	 * Clears all cookies.
+	 */
+	clearCookies(): void;
 }

package/src/cookie/urilities/CookieStringUtility.ts

@@ -2,6 +2,7 @@ import CookieSameSiteEnum from '../enums/CookieSameSiteEnum.js';
 import URL from '../../url/URL.js';
 import ICookie from '../ICookie.js';
 import DefaultCookie from '../DefaultCookie.js';
+import Location from '../../location/Location.js';
 
 /**
  * Cookie string.
@@ -14,9 +15,14 @@ export default class CookieStringUtility {
 	 * @param cookieString Cookie string.
 	 * @returns Cookie.
 	 */
-	public static stringToCookie(originURL: URL, cookieString: string): ICookie | null {
+	public static stringToCookie(originURL: URL | Location, cookieString: string): ICookie | null {
 		const parts = cookieString.split(';');
 		const part = parts.shift();
+
+		if (!part) {
+			return null;
+		}
+
 		const index = part.indexOf('=');
 		const key = index !== -1 ? part.slice(0, index).trim() : part.trim();
 		const value = index !== -1 ? part.slice(index + 1).trim() : null;