2020-06-26 02:05:36 +03:00
|
|
|
/**
|
|
|
|
* Copyright 2017 Google Inc. All rights reserved.
|
|
|
|
* Modifications copyright (c) Microsoft Corporation.
|
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
import { Events } from './events';
|
2020-08-18 00:36:51 +03:00
|
|
|
import { assert, helper, Listener } from '../../helper';
|
2020-06-30 20:55:11 +03:00
|
|
|
import { TimeoutSettings } from '../../timeoutSettings';
|
2020-07-30 03:26:59 +03:00
|
|
|
import { BindingCallChannel, BindingCallInitializer, PageChannel, PageInitializer, PagePdfParams, FrameWaitForSelectorOptions, FrameDispatchEventOptions, FrameSetContentOptions, FrameGotoOptions, PageReloadOptions, PageGoBackOptions, PageGoForwardOptions, PageScreenshotOptions, FrameClickOptions, FrameDblclickOptions, FrameFillOptions, FrameFocusOptions, FrameTextContentOptions, FrameInnerTextOptions, FrameInnerHTMLOptions, FrameGetAttributeOptions, FrameHoverOptions, FrameSetInputFilesOptions, FrameTypeOptions, FramePressOptions, FrameCheckOptions, FrameUncheckOptions } from '../channels';
|
2020-07-29 01:33:38 +03:00
|
|
|
import { parseError, serializeError } from '../serializers';
|
|
|
|
import { headersObjectToArray } from '../../converters';
|
2020-06-26 04:01:18 +03:00
|
|
|
import { Accessibility } from './accessibility';
|
2020-06-30 20:55:11 +03:00
|
|
|
import { BrowserContext } from './browserContext';
|
|
|
|
import { ChannelOwner } from './channelOwner';
|
2020-06-26 22:28:27 +03:00
|
|
|
import { ConsoleMessage } from './consoleMessage';
|
2020-06-27 03:24:21 +03:00
|
|
|
import { Dialog } from './dialog';
|
|
|
|
import { Download } from './download';
|
2020-06-30 20:55:11 +03:00
|
|
|
import { ElementHandle } from './elementHandle';
|
|
|
|
import { Worker } from './worker';
|
2020-07-30 03:26:59 +03:00
|
|
|
import { Frame, FunctionWithSource, verifyLoadState, WaitForNavigationOptions } from './frame';
|
2020-06-30 20:55:11 +03:00
|
|
|
import { Keyboard, Mouse } from './input';
|
2020-08-18 00:36:51 +03:00
|
|
|
import { assertMaxArguments, Func1, FuncOn, SmartHandle, serializeArgument, parseResult } from './jsHandle';
|
2020-06-30 20:55:11 +03:00
|
|
|
import { Request, Response, Route, RouteHandler } from './network';
|
|
|
|
import { FileChooser } from './fileChooser';
|
|
|
|
import { Buffer } from 'buffer';
|
2020-07-27 07:27:09 +03:00
|
|
|
import { ChromiumCoverage } from './chromiumCoverage';
|
2020-07-14 02:03:24 +03:00
|
|
|
import { Waiter } from './waiter';
|
2020-06-26 02:05:36 +03:00
|
|
|
|
2020-07-14 20:51:37 +03:00
|
|
|
import * as fs from 'fs';
|
|
|
|
import * as util from 'util';
|
2020-07-30 03:26:59 +03:00
|
|
|
import { Size, URLMatch, Headers, LifecycleEvent, WaitForEventOptions, SelectOption, SelectOptionOptions, FilePayload, WaitForFunctionOptions } from './types';
|
|
|
|
|
|
|
|
type PDFOptions = Omit<PagePdfParams, 'width' | 'height' | 'margin'> & {
|
|
|
|
width?: string | number,
|
|
|
|
height?: string | number,
|
|
|
|
margin?: {
|
|
|
|
top?: string | number,
|
|
|
|
bottom?: string | number,
|
|
|
|
left?: string | number,
|
|
|
|
right?: string | number
|
|
|
|
},
|
|
|
|
path?: string,
|
|
|
|
};
|
2020-07-14 20:51:37 +03:00
|
|
|
|
|
|
|
const fsWriteFileAsync = util.promisify(fs.writeFile.bind(fs));
|
|
|
|
|
2020-06-26 22:28:27 +03:00
|
|
|
export class Page extends ChannelOwner<PageChannel, PageInitializer> {
|
2020-07-14 01:26:09 +03:00
|
|
|
private _browserContext: BrowserContext;
|
2020-06-27 03:24:21 +03:00
|
|
|
_ownedContext: BrowserContext | undefined;
|
|
|
|
|
2020-06-26 22:28:27 +03:00
|
|
|
private _mainFrame: Frame;
|
2020-06-26 02:05:36 +03:00
|
|
|
private _frames = new Set<Frame>();
|
2020-06-30 20:55:11 +03:00
|
|
|
_workers = new Set<Worker>();
|
2020-06-26 02:05:36 +03:00
|
|
|
private _closed = false;
|
2020-07-30 03:26:59 +03:00
|
|
|
private _viewportSize: Size | null;
|
|
|
|
private _routes: { url: URLMatch, handler: RouteHandler }[] = [];
|
2020-06-26 02:05:36 +03:00
|
|
|
|
2020-06-26 04:01:18 +03:00
|
|
|
readonly accessibility: Accessibility;
|
|
|
|
readonly keyboard: Keyboard;
|
|
|
|
readonly mouse: Mouse;
|
2020-07-27 07:27:09 +03:00
|
|
|
coverage: ChromiumCoverage | null = null;
|
2020-07-30 03:26:59 +03:00
|
|
|
pdf?: (options?: PDFOptions) => Promise<Buffer>;
|
2020-07-14 01:26:09 +03:00
|
|
|
|
2020-06-26 21:51:47 +03:00
|
|
|
readonly _bindings = new Map<string, FunctionWithSource>();
|
2020-07-14 02:03:24 +03:00
|
|
|
readonly _timeoutSettings: TimeoutSettings;
|
2020-06-30 04:58:09 +03:00
|
|
|
_isPageCall = false;
|
2020-06-26 04:01:18 +03:00
|
|
|
|
2020-06-26 02:05:36 +03:00
|
|
|
static from(page: PageChannel): Page {
|
2020-07-02 04:36:09 +03:00
|
|
|
return (page as any)._object;
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-21 03:38:06 +03:00
|
|
|
static fromNullable(page: PageChannel | undefined): Page | null {
|
2020-06-26 02:05:36 +03:00
|
|
|
return page ? Page.from(page) : null;
|
|
|
|
}
|
|
|
|
|
2020-07-11 04:00:10 +03:00
|
|
|
constructor(parent: ChannelOwner, type: string, guid: string, initializer: PageInitializer) {
|
|
|
|
super(parent, type, guid, initializer);
|
2020-07-16 04:48:19 +03:00
|
|
|
this.setMaxListeners(0);
|
2020-07-14 01:26:09 +03:00
|
|
|
this._browserContext = parent as BrowserContext;
|
|
|
|
this._timeoutSettings = new TimeoutSettings(this._browserContext._timeoutSettings);
|
|
|
|
|
2020-07-01 23:55:29 +03:00
|
|
|
this.accessibility = new Accessibility(this._channel);
|
|
|
|
this.keyboard = new Keyboard(this._channel);
|
|
|
|
this.mouse = new Mouse(this._channel);
|
2020-06-26 02:05:36 +03:00
|
|
|
|
2020-06-26 22:28:27 +03:00
|
|
|
this._mainFrame = Frame.from(initializer.mainFrame);
|
|
|
|
this._mainFrame._page = this;
|
2020-06-26 02:05:36 +03:00
|
|
|
this._frames.add(this._mainFrame);
|
2020-07-21 03:38:06 +03:00
|
|
|
this._viewportSize = initializer.viewportSize || null;
|
2020-07-10 23:15:39 +03:00
|
|
|
this._closed = initializer.isClosed;
|
2020-06-26 02:05:36 +03:00
|
|
|
|
2020-07-15 04:26:50 +03:00
|
|
|
this._channel.on('bindingCall', ({ binding }) => this._onBinding(BindingCall.from(binding)));
|
2020-06-26 21:51:47 +03:00
|
|
|
this._channel.on('close', () => this._onClose());
|
2020-07-15 04:26:50 +03:00
|
|
|
this._channel.on('console', ({ message }) => this.emit(Events.Page.Console, ConsoleMessage.from(message)));
|
2020-06-27 07:22:03 +03:00
|
|
|
this._channel.on('crash', () => this._onCrash());
|
2020-07-15 04:26:50 +03:00
|
|
|
this._channel.on('dialog', ({ dialog }) => this.emit(Events.Page.Dialog, Dialog.from(dialog)));
|
2020-06-27 07:22:03 +03:00
|
|
|
this._channel.on('domcontentloaded', () => this.emit(Events.Page.DOMContentLoaded));
|
2020-07-15 04:26:50 +03:00
|
|
|
this._channel.on('download', ({ download }) => this.emit(Events.Page.Download, Download.from(download)));
|
2020-06-30 20:55:11 +03:00
|
|
|
this._channel.on('fileChooser', ({ element, isMultiple }) => this.emit(Events.Page.FileChooser, new FileChooser(this, ElementHandle.from(element), isMultiple)));
|
2020-07-15 04:26:50 +03:00
|
|
|
this._channel.on('frameAttached', ({ frame }) => this._onFrameAttached(Frame.from(frame)));
|
|
|
|
this._channel.on('frameDetached', ({ frame }) => this._onFrameDetached(Frame.from(frame)));
|
2020-06-27 07:22:03 +03:00
|
|
|
this._channel.on('load', () => this.emit(Events.Page.Load));
|
2020-06-26 21:51:47 +03:00
|
|
|
this._channel.on('pageError', ({ error }) => this.emit(Events.Page.PageError, parseError(error)));
|
2020-07-15 04:26:50 +03:00
|
|
|
this._channel.on('popup', ({ page }) => this.emit(Events.Page.Popup, Page.from(page)));
|
|
|
|
this._channel.on('request', ({ request }) => this.emit(Events.Page.Request, Request.from(request)));
|
2020-06-26 21:51:47 +03:00
|
|
|
this._channel.on('requestFailed', ({ request, failureText }) => this._onRequestFailed(Request.from(request), failureText));
|
2020-07-15 04:26:50 +03:00
|
|
|
this._channel.on('requestFinished', ({ request }) => this.emit(Events.Page.RequestFinished, Request.from(request)));
|
|
|
|
this._channel.on('response', ({ response }) => this.emit(Events.Page.Response, Response.from(response)));
|
2020-06-26 21:51:47 +03:00
|
|
|
this._channel.on('route', ({ route, request }) => this._onRoute(Route.from(route), Request.from(request)));
|
2020-07-15 04:26:50 +03:00
|
|
|
this._channel.on('worker', ({ worker }) => this._onWorker(Worker.from(worker)));
|
2020-06-26 21:51:47 +03:00
|
|
|
|
2020-07-14 07:46:59 +03:00
|
|
|
if (this._browserContext._browserName === 'chromium') {
|
2020-07-27 07:27:09 +03:00
|
|
|
this.coverage = new ChromiumCoverage(this._channel);
|
2020-07-14 01:26:09 +03:00
|
|
|
this.pdf = options => this._pdf(options);
|
|
|
|
}
|
2020-06-27 07:22:03 +03:00
|
|
|
}
|
|
|
|
|
2020-07-21 03:38:06 +03:00
|
|
|
private _onRequestFailed(request: Request, failureText: string | undefined) {
|
|
|
|
request._failureText = failureText || null;
|
2020-06-26 21:51:47 +03:00
|
|
|
this.emit(Events.Page.RequestFailed, request);
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
private _onFrameAttached(frame: Frame) {
|
2020-06-26 22:28:27 +03:00
|
|
|
frame._page = this;
|
2020-06-26 02:05:36 +03:00
|
|
|
this._frames.add(frame);
|
|
|
|
if (frame._parentFrame)
|
|
|
|
frame._parentFrame._childFrames.add(frame);
|
|
|
|
this.emit(Events.Page.FrameAttached, frame);
|
|
|
|
}
|
|
|
|
|
|
|
|
private _onFrameDetached(frame: Frame) {
|
|
|
|
this._frames.delete(frame);
|
2020-06-27 03:24:21 +03:00
|
|
|
frame._detached = true;
|
2020-06-26 02:05:36 +03:00
|
|
|
if (frame._parentFrame)
|
|
|
|
frame._parentFrame._childFrames.delete(frame);
|
|
|
|
this.emit(Events.Page.FrameDetached, frame);
|
|
|
|
}
|
|
|
|
|
2020-06-26 21:51:47 +03:00
|
|
|
private _onRoute(route: Route, request: Request) {
|
|
|
|
for (const {url, handler} of this._routes) {
|
|
|
|
if (helper.urlMatches(request.url(), url)) {
|
|
|
|
handler(route, request);
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
}
|
2020-07-14 01:26:09 +03:00
|
|
|
this._browserContext._onRoute(route, request);
|
2020-06-26 21:51:47 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async _onBinding(bindingCall: BindingCall) {
|
2020-06-26 22:28:27 +03:00
|
|
|
const func = this._bindings.get(bindingCall._initializer.name);
|
2020-07-04 04:04:08 +03:00
|
|
|
if (func) {
|
2020-06-26 21:51:47 +03:00
|
|
|
bindingCall.call(func);
|
2020-07-04 04:04:08 +03:00
|
|
|
return;
|
|
|
|
}
|
2020-07-14 01:26:09 +03:00
|
|
|
this._browserContext._onBinding(bindingCall);
|
2020-06-26 21:51:47 +03:00
|
|
|
}
|
|
|
|
|
2020-06-30 20:55:11 +03:00
|
|
|
_onWorker(worker: Worker): void {
|
|
|
|
this._workers.add(worker);
|
|
|
|
worker._page = this;
|
|
|
|
this.emit(Events.Page.Worker, worker);
|
|
|
|
}
|
|
|
|
|
2020-08-13 23:24:49 +03:00
|
|
|
_onClose() {
|
2020-06-27 07:22:03 +03:00
|
|
|
this._closed = true;
|
2020-07-14 01:26:09 +03:00
|
|
|
this._browserContext._pages.delete(this);
|
2020-06-26 02:05:36 +03:00
|
|
|
this.emit(Events.Page.Close);
|
|
|
|
}
|
|
|
|
|
2020-06-27 07:22:03 +03:00
|
|
|
private _onCrash() {
|
|
|
|
this.emit(Events.Page.Crash);
|
|
|
|
}
|
|
|
|
|
2020-06-26 02:05:36 +03:00
|
|
|
context(): BrowserContext {
|
2020-07-14 01:26:09 +03:00
|
|
|
return this._browserContext;
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async opener(): Promise<Page | null> {
|
2020-07-15 04:26:50 +03:00
|
|
|
return Page.fromNullable((await this._channel.opener()).page);
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
mainFrame(): Frame {
|
2020-06-26 22:28:27 +03:00
|
|
|
return this._mainFrame;
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
frame(options: string | { name?: string, url?: URLMatch }): Frame | null {
|
2020-06-26 02:05:36 +03:00
|
|
|
const name = helper.isString(options) ? options : options.name;
|
|
|
|
const url = helper.isObject(options) ? options.url : undefined;
|
|
|
|
assert(name || url, 'Either name or url matcher should be specified');
|
|
|
|
return this.frames().find(f => {
|
|
|
|
if (name)
|
|
|
|
return f.name() === name;
|
|
|
|
return helper.urlMatches(f.url(), url);
|
|
|
|
}) || null;
|
|
|
|
}
|
|
|
|
|
|
|
|
frames(): Frame[] {
|
|
|
|
return [...this._frames];
|
|
|
|
}
|
|
|
|
|
|
|
|
setDefaultNavigationTimeout(timeout: number) {
|
2020-07-14 02:03:24 +03:00
|
|
|
this._timeoutSettings.setDefaultNavigationTimeout(timeout);
|
2020-06-26 02:05:36 +03:00
|
|
|
this._channel.setDefaultNavigationTimeoutNoReply({ timeout });
|
|
|
|
}
|
|
|
|
|
|
|
|
setDefaultTimeout(timeout: number) {
|
2020-06-27 07:22:03 +03:00
|
|
|
this._timeoutSettings.setDefaultTimeout(timeout);
|
2020-06-26 02:05:36 +03:00
|
|
|
this._channel.setDefaultTimeoutNoReply({ timeout });
|
|
|
|
}
|
|
|
|
|
2020-06-30 04:58:09 +03:00
|
|
|
private _attributeToPage<T>(func: () => T): T {
|
|
|
|
try {
|
|
|
|
this._isPageCall = true;
|
|
|
|
return func();
|
|
|
|
} finally {
|
|
|
|
this._isPageCall = false;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2020-06-26 02:05:36 +03:00
|
|
|
async $(selector: string): Promise<ElementHandle<Element> | null> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.$(selector));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async waitForSelector(selector: string, options?: FrameWaitForSelectorOptions): Promise<ElementHandle<Element> | null> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.waitForSelector(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async dispatchEvent(selector: string, type: string, eventInit?: any, options?: FrameDispatchEventOptions): Promise<void> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.dispatchEvent(selector, type, eventInit, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async evaluateHandle<R, Arg>(pageFunction: Func1<Arg, R>, arg: Arg): Promise<SmartHandle<R>>;
|
|
|
|
async evaluateHandle<R>(pageFunction: Func1<void, R>, arg?: any): Promise<SmartHandle<R>>;
|
|
|
|
async evaluateHandle<R, Arg>(pageFunction: Func1<Arg, R>, arg: Arg): Promise<SmartHandle<R>> {
|
|
|
|
assertMaxArguments(arguments.length, 2);
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.evaluateHandle(pageFunction, arg));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async $eval<R, Arg>(selector: string, pageFunction: FuncOn<Element, Arg, R>, arg: Arg): Promise<R>;
|
|
|
|
async $eval<R>(selector: string, pageFunction: FuncOn<Element, void, R>, arg?: any): Promise<R>;
|
|
|
|
async $eval<R, Arg>(selector: string, pageFunction: FuncOn<Element, Arg, R>, arg: Arg): Promise<R> {
|
|
|
|
assertMaxArguments(arguments.length, 3);
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.$eval(selector, pageFunction, arg));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async $$eval<R, Arg>(selector: string, pageFunction: FuncOn<Element[], Arg, R>, arg: Arg): Promise<R>;
|
|
|
|
async $$eval<R>(selector: string, pageFunction: FuncOn<Element[], void, R>, arg?: any): Promise<R>;
|
|
|
|
async $$eval<R, Arg>(selector: string, pageFunction: FuncOn<Element[], Arg, R>, arg: Arg): Promise<R> {
|
|
|
|
assertMaxArguments(arguments.length, 3);
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.$$eval(selector, pageFunction, arg));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async $$(selector: string): Promise<ElementHandle<Element>[]> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.$$(selector));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async addScriptTag(options: { url?: string; path?: string; content?: string; type?: string; }): Promise<ElementHandle> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.addScriptTag(options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async addStyleTag(options: { url?: string; path?: string; content?: string; }): Promise<ElementHandle> {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.addStyleTag(options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async exposeFunction(name: string, playwrightFunction: Function) {
|
|
|
|
await this.exposeBinding(name, (options, ...args: any) => playwrightFunction(...args));
|
|
|
|
}
|
|
|
|
|
2020-08-01 03:00:36 +03:00
|
|
|
async exposeBinding(name: string, playwrightBinding: FunctionWithSource) {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.exposeBinding', async () => {
|
|
|
|
if (this._bindings.has(name))
|
|
|
|
throw new Error(`Function "${name}" has been already registered`);
|
|
|
|
if (this._browserContext._bindings.has(name))
|
|
|
|
throw new Error(`Function "${name}" has been already registered in the browser context`);
|
2020-08-01 03:00:36 +03:00
|
|
|
this._bindings.set(name, playwrightBinding);
|
2020-07-17 00:32:21 +03:00
|
|
|
await this._channel.exposeBinding({ name });
|
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async setExtraHTTPHeaders(headers: Headers) {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.setExtraHTTPHeaders', async () => {
|
|
|
|
await this._channel.setExtraHTTPHeaders({ headers: headersObjectToArray(headers) });
|
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
url(): string {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.url());
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async content(): Promise<string> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.content());
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async setContent(html: string, options?: FrameSetContentOptions): Promise<void> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.setContent(html, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async goto(url: string, options?: FrameGotoOptions): Promise<Response | null> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.goto(url, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async reload(options: PageReloadOptions = {}): Promise<Response | null> {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.reload', async () => {
|
2020-07-23 04:05:07 +03:00
|
|
|
const waitUntil = verifyLoadState('waitUntil', options.waitUntil === undefined ? 'load' : options.waitUntil);
|
|
|
|
return Response.fromNullable((await this._channel.reload({ ...options, waitUntil })).response);
|
2020-07-17 00:32:21 +03:00
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async waitForLoadState(state?: LifecycleEvent, options?: { timeout?: number }): Promise<void> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.waitForLoadState(state, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async waitForNavigation(options?: WaitForNavigationOptions): Promise<Response | null> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.waitForNavigation(options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async waitForRequest(urlOrPredicate: string | RegExp | ((r: Request) => boolean), options: { timeout?: number } = {}): Promise<Request> {
|
2020-06-26 02:05:36 +03:00
|
|
|
const predicate = (request: Request) => {
|
|
|
|
if (helper.isString(urlOrPredicate) || helper.isRegExp(urlOrPredicate))
|
|
|
|
return helper.urlMatches(request.url(), urlOrPredicate);
|
|
|
|
return urlOrPredicate(request);
|
|
|
|
};
|
|
|
|
return this.waitForEvent(Events.Page.Request, { predicate, timeout: options.timeout });
|
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async waitForResponse(urlOrPredicate: string | RegExp | ((r: Response) => boolean), options: { timeout?: number } = {}): Promise<Response> {
|
2020-06-26 02:05:36 +03:00
|
|
|
const predicate = (response: Response) => {
|
|
|
|
if (helper.isString(urlOrPredicate) || helper.isRegExp(urlOrPredicate))
|
|
|
|
return helper.urlMatches(response.url(), urlOrPredicate);
|
|
|
|
return urlOrPredicate(response);
|
|
|
|
};
|
|
|
|
return this.waitForEvent(Events.Page.Response, { predicate, timeout: options.timeout });
|
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async waitForEvent(event: string, optionsOrPredicate: WaitForEventOptions = {}): Promise<any> {
|
2020-07-17 08:38:52 +03:00
|
|
|
const timeout = this._timeoutSettings.timeout(typeof optionsOrPredicate === 'function' ? {} : optionsOrPredicate);
|
|
|
|
const predicate = typeof optionsOrPredicate === 'function' ? optionsOrPredicate : optionsOrPredicate.predicate;
|
2020-07-14 02:03:24 +03:00
|
|
|
const waiter = new Waiter();
|
2020-07-22 09:48:21 +03:00
|
|
|
waiter.rejectOnTimeout(timeout, `Timeout while waiting for event "${event}"`);
|
2020-07-14 02:03:24 +03:00
|
|
|
if (event !== Events.Page.Crash)
|
|
|
|
waiter.rejectOnEvent(this, Events.Page.Crash, new Error('Page crashed'));
|
|
|
|
if (event !== Events.Page.Close)
|
|
|
|
waiter.rejectOnEvent(this, Events.Page.Close, new Error('Page closed'));
|
|
|
|
const result = await waiter.waitForEvent(this, event, predicate as any);
|
|
|
|
waiter.dispose();
|
2020-06-27 07:22:03 +03:00
|
|
|
return result;
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async goBack(options: PageGoBackOptions = {}): Promise<Response | null> {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.goBack', async () => {
|
2020-07-23 04:05:07 +03:00
|
|
|
const waitUntil = verifyLoadState('waitUntil', options.waitUntil === undefined ? 'load' : options.waitUntil);
|
|
|
|
return Response.fromNullable((await this._channel.goBack({ ...options, waitUntil })).response);
|
2020-07-17 00:32:21 +03:00
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async goForward(options: PageGoForwardOptions = {}): Promise<Response | null> {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.goForward', async () => {
|
2020-07-23 04:05:07 +03:00
|
|
|
const waitUntil = verifyLoadState('waitUntil', options.waitUntil === undefined ? 'load' : options.waitUntil);
|
|
|
|
return Response.fromNullable((await this._channel.goForward({ ...options, waitUntil })).response);
|
2020-07-17 00:32:21 +03:00
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async emulateMedia(options: { media?: 'screen' | 'print' | null, colorScheme?: 'dark' | 'light' | 'no-preference' | null }) {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.emulateMedia', async () => {
|
2020-07-22 04:56:41 +03:00
|
|
|
await this._channel.emulateMedia({
|
2020-07-23 04:05:07 +03:00
|
|
|
media: options.media === null ? 'null' : options.media,
|
|
|
|
colorScheme: options.colorScheme === null ? 'null' : options.colorScheme,
|
2020-07-22 04:56:41 +03:00
|
|
|
});
|
2020-07-17 00:32:21 +03:00
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async setViewportSize(viewportSize: Size) {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.setViewportSize', async () => {
|
|
|
|
this._viewportSize = viewportSize;
|
|
|
|
await this._channel.setViewportSize({ viewportSize });
|
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
viewportSize(): Size | null {
|
2020-06-26 02:05:36 +03:00
|
|
|
return this._viewportSize;
|
|
|
|
}
|
|
|
|
|
|
|
|
async evaluate<R, Arg>(pageFunction: Func1<Arg, R>, arg: Arg): Promise<R>;
|
|
|
|
async evaluate<R>(pageFunction: Func1<void, R>, arg?: any): Promise<R>;
|
|
|
|
async evaluate<R, Arg>(pageFunction: Func1<Arg, R>, arg: Arg): Promise<R> {
|
|
|
|
assertMaxArguments(arguments.length, 2);
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.evaluate(pageFunction, arg));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async addInitScript(script: Function | string | { path?: string, content?: string }, arg?: any) {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.addInitScript', async () => {
|
|
|
|
const source = await helper.evaluationScript(script, arg);
|
|
|
|
await this._channel.addInitScript({ source });
|
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async route(url: URLMatch, handler: RouteHandler): Promise<void> {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.route', async () => {
|
|
|
|
this._routes.push({ url, handler });
|
|
|
|
if (this._routes.length === 1)
|
|
|
|
await this._channel.setNetworkInterceptionEnabled({ enabled: true });
|
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async unroute(url: URLMatch, handler?: RouteHandler): Promise<void> {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.unroute', async () => {
|
|
|
|
this._routes = this._routes.filter(route => route.url !== url || (handler && route.handler !== handler));
|
|
|
|
if (this._routes.length === 0)
|
|
|
|
await this._channel.setNetworkInterceptionEnabled({ enabled: false });
|
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-08-08 01:41:34 +03:00
|
|
|
async screenshot(options: PageScreenshotOptions & { path?: string } = {}): Promise<Buffer> {
|
2020-07-16 00:04:39 +03:00
|
|
|
return this._wrapApiCall('page.screenshot', async () => {
|
2020-08-08 01:41:34 +03:00
|
|
|
const buffer = Buffer.from((await this._channel.screenshot(options)).binary, 'base64');
|
|
|
|
if (options.path)
|
|
|
|
await fsWriteFileAsync(options.path, buffer);
|
|
|
|
return buffer;
|
2020-07-16 00:04:39 +03:00
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async title(): Promise<string> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.title());
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-21 19:36:54 +03:00
|
|
|
async bringToFront(): Promise<void> {
|
|
|
|
return this._wrapApiCall('page.bringToFront', async () => {
|
|
|
|
await this._channel.bringToFront();
|
|
|
|
});
|
|
|
|
}
|
|
|
|
|
2020-06-26 02:05:36 +03:00
|
|
|
async close(options: { runBeforeUnload?: boolean } = {runBeforeUnload: undefined}) {
|
2020-07-17 00:32:21 +03:00
|
|
|
return this._wrapApiCall('page.close', async () => {
|
|
|
|
await this._channel.close(options);
|
|
|
|
if (this._ownedContext)
|
|
|
|
await this._ownedContext.close();
|
|
|
|
});
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
isClosed(): boolean {
|
|
|
|
return this._closed;
|
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async click(selector: string, options?: FrameClickOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.click(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async dblclick(selector: string, options?: FrameDblclickOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.dblclick(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async fill(selector: string, value: string, options?: FrameFillOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.fill(selector, value, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async focus(selector: string, options?: FrameFocusOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.focus(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async textContent(selector: string, options?: FrameTextContentOptions): Promise<null|string> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.textContent(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async innerText(selector: string, options?: FrameInnerTextOptions): Promise<string> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.innerText(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async innerHTML(selector: string, options?: FrameInnerHTMLOptions): Promise<string> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.innerHTML(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async getAttribute(selector: string, name: string, options?: FrameGetAttributeOptions): Promise<string | null> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.getAttribute(selector, name, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async hover(selector: string, options?: FrameHoverOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.hover(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async selectOption(selector: string, values: string | ElementHandle | SelectOption | string[] | ElementHandle[] | SelectOption[] | null, options?: SelectOptionOptions): Promise<string[]> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.selectOption(selector, values, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async setInputFiles(selector: string, files: string | FilePayload | string[] | FilePayload[], options?: FrameSetInputFilesOptions): Promise<void> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.setInputFiles(selector, files, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async type(selector: string, text: string, options?: FrameTypeOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.type(selector, text, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async press(selector: string, key: string, options?: FramePressOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.press(selector, key, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async check(selector: string, options?: FrameCheckOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.check(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async uncheck(selector: string, options?: FrameUncheckOptions) {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.uncheck(selector, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async waitForTimeout(timeout: number) {
|
2020-06-30 04:58:09 +03:00
|
|
|
await this._mainFrame.waitForTimeout(timeout);
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async waitForFunction<R, Arg>(pageFunction: Func1<Arg, R>, arg: Arg, options?: WaitForFunctionOptions): Promise<SmartHandle<R>>;
|
|
|
|
async waitForFunction<R>(pageFunction: Func1<void, R>, arg?: any, options?: WaitForFunctionOptions): Promise<SmartHandle<R>>;
|
|
|
|
async waitForFunction<R, Arg>(pageFunction: Func1<Arg, R>, arg: Arg, options?: WaitForFunctionOptions): Promise<SmartHandle<R>> {
|
2020-06-30 04:58:09 +03:00
|
|
|
return this._attributeToPage(() => this._mainFrame.waitForFunction(pageFunction, arg, options));
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
workers(): Worker[] {
|
2020-06-30 20:55:11 +03:00
|
|
|
return [...this._workers];
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
on(event: string | symbol, listener: Listener): this {
|
|
|
|
if (event === Events.Page.FileChooser) {
|
|
|
|
if (!this.listenerCount(event))
|
|
|
|
this._channel.setFileChooserInterceptedNoReply({ intercepted: true });
|
|
|
|
}
|
|
|
|
super.on(event, listener);
|
|
|
|
return this;
|
2020-08-15 04:24:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
addListener(event: string | symbol, listener: Listener): this {
|
|
|
|
if (event === Events.Page.FileChooser) {
|
|
|
|
if (!this.listenerCount(event))
|
|
|
|
this._channel.setFileChooserInterceptedNoReply({ intercepted: true });
|
|
|
|
}
|
|
|
|
super.addListener(event, listener);
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
|
|
|
off(event: string | symbol, listener: Listener): this {
|
|
|
|
super.off(event, listener);
|
|
|
|
if (event === Events.Page.FileChooser && !this.listenerCount(event))
|
|
|
|
this._channel.setFileChooserInterceptedNoReply({ intercepted: false });
|
|
|
|
return this;
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
removeListener(event: string | symbol, listener: Listener): this {
|
|
|
|
super.removeListener(event, listener);
|
|
|
|
if (event === Events.Page.FileChooser && !this.listenerCount(event))
|
|
|
|
this._channel.setFileChooserInterceptedNoReply({ intercepted: false });
|
|
|
|
return this;
|
|
|
|
}
|
|
|
|
|
2020-07-30 03:26:59 +03:00
|
|
|
async _pdf(options: PDFOptions = {}): Promise<Buffer> {
|
2020-07-21 03:38:06 +03:00
|
|
|
const transportOptions: PagePdfParams = { ...options } as PagePdfParams;
|
2020-07-11 01:39:11 +03:00
|
|
|
if (transportOptions.margin)
|
|
|
|
transportOptions.margin = { ...transportOptions.margin };
|
|
|
|
if (typeof options.width === 'number')
|
|
|
|
transportOptions.width = options.width + 'px';
|
|
|
|
if (typeof options.height === 'number')
|
|
|
|
transportOptions.height = options.height + 'px';
|
|
|
|
for (const margin of ['top', 'right', 'bottom', 'left']) {
|
|
|
|
const index = margin as 'top' | 'right' | 'bottom' | 'left';
|
|
|
|
if (options.margin && typeof options.margin[index] === 'number')
|
|
|
|
transportOptions.margin![index] = transportOptions.margin![index] + 'px';
|
|
|
|
}
|
2020-07-15 04:26:50 +03:00
|
|
|
const result = await this._channel.pdf(transportOptions);
|
|
|
|
const buffer = Buffer.from(result.pdf, 'base64');
|
2020-08-08 01:41:34 +03:00
|
|
|
if (options.path)
|
|
|
|
await fsWriteFileAsync(options.path, buffer);
|
2020-07-14 20:51:37 +03:00
|
|
|
return buffer;
|
2020-06-26 02:05:36 +03:00
|
|
|
}
|
|
|
|
}
|
2020-06-26 21:51:47 +03:00
|
|
|
|
2020-06-26 22:28:27 +03:00
|
|
|
export class BindingCall extends ChannelOwner<BindingCallChannel, BindingCallInitializer> {
|
2020-06-26 21:51:47 +03:00
|
|
|
static from(channel: BindingCallChannel): BindingCall {
|
2020-07-02 04:36:09 +03:00
|
|
|
return (channel as any)._object;
|
2020-06-26 21:51:47 +03:00
|
|
|
}
|
|
|
|
|
2020-07-11 04:00:10 +03:00
|
|
|
constructor(parent: ChannelOwner, type: string, guid: string, initializer: BindingCallInitializer) {
|
|
|
|
super(parent, type, guid, initializer);
|
2020-06-26 21:51:47 +03:00
|
|
|
}
|
|
|
|
|
|
|
|
async call(func: FunctionWithSource) {
|
|
|
|
try {
|
2020-06-26 22:28:27 +03:00
|
|
|
const frame = Frame.from(this._initializer.frame);
|
|
|
|
const source = {
|
2020-06-27 07:22:03 +03:00
|
|
|
context: frame._page!.context(),
|
2020-06-26 22:28:27 +03:00
|
|
|
page: frame._page!,
|
|
|
|
frame
|
|
|
|
};
|
2020-07-20 05:46:19 +03:00
|
|
|
const result = await func(source, ...this._initializer.args.map(parseResult));
|
2020-07-16 06:05:11 +03:00
|
|
|
this._channel.resolve({ result: serializeArgument(result) });
|
2020-06-26 21:51:47 +03:00
|
|
|
} catch (e) {
|
|
|
|
this._channel.reject({ error: serializeError(e) });
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|