import VirtualConsolePrinter from '../console/VirtualConsolePrinter.js'; import BrowserFrame from './BrowserFrame.js'; import BrowserContext from './BrowserContext.js'; import VirtualConsole from '../console/VirtualConsole.js'; import IBrowserPage from './types/IBrowserPage.js'; import BrowserPageUtility from './utilities/BrowserPageUtility.js'; import { Script } from 'vm'; import IGoToOptions from './types/IGoToOptions.js'; import Response from '../fetch/Response.js'; import IReloadOptions from './types/IReloadOptions.js'; import IBrowserPageViewport from './types/IBrowserPageViewport.js'; import IOptionalBrowserPageViewport from './types/IOptionalBrowserPageViewport.js'; import DefaultBrowserPageViewport from './DefaultBrowserPageViewport.js'; import Event from '../event/Event.js'; /** * Browser page. */ export default class BrowserPage implements IBrowserPage { public readonly virtualConsolePrinter = new VirtualConsolePrinter(); public readonly mainFrame: BrowserFrame; public readonly context: BrowserContext; public readonly console: Console; public readonly viewport: IBrowserPageViewport = Object.assign({}, DefaultBrowserPageViewport); /** * Constructor. * * @param context Browser context. */ constructor(context: BrowserContext) { this.context = context; this.console = context.browser.console ?? new VirtualConsole(this.virtualConsolePrinter); this.mainFrame = new BrowserFrame(this); } /** * Returns frames. */ public get frames(): BrowserFrame[] { return BrowserPageUtility.getFrames(this); } /** * Returns the viewport. */ public get content(): string { return this.mainFrame.content; } /** * Sets the content. * * @param content Content. */ public set content(content) { this.mainFrame.content = content; } /** * Returns the URL. * * @returns URL. */ public get url(): string { return this.mainFrame.url; } /** * Sets the content. * * @param url URL. */ public set url(url) { this.mainFrame.url = url; } /** * Aborts all ongoing operations and destroys the page. */ public close(): Promise { return BrowserPageUtility.closePage(this); } /** * Returns a promise that is resolved when all resources has been loaded, fetch has completed, and all async tasks such as timers are complete. */ public waitUntilComplete(): Promise { return this.mainFrame.waitUntilComplete(); } /** * Returns a promise that is resolved when the page has navigated and the response HTML has been written to the document. */ public waitForNavigation(): Promise { return this.mainFrame.waitForNavigation(); } /** * Aborts all ongoing operations. */ public abort(): Promise { return this.mainFrame.abort(); } /** * Evaluates code or a VM Script in the page's context. * * @param script Script. * @returns Result. */ public evaluate(script: string | Script): any { return this.mainFrame.evaluate(script); } /** * Sets the viewport. * * @param viewport Viewport. */ public setViewport(viewport: IOptionalBrowserPageViewport): void { const previousViewport = Object.assign({}, this.viewport); Object.assign(this.viewport, viewport); if ( previousViewport.width !== this.viewport.width || previousViewport.height !== this.viewport.height || previousViewport.devicePixelRatio !== this.viewport.devicePixelRatio ) { this.mainFrame.window.dispatchEvent(new Event('resize')); } } /** * Go to a page. * * @param url URL. * @param [options] Options. * @returns Response. */ public goto(url: string, options?: IGoToOptions): Promise { return this.mainFrame.goto(url, options); } /** * Navigates back in history. * * @param [options] Options. */ public goBack(options?: IGoToOptions): Promise { return this.mainFrame.goBack(options); } /** * Navigates forward in history. * * @param [options] Options. */ public goForward(options?: IGoToOptions): Promise { 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 { return this.mainFrame.goSteps(steps, options); } /** * Reloads the current page. * * @param [options] Options. * @returns Response. */ public reload(options?: IReloadOptions): Promise { return this.mainFrame.reload(options); } }