happy-dom 14.12.3 → 15.0.0

package/src/PropertySymbol.ts

@@ -1,11 +1,8 @@
 export const abort = Symbol('abort');
 export const activeElement = Symbol('activeElement');
-export const appendFormControlItem = Symbol('appendFormControlItem');
-export const appendNamedItem = Symbol('appendNamedItem');
 export const asyncTaskManager = Symbol('asyncTaskManager');
 export const bodyBuffer = Symbol('bodyBuffer');
 export const buffer = Symbol('buffer');
-export const cacheID = Symbol('cacheID');
 export const cachedResponse = Symbol('cachedResponse');
 export const callbacks = Symbol('callbacks');
 export const captureEventListenerCount = Symbol('captureEventListenerCount');
@@ -13,8 +10,10 @@ export const checked = Symbol('checked');
 export const childNodes = Symbol('childNodes');
 export const children = Symbol('children');
 export const classList = Symbol('classList');
-export const computedStyle = Symbol('computedStyle');
-export const connectToNode = Symbol('connectToNode');
+export const connectedToNode = Symbol('connectedToNode');
+export const disconnectedFromNode = Symbol('disconnectedFromNode');
+export const connectedToDocument = Symbol('connectedToDocument');
+export const disconnectedFromDocument = Symbol('disconnectedFromDocument');
 export const contentLength = Symbol('contentLength');
 export const contentType = Symbol('contentType');
 export const cssText = Symbol('cssText');
@@ -30,22 +29,20 @@ export const evaluateCSS = Symbol('evaluateCSS');
 export const evaluateScript = Symbol('evaluateScript');
 export const exceptionObserver = Symbol('exceptionObserver');
 export const formNode = Symbol('formNode');
-export const getAttributeName = Symbol('getAttributeName');
 export const happyDOMSettingsID = Symbol('happyDOMSettingsID');
 export const height = Symbol('height');
 export const immediatePropagationStopped = Symbol('immediatePropagationStopped');
 export const isFirstWrite = Symbol('isFirstWrite');
 export const isFirstWriteAfterOpen = Symbol('isFirstWriteAfterOpen');
 export const isInPassiveEventListener = Symbol('isInPassiveEventListener');
-export const isValidPropertyName = Symbol('isValidPropertyName');
 export const isValue = Symbol('isValue');
 export const listenerOptions = Symbol('listenerOptions');
 export const listeners = Symbol('listeners');
 export const namedItems = Symbol('namedItems');
 export const nextActiveElement = Symbol('nextActiveElement');
-export const observe = Symbol('observe');
+export const observeMutations = Symbol('observeMutations');
 export const observedAttributes = Symbol('observedAttributes');
-export const observers = Symbol('observers');
+export const mutationListeners = Symbol('mutationListeners');
 export const ownerDocument = Symbol('ownerDocument');
 export const ownerElement = Symbol('ownerElement');
 export const propagationStopped = Symbol('propagationStopped');
@@ -53,25 +50,20 @@ export const readyStateManager = Symbol('readyStateManager');
 export const referrer = Symbol('referrer');
 export const registry = Symbol('registry');
 export const relList = Symbol('relList');
-export const removeFormControlItem = Symbol('removeFormControlItem');
-export const removeNamedItem = Symbol('removeNamedItem');
-export const removeNamedItemIndex = Symbol('removeNamedItemIndex');
-export const removeNamedItemWithoutConsequences = Symbol('removeNamedItemWithoutConsequences');
 export const resetSelection = Symbol('resetSelection');
 export const rootNode = Symbol('rootNode');
 export const selectNode = Symbol('selectNode');
 export const selectedness = Symbol('selectedness');
 export const selection = Symbol('selection');
-export const setNamedItemWithoutConsequences = Symbol('setNamedItemWithoutConsequences');
 export const setupVMContext = Symbol('setupVMContext');
 export const shadowRoot = Symbol('shadowRoot');
 export const start = Symbol('start');
 export const style = Symbol('style');
 export const target = Symbol('target');
 export const textAreaNode = Symbol('textAreaNode');
-export const unobserve = Symbol('unobserve');
-export const updateIndices = Symbol('updateIndices');
-export const updateOptionItems = Symbol('updateOptionItems');
+export const unobserveMutations = Symbol('unobserveMutations');
+export const reportMutation = Symbol('reportMutation');
+export const updateSelectedness = Symbol('updateSelectedness');
 export const url = Symbol('url');
 export const value = Symbol('value');
 export const width = Symbol('width');
@@ -79,7 +71,7 @@ export const window = Symbol('window');
 export const windowResizeListener = Symbol('windowResizeListener');
 export const mutationObservers = Symbol('mutationObservers');
 export const openerFrame = Symbol('openerFrame');
-export const openerWindow = Symbol('openerFrame');
+export const openerWindow = Symbol('openerWindow');
 export const popup = Symbol('popup');
 export const isConnected = Symbol('isConnected');
 export const parentNode = Symbol('parentNode');
@@ -91,6 +83,7 @@ export const scrollWidth = Symbol('scrollWidth');
 export const scrollTop = Symbol('scrollTop');
 export const scrollLeft = Symbol('scrollLeft');
 export const attributes = Symbol('attributes');
+export const attributesProxy = Symbol('attributesProxy');
 export const namespaceURI = Symbol('namespaceURI');
 export const accessKey = Symbol('accessKey');
 export const accessKeyLabel = Symbol('accessKeyLabel');
@@ -140,7 +133,6 @@ export const error = Symbol('error');
 export const ended = Symbol('ended');
 export const networkState = Symbol('networkState');
 export const textTracks = Symbol('textTracks');
-export const videoTracks = Symbol('videoTracks');
 export const seeking = Symbol('seeking');
 export const seekable = Symbol('seekable');
 export const played = Symbol('played');
@@ -164,5 +156,67 @@ export const appendChild = Symbol('appendChild');
 export const removeChild = Symbol('removeChild');
 export const insertBefore = Symbol('insertBefore');
 export const replaceChild = Symbol('replaceChild');
+export const tracks = Symbol('tracks');
+export const constraints = Symbol('constraints');
+export const capabilities = Symbol('capabilities');
+export const settings = Symbol('settings');
+export const clone = Symbol('clone');
+export const removeNamedItem = Symbol('removeNamedItem');
+export const items = Symbol('items');
+export const selectedOptions = Symbol('selectedOptions');
 export const styleNode = Symbol('styleNode');
 export const updateSheet = Symbol('updateSheet');
+export const clearCache = Symbol('clearCache');
+export const onSetAttribute = Symbol('onSetAttribute');
+export const onRemoveAttribute = Symbol('onRemoveAttribute');
+export const nodeArray = Symbol('nodeArray');
+export const elementArray = Symbol('elementArray');
+export const cache = Symbol('cache');
+export const affectsCache = Symbol('affectsCache');
+export const forms = Symbol('forms');
+export const affectsComputedStyleCache = Symbol('affectsComputedStyleCache');
+export const query = Symbol('query');
+export const computedStyle = Symbol('computedStyle');
+export const getFormControlItems = Symbol('getFormControlItems');
+export const getFormControlNamedItem = Symbol('getFormControlNamedItem');
+export const dataset = Symbol('dataset');
+export const customElementDefineCallback = Symbol('customElementDefineCallback');
+export const getNamespaceItemKey = Symbol('getNamespaceItemKey');
+export const getNamedItemKey = Symbol('getNamedItemKey');
+export const namespaceItems = Symbol('namespaceItems');
+export const proxy = Symbol('proxy');
+export const setNamedItem = Symbol('setNamedItem');
+export const getTokenList = Symbol('getTokenList');
+export const attributeName = Symbol('attributeName');
+export const selectedIndex = Symbol('selectedIndex');
+export const self = Symbol('self');
+export const parent = Symbol('parent');
+export const top = Symbol('top');
+export const areas = Symbol('areas');
+export const defaultValue = Symbol('defaultValue');
+export const elementIdMap = Symbol('elementIdMap');
+export const clonable = Symbol('clonable');
+export const delegatesFocus = Symbol('delegatesFocus');
+export const serializable = Symbol('serializable');
+export const slotAssignment = Symbol('slotAssignment');
+export const assignedNodes = Symbol('assignedNodes');
+export const assignedToSlot = Symbol('assignedToSlot');
+export const cells = Symbol('cells');
+export const rows = Symbol('rows');
+export const headers = Symbol('headers');
+export const tBodies = Symbol('tBodies');
+export const track = Symbol('track');
+export const controlsList = Symbol('controlsList');
+export const mediaKeys = Symbol('mediaKeys');
+export const remote = Symbol('remote');
+export const sinkId = Symbol('sinkId');
+export const srcObject = Symbol('srcObject');
+export const cues = Symbol('cues');
+export const activeCues = Symbol('activeCues');
+export const kind = Symbol('kind');
+export const label = Symbol('label');
+export const language = Symbol('language');
+export const id = Symbol('id');
+export const illegalConstructor = Symbol('illegalConstructor');
+export const state = Symbol('state');
+export const canvas = Symbol('canvas');

package/src/browser/BrowserFrame.ts

@@ -14,6 +14,8 @@ import IReloadOptions from './types/IReloadOptions.js';
 import BrowserFrameExceptionObserver from './utilities/BrowserFrameExceptionObserver.js';
 import BrowserErrorCaptureEnum from './enums/BrowserErrorCaptureEnum.js';
 import Document from '../nodes/document/Document.js';
+import IHistoryItem from '../history/IHistoryItem.js';
+import HistoryScrollRestorationEnum from '../history/HistoryScrollRestorationEnum.js';
 
 /**
  * Browser frame.
@@ -29,6 +31,17 @@ export default class BrowserFrame implements IBrowserFrame {
 	public [PropertySymbol.openerFrame]: IBrowserFrame | null = null;
 	public [PropertySymbol.openerWindow]: BrowserWindow | CrossOriginBrowserWindow | null = null;
 	public [PropertySymbol.popup] = false;
+	public [PropertySymbol.history]: IHistoryItem[] = [
+		{
+			title: '',
+			href: 'about:blank',
+			state: null,
+			scrollRestoration: HistoryScrollRestorationEnum.auto,
+			method: 'GET',
+			formData: null,
+			isCurrent: true
+		}
+	];
 
 	/**
 	 * Constructor.
@@ -159,17 +172,57 @@ export default class BrowserFrame implements IBrowserFrame {
 		});
 	}
 
+	/**
+	 * Navigates back in history.
+	 *
+	 * @param [options] Options.
+	 */
+	public goBack(options?: IGoToOptions): Promise<Response | null> {
+		return BrowserFrameNavigator.navigateBack({
+			windowClass: BrowserWindow,
+			frame: this,
+			goToOptions: options
+		});
+	}
+
+	/**
+	 * Navigates forward in history.
+	 *
+	 * @param [options] Options.
+	 */
+	public goForward(options?: IGoToOptions): Promise<Response | null> {
+		return BrowserFrameNavigator.navigateForward({
+			windowClass: BrowserWindow,
+			frame: this,
+			goToOptions: options
+		});
+	}
+
+	/**
+	 * Navigates a delta in history.
+	 *
+	 * @param steps Steps.
+	 * @param [options] Options.
+	 */
+	public goSteps(steps?: number, options?: IGoToOptions): Promise<Response | null> {
+		return BrowserFrameNavigator.navigateSteps({
+			windowClass: BrowserWindow,
+			frame: this,
+			steps: steps,
+			goToOptions: options
+		});
+	}
+
 	/**
 	 * Reloads the current frame.
 	 *
 	 * @param [options] Options.
 	 * @returns Response.
 	 */
-	public reload(options: IReloadOptions): Promise<Response | null> {
-		return BrowserFrameNavigator.navigate({
+	public reload(options?: IReloadOptions): Promise<Response | null> {
+		return BrowserFrameNavigator.reload({
 			windowClass: BrowserWindow,
 			frame: this,
-			url: this.url,
 			goToOptions: options
 		});
 	}

package/src/browser/BrowserPage.ts

@@ -141,13 +141,42 @@ export default class BrowserPage implements IBrowserPage {
 		return this.mainFrame.goto(url, options);
 	}
 
+	/**
+	 * Navigates back in history.
+	 *
+	 * @param [options] Options.
+	 */
+	public goBack(options?: IGoToOptions): Promise<Response | null> {
+		return this.mainFrame.goBack(options);
+	}
+
+	/**
+	 * Navigates forward in history.
+	 *
+	 * @param [options] Options.
+	 */
+	public goForward(options?: IGoToOptions): Promise<Response | null> {
+		return this.mainFrame.goForward(options);
+	}
+
+	/**
+	 * Navigates a delta in history.
+	 *
+	 * @param delta Delta.
+	 * @param steps
+	 * @param [options] Options.
+	 */
+	public goSteps(steps?: number, options?: IGoToOptions): Promise<Response | null> {
+		return this.mainFrame.goSteps(steps, options);
+	}
+
 	/**
 	 * Reloads the current page.
 	 *
 	 * @param [options] Options.
 	 * @returns Response.
 	 */
-	public reload(options: IReloadOptions): Promise<Response | null> {
+	public reload(options?: IReloadOptions): Promise<Response | null> {
 		return this.mainFrame.reload(options);
 	}
 }

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

@@ -14,6 +14,8 @@ import BrowserErrorCaptureEnum from '../enums/BrowserErrorCaptureEnum.js';
 import BrowserFrameExceptionObserver from '../utilities/BrowserFrameExceptionObserver.js';
 import Document from '../../nodes/document/Document.js';
 import CrossOriginBrowserWindow from '../../window/CrossOriginBrowserWindow.js';
+import IHistoryItem from '../../history/IHistoryItem.js';
+import HistoryScrollRestorationEnum from '../../history/HistoryScrollRestorationEnum.js';
 
 /**
  * Browser frame used when constructing a Window instance without a browser.
@@ -30,6 +32,17 @@ export default class DetachedBrowserFrame implements IBrowserFrame {
 	public [PropertySymbol.openerFrame]: IBrowserFrame | null = null;
 	public [PropertySymbol.openerWindow]: BrowserWindow | CrossOriginBrowserWindow | null = null;
 	public [PropertySymbol.popup] = false;
+	public [PropertySymbol.history]: IHistoryItem[] = [
+		{
+			title: '',
+			href: 'about:blank',
+			state: null,
+			scrollRestoration: HistoryScrollRestorationEnum.auto,
+			method: 'GET',
+			formData: null,
+			isCurrent: true
+		}
+	];
 
 	/**
 	 * Constructor.
@@ -175,17 +188,57 @@ export default class DetachedBrowserFrame implements IBrowserFrame {
 		});
 	}
 
+	/**
+	 * Navigates back in history.
+	 *
+	 * @param [options] Options.
+	 */
+	public goBack(options?: IGoToOptions): Promise<Response | null> {
+		return BrowserFrameNavigator.navigateBack({
+			windowClass: this.page.context.browser.windowClass,
+			frame: this,
+			goToOptions: options
+		});
+	}
+
+	/**
+	 * Navigates forward in history.
+	 *
+	 * @param [options] Options.
+	 */
+	public goForward(options?: IGoToOptions): Promise<Response | null> {
+		return BrowserFrameNavigator.navigateForward({
+			windowClass: this.page.context.browser.windowClass,
+			frame: this,
+			goToOptions: options
+		});
+	}
+
+	/**
+	 * Navigates a delta in history.
+	 *
+	 * @param steps Steps.
+	 * @param [options] Options.
+	 */
+	public goSteps(steps?: number, options?: IGoToOptions): Promise<Response | null> {
+		return BrowserFrameNavigator.navigateSteps({
+			windowClass: this.page.context.browser.windowClass,
+			frame: this,
+			steps: steps,
+			goToOptions: options
+		});
+	}
+
 	/**
 	 * Reloads the current frame.
 	 *
 	 * @param [options] Options.
 	 * @returns Response.
 	 */
-	public reload(options: IReloadOptions): Promise<Response | null> {
-		return BrowserFrameNavigator.navigate({
+	public reload(options?: IReloadOptions): Promise<Response | null> {
+		return BrowserFrameNavigator.reload({
 			windowClass: this.page.context.browser.windowClass,
 			frame: this,
-			url: this.url,
 			goToOptions: options
 		});
 	}

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

@@ -154,13 +154,42 @@ export default class DetachedBrowserPage implements IBrowserPage {
 		return this.mainFrame.goto(url, options);
 	}
 
+	/**
+	 * Navigates back in history.
+	 *
+	 * @param [options] Options.
+	 */
+	public goBack(options?: IGoToOptions): Promise<Response | null> {
+		return this.mainFrame.goBack(options);
+	}
+
+	/**
+	 * Navigates forward in history.
+	 *
+	 * @param [options] Options.
+	 */
+	public goForward(options?: IGoToOptions): Promise<Response | null> {
+		return this.mainFrame.goForward(options);
+	}
+
+	/**
+	 * Navigates a delta in history.
+	 *
+	 * @param delta Delta.
+	 * @param steps
+	 * @param [options] Options.
+	 */
+	public goSteps(steps?: number, options?: IGoToOptions): Promise<Response | null> {
+		return this.mainFrame.goSteps(steps, options);
+	}
+
 	/**
 	 * Reloads the current page.
 	 *
 	 * @param [options] Options.
 	 * @returns Response.
 	 */
-	public reload(options: IReloadOptions): Promise<Response | null> {
+	public reload(options?: IReloadOptions): Promise<Response | null> {
 		return this.mainFrame.reload(options);
 	}
 }

package/src/browser/types/IBrowserFrame.ts

@@ -9,6 +9,7 @@ import { Script } from 'vm';
 import IReloadOptions from './IReloadOptions.js';
 import BrowserFrameExceptionObserver from '../utilities/BrowserFrameExceptionObserver.js';
 import CrossOriginBrowserWindow from '../../window/CrossOriginBrowserWindow.js';
+import IHistoryItem from '../../history/IHistoryItem.js';
 
 /**
  * Browser frame.
@@ -21,6 +22,7 @@ export default interface IBrowserFrame {
 	readonly document: Document;
 	content: string;
 	url: string;
+	[PropertySymbol.history]: IHistoryItem[];
 	[PropertySymbol.asyncTaskManager]: AsyncTaskManager;
 	[PropertySymbol.exceptionObserver]: BrowserFrameExceptionObserver | null;
 	[PropertySymbol.listeners]: { navigation: Array<() => void> };
@@ -59,6 +61,28 @@ export default interface IBrowserFrame {
 	 */
 	goto(url: string, options?: IGoToOptions): Promise<Response | null>;
 
+	/**
+	 * Navigates back in history.
+	 *
+	 * @param [options] Options.
+	 */
+	goBack(options?: IGoToOptions): Promise<Response | null>;
+
+	/**
+	 * Navigates forward in history.
+	 *
+	 * @param [options] Options.
+	 */
+	goForward(options?: IGoToOptions): Promise<Response | null>;
+
+	/**
+	 * Navigates a delta in history.
+	 *
+	 * @param steps Steps.
+	 * @param [options] Options.
+	 */
+	goSteps(steps?: number, options?: IGoToOptions): Promise<Response | null>;
+
 	/**
 	 * Reloads the current frame.
 	 *

package/src/browser/types/IBrowserPage.ts

@@ -61,11 +61,33 @@ export default interface IBrowserPage {
 	 */
 	goto(url: string, options?: IGoToOptions): Promise<Response | null>;
 
+	/**
+	 * Navigates back in history.
+	 *
+	 * @param [options] Options.
+	 */
+	goBack(options?: IGoToOptions): Promise<Response | null>;
+
+	/**
+	 * Navigates forward in history.
+	 *
+	 * @param [options] Options.
+	 */
+	goForward(options?: IGoToOptions): Promise<Response | null>;
+
+	/**
+	 * Navigates a delta in history.
+	 *
+	 * @param steps Steps.
+	 * @param [options] Options.
+	 */
+	goSteps(steps?: number, options?: IGoToOptions): Promise<Response | null>;
+
 	/**
 	 * Reloads the current page.
 	 *
 	 * @param [options] Options.
 	 * @returns Response.
 	 */
-	reload(options: IReloadOptions): Promise<Response | null>;
+	reload(options?: IReloadOptions): Promise<Response | null>;
 }