/** * 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. */ import { EventEmitter } from 'events'; import * as types from '../types'; export type Binary = string; export interface Channel extends EventEmitter { } export interface PlaywrightChannel extends Channel { } export type PlaywrightInitializer = { chromium: BrowserTypeChannel, firefox: BrowserTypeChannel, webkit: BrowserTypeChannel, deviceDescriptors: types.Devices, }; export interface BrowserTypeChannel extends Channel { connect(params: types.ConnectOptions): Promise; launch(params: types.LaunchOptions): Promise; launchServer(params: types.LaunchServerOptions): Promise; launchPersistentContext(params: { userDataDir: string } & types.LaunchOptions & types.BrowserContextOptions): Promise; } export type BrowserTypeInitializer = { executablePath: string, name: string }; export interface BrowserServerChannel extends Channel { on(event: 'close', callback: () => void): this; close(): Promise; kill(): Promise; } export type BrowserServerInitializer = { wsEndpoint: string, pid: number }; export interface BrowserChannel extends Channel { on(event: 'close', callback: () => void): this; close(): Promise; newContext(params: types.BrowserContextOptions): Promise; crNewBrowserCDPSession(): Promise; crStartTracing(params: { page?: PageChannel, path?: string, screenshots?: boolean, categories?: string[] }): Promise; crStopTracing(): Promise; } export type BrowserInitializer = {}; export interface BrowserContextChannel extends Channel { on(event: 'bindingCall', callback: (params: BindingCallChannel) => void): this; on(event: 'close', callback: () => void): this; on(event: 'page', callback: (params: PageChannel) => void): this; on(event: 'route', callback: (params: { route: RouteChannel, request: RequestChannel }) => void): this; addCookies(params: { cookies: types.SetNetworkCookieParam[] }): Promise; addInitScript(params: { source: string }): Promise; clearCookies(): Promise; clearPermissions(): Promise; close(): Promise; cookies(params: { urls: string[] }): Promise; exposeBinding(params: { name: string }): Promise; grantPermissions(params: { permissions: string[], origin?: string }): Promise; newPage(): Promise; setDefaultNavigationTimeoutNoReply(params: { timeout: number }): void; setDefaultTimeoutNoReply(params: { timeout: number }): void; setExtraHTTPHeaders(params: { headers: types.Headers }): Promise; setGeolocation(params: { geolocation: types.Geolocation | null }): Promise; setHTTPCredentials(params: { httpCredentials: types.Credentials | null }): Promise; setNetworkInterceptionEnabled(params: { enabled: boolean }): Promise; setOffline(params: { offline: boolean }): Promise; on(event: 'crBackgroundPage', callback: (params: PageChannel) => void): this; on(event: 'crServiceWorker', callback: (params: WorkerChannel) => void): this; crNewCDPSession(params: { page: PageChannel }): Promise; } export type BrowserContextInitializer = {}; export interface PageChannel extends Channel { on(event: 'bindingCall', callback: (params: BindingCallChannel) => void): this; on(event: 'close', callback: () => void): this; on(event: 'console', callback: (params: ConsoleMessageChannel) => void): this; on(event: 'crash', callback: () => void): this; on(event: 'dialog', callback: (params: DialogChannel) => void): this; on(event: 'download', callback: (params: DownloadChannel) => void): this; on(event: 'domcontentloaded', callback: () => void): this; on(event: 'fileChooser', callback: (params: { element: ElementHandleChannel, isMultiple: boolean }) => void): this; on(event: 'frameAttached', callback: (params: FrameChannel) => void): this; on(event: 'frameDetached', callback: (params: FrameChannel) => void): this; on(event: 'frameNavigated', callback: (params: { frame: FrameChannel, url: string, name: string }) => void): this; on(event: 'load', callback: () => void): this; on(event: 'pageError', callback: (params: { error: types.Error }) => void): this; on(event: 'popup', callback: (params: PageChannel) => void): this; on(event: 'request', callback: (params: RequestChannel) => void): this; on(event: 'requestFailed', callback: (params: { request: RequestChannel, failureText: string | null }) => void): this; on(event: 'requestFinished', callback: (params: RequestChannel) => void): this; on(event: 'response', callback: (params: ResponseChannel) => void): this; on(event: 'route', callback: (params: { route: RouteChannel, request: RequestChannel }) => void): this; on(event: 'worker', callback: (params: WorkerChannel) => void): this; setDefaultNavigationTimeoutNoReply(params: { timeout: number }): void; setDefaultTimeoutNoReply(params: { timeout: number }): Promise; setFileChooserInterceptedNoReply(params: { intercepted: boolean }): Promise; addInitScript(params: { source: string }): Promise; close(params: { runBeforeUnload?: boolean }): Promise; emulateMedia(params: { media?: 'screen' | 'print', colorScheme?: 'dark' | 'light' | 'no-preference' }): Promise; exposeBinding(params: { name: string }): Promise; goBack(params: types.NavigateOptions): Promise; goForward(params: types.NavigateOptions): Promise; opener(): Promise; reload(params: types.NavigateOptions): Promise; screenshot(params: types.ScreenshotOptions): Promise; setExtraHTTPHeaders(params: { headers: types.Headers }): Promise; setNetworkInterceptionEnabled(params: { enabled: boolean }): Promise; setViewportSize(params: { viewportSize: types.Size }): Promise; // Input keyboardDown(params: { key: string }): Promise; keyboardUp(params: { key: string }): Promise; keyboardInsertText(params: { text: string }): Promise; keyboardType(params: { text: string, delay?: number }): Promise; keyboardPress(params: { key: string, delay?: number }): Promise; mouseMove(params: { x: number, y: number, steps?: number }): Promise; mouseDown(params: { button?: types.MouseButton, clickCount?: number }): Promise; mouseUp(params: { button?: types.MouseButton, clickCount?: number }): Promise; mouseClick(params: { x: number, y: number, delay?: number, button?: types.MouseButton, clickCount?: number }): Promise; accessibilitySnapshot(params: { interestingOnly?: boolean, root?: ElementHandleChannel }): Promise; pdf: (params: PDFOptions) => Promise; crStartJSCoverage(params: types.JSCoverageOptions): Promise; crStopJSCoverage(): Promise; crStartCSSCoverage(params: types.CSSCoverageOptions): Promise; crStopCSSCoverage(): Promise; } export type PageInitializer = { mainFrame: FrameChannel, viewportSize: types.Size | null, isClosed: boolean }; export type PageAttribution = { isPage?: boolean }; export interface FrameChannel extends Channel { on(event: 'loadstate', callback: (params: { add?: types.LifecycleEvent, remove?: types.LifecycleEvent }) => void): this; evalOnSelector(params: { selector: string; expression: string, isFunction: boolean, arg: any} & PageAttribution): Promise; evalOnSelectorAll(params: { selector: string; expression: string, isFunction: boolean, arg: any} & PageAttribution): Promise; addScriptTag(params: { url?: string | undefined, path?: string | undefined, content?: string | undefined, type?: string | undefined} & PageAttribution): Promise; addStyleTag(params: { url?: string | undefined, path?: string | undefined, content?: string | undefined} & PageAttribution): Promise; check(params: { selector: string, force?: boolean, noWaitAfter?: boolean } & types.TimeoutOptions & PageAttribution): Promise; click(params: { selector: string, force?: boolean, noWaitAfter?: boolean } & types.PointerActionOptions & types.MouseClickOptions & types.TimeoutOptions & PageAttribution): Promise; content(): Promise; dblclick(params: { selector: string, force?: boolean } & types.PointerActionOptions & types.MouseMultiClickOptions & types.TimeoutOptions & PageAttribution): Promise; dispatchEvent(params: { selector: string, type: string, eventInit: any } & types.TimeoutOptions & PageAttribution): Promise; evaluateExpression(params: { expression: string, isFunction: boolean, arg: any} & PageAttribution): Promise; evaluateExpressionHandle(params: { expression: string, isFunction: boolean, arg: any} & PageAttribution): Promise; fill(params: { selector: string, value: string } & types.NavigatingActionWaitOptions & PageAttribution): Promise; focus(params: { selector: string } & types.TimeoutOptions & PageAttribution): Promise; frameElement(): Promise; getAttribute(params: { selector: string, name: string } & types.TimeoutOptions & PageAttribution): Promise; goto(params: { url: string } & types.GotoOptions & PageAttribution): Promise; hover(params: { selector: string, force?: boolean } & types.PointerActionOptions & types.TimeoutOptions & PageAttribution): Promise; innerHTML(params: { selector: string } & types.TimeoutOptions & PageAttribution): Promise; innerText(params: { selector: string } & types.TimeoutOptions & PageAttribution): Promise; press(params: { selector: string, key: string, delay?: number, noWaitAfter?: boolean } & types.TimeoutOptions & PageAttribution): Promise; querySelector(params: { selector: string} & PageAttribution): Promise; querySelectorAll(params: { selector: string} & PageAttribution): Promise; selectOption(params: { selector: string, elements?: ElementHandleChannel[], options?: types.SelectOption[] } & types.NavigatingActionWaitOptions & PageAttribution): Promise; setContent(params: { html: string } & types.NavigateOptions & PageAttribution): Promise; setInputFiles(params: { selector: string, files: { name: string, mimeType: string, buffer: Binary }[] } & types.NavigatingActionWaitOptions & PageAttribution): Promise; textContent(params: { selector: string } & types.TimeoutOptions & PageAttribution): Promise; title(): Promise; type(params: { selector: string, text: string, delay?: number, noWaitAfter?: boolean } & types.TimeoutOptions & PageAttribution): Promise; uncheck(params: { selector: string, force?: boolean, noWaitAfter?: boolean } & types.TimeoutOptions & PageAttribution): Promise; waitForFunction(params: { expression: string, isFunction: boolean, arg: any } & types.WaitForFunctionOptions & PageAttribution): Promise; waitForNavigation(params: types.WaitForNavigationOptions & PageAttribution): Promise; waitForSelector(params: { selector: string } & types.WaitForElementOptions & PageAttribution): Promise; } export type FrameInitializer = { url: string, name: string, parentFrame: FrameChannel | null, loadStates: types.LifecycleEvent[], }; export interface WorkerChannel extends Channel { evaluateExpression(params: { expression: string, isFunction: boolean, arg: any }): Promise; evaluateExpressionHandle(params: { expression: string, isFunction: boolean, arg: any }): Promise; } export type WorkerInitializer = { url: string, }; export interface JSHandleChannel extends Channel { on(event: 'previewUpdated', callback: (preview: string) => void): this; dispose(): Promise; evaluateExpression(params: { expression: string, isFunction: boolean, arg: any }): Promise; evaluateExpressionHandle(params: { expression: string, isFunction: boolean, arg: any}): Promise; getPropertyList(): Promise<{ name: string, value: JSHandleChannel}[]>; getProperty(params: { name: string }): Promise; jsonValue(): Promise; } export type JSHandleInitializer = { preview: string, }; export interface ElementHandleChannel extends JSHandleChannel { evalOnSelector(params: { selector: string; expression: string, isFunction: boolean, arg: any }): Promise; evalOnSelectorAll(params: { selector: string; expression: string, isFunction: boolean, arg: any }): Promise; boundingBox(): Promise; check(params: { force?: boolean } & { noWaitAfter?: boolean } & types.TimeoutOptions): Promise; click(params: { force?: boolean, noWaitAfter?: boolean } & types.PointerActionOptions & types.MouseClickOptions & types.TimeoutOptions): Promise; contentFrame(): Promise; dblclick(params: { force?: boolean, noWaitAfter?: boolean } & types.PointerActionOptions & types.MouseMultiClickOptions & types.TimeoutOptions): Promise; dispatchEvent(params: { type: string, eventInit: any }): Promise; fill(params: { value: string } & types.NavigatingActionWaitOptions): Promise; focus(): Promise; getAttribute(params: { name: string }): Promise; hover(params: { force?: boolean } & types.PointerActionOptions & types.TimeoutOptions): Promise; innerHTML(): Promise; innerText(): Promise; ownerFrame(): Promise; press(params: { key: string, delay?: number } & types.TimeoutOptions & { noWaitAfter?: boolean }): Promise; querySelector(params: { selector: string }): Promise; querySelectorAll(params: { selector: string }): Promise; screenshot(params: types.ElementScreenshotOptions): Promise; scrollIntoViewIfNeeded(params: types.TimeoutOptions): Promise; selectOption(params: { elements?: ElementHandleChannel[], options?: types.SelectOption[] } & types.NavigatingActionWaitOptions): string[] | Promise; selectText(params: types.TimeoutOptions): Promise; setInputFiles(params: { files: { name: string, mimeType: string, buffer: Binary }[] } & types.NavigatingActionWaitOptions): Promise; textContent(): Promise; type(params: { text: string, delay?: number, noWaitAfter?: boolean } & types.TimeoutOptions): Promise; uncheck(params: { force?: boolean, noWaitAfter?: boolean } & types.TimeoutOptions): Promise; } export interface RequestChannel extends Channel { response(): Promise; } export type RequestInitializer = { frame: FrameChannel, url: string, resourceType: string, method: string, postData: string | null, headers: types.Headers, isNavigationRequest: boolean, redirectedFrom: RequestChannel | null, }; export interface RouteChannel extends Channel { abort(params: { errorCode: string }): Promise; continue(params: { method?: string, headers?: types.Headers, postData?: string }): Promise; fulfill(params: { status?: number, headers?: types.Headers, body: string, isBase64: boolean, }): Promise; } export type RouteInitializer = { request: RequestChannel, }; export interface ResponseChannel extends Channel { body(): Promise; finished(): Promise; } export type ResponseInitializer = { request: RequestChannel, url: string, status: number, statusText: string, headers: types.Headers, }; export interface ConsoleMessageChannel extends Channel { } export type ConsoleMessageInitializer = { type: string, text: string, args: JSHandleChannel[], location: types.ConsoleMessageLocation, }; export interface BindingCallChannel extends Channel { reject(params: { error: types.Error }): void; resolve(params: { result: any }): void; } export type BindingCallInitializer = { frame: FrameChannel, name: string, args: any[] }; export interface DialogChannel extends Channel { accept(params: { promptText?: string }): Promise; dismiss(): Promise; } export type DialogInitializer = { type: string, message: string, defaultValue: string, }; export interface DownloadChannel extends Channel { path(): Promise; failure(): Promise; delete(): Promise; } export type DownloadInitializer = { url: string, suggestedFilename: string, }; // Chromium-specific. export interface CDPSessionChannel extends Channel { on(event: 'event', callback: (params: { method: string, params?: Object }) => void): this; on(event: 'disconnected', callback: () => void): this; send(params: { method: string, params?: Object }): Promise; detach(): Promise; } export type CDPSessionInitializer = {}; export type PDFOptions = { scale?: number, displayHeaderFooter?: boolean, headerTemplate?: string, footerTemplate?: string, printBackground?: boolean, landscape?: boolean, pageRanges?: string, format?: string, width?: string, height?: string, preferCSSPageSize?: boolean, margin?: {top?: string, bottom?: string, left?: string, right?: string}, path?: string, }