/** * 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. */ import * as childProcess from 'child_process'; import { EventEmitter } from 'events'; import { helper, RegisteredListener, debugError } from '../helper'; import * as network from '../network'; import { Connection, ConnectionEvents, TargetSession } from './Connection'; import { Page } from '../page'; import { Target } from './Target'; import { Protocol } from './protocol'; import * as types from '../types'; import { Events } from '../events'; import { BrowserContext, BrowserInterface } from '../browserContext'; export class Browser extends EventEmitter implements BrowserInterface { readonly _defaultViewport: types.Viewport; private readonly _process: childProcess.ChildProcess; readonly _connection: Connection; private _closeCallback: () => Promise; private readonly _defaultContext: BrowserContext; private _contexts = new Map(); _targets = new Map(); private _eventListeners: RegisteredListener[]; private _privateEvents = new EventEmitter(); private readonly _ignoreHTTPSErrors: boolean; constructor( connection: Connection, ignoreHTTPSErrors: boolean, defaultViewport: types.Viewport | null, process: childProcess.ChildProcess | null, closeCallback?: (() => Promise)) { super(); this._connection = connection; this._ignoreHTTPSErrors = ignoreHTTPSErrors; this._defaultViewport = defaultViewport; this._process = process; this._closeCallback = closeCallback || (() => Promise.resolve()); /** @type {!Map} */ this._targets = new Map(); this._defaultContext = this._createBrowserContext(undefined); /** @type {!Map} */ this._contexts = new Map(); this._eventListeners = [ helper.addEventListener(this._connection, ConnectionEvents.TargetCreated, this._onTargetCreated.bind(this)), helper.addEventListener(this._connection, ConnectionEvents.TargetDestroyed, this._onTargetDestroyed.bind(this)), helper.addEventListener(this._connection, ConnectionEvents.DidCommitProvisionalTarget, this._onProvisionalTargetCommitted.bind(this)), ]; // Intercept provisional targets during cross-process navigation. this._connection.send('Target.setPauseOnStart', { pauseOnStart: true }).catch(e => { debugError(e); throw e; }); if (this._ignoreHTTPSErrors) this._setIgnoreTLSFailures(undefined); } async userAgent(): Promise { const context = await this.newContext(); const page = await context.newPage(); const userAgent = await page.evaluate(() => navigator.userAgent); context.close(); return userAgent; } async version(): Promise { const userAgent = await this.userAgent(); return userAgent.split(' ').pop(); } process(): childProcess.ChildProcess | null { return this._process; } async newContext(): Promise { const {browserContextId} = await this._connection.send('Browser.createContext'); if (this._ignoreHTTPSErrors) await this._setIgnoreTLSFailures(browserContextId); const context = this._createBrowserContext(browserContextId); this._contexts.set(browserContextId, context); return context; } browserContexts(): BrowserContext[] { return [this._defaultContext, ...Array.from(this._contexts.values())]; } defaultBrowserContext(): BrowserContext { return this._defaultContext; } async _disposeContext(browserContextId: string | null) { } async newPage(): Promise { return this._defaultContext.newPage(); } targets(): Target[] { return Array.from(this._targets.values()); } async _waitForTarget(predicate: (arg0: Target) => boolean, options: { timeout?: number; } | undefined = {}): Promise { const { timeout = 30000 } = options; const existingTarget = this.targets().find(predicate); if (existingTarget) return existingTarget; let resolve : (a: Target) => void; const targetPromise = new Promise(x => resolve = x); this._privateEvents.on(BrowserEvents.TargetCreated, check); try { if (!timeout) return await targetPromise; return await helper.waitWithTimeout(targetPromise, 'target', timeout); } finally { this._privateEvents.removeListener(BrowserEvents.TargetCreated, check); } function check(target: Target) { if (predicate(target)) resolve(target); } } async pages(): Promise { const contextPages = await Promise.all(this.browserContexts().map(context => context.pages())); // Flatten array. return contextPages.reduce((acc, x) => acc.concat(x), []); } _onTargetCreated(session: TargetSession, targetInfo: Protocol.Target.TargetInfo) { let context = null; if (targetInfo.browserContextId) { // FIXME: we don't know about the default context id, so assume that all targets from // unknown contexts are created in the 'default' context which can in practice be represented // by multiple actual contexts in WebKit. Solving this properly will require adding context // lifecycle events. context = this._contexts.get(targetInfo.browserContextId); // if (!context) // throw new Error(`Target ${targetId} created in unknown browser context ${browserContextId}.`); } if (!context) context = this._defaultContext; const target = new Target(session, targetInfo, context); this._targets.set(targetInfo.targetId, target); if (targetInfo.isProvisional) { const oldTarget = this._targets.get(targetInfo.oldTargetId); if (oldTarget) oldTarget._initializeSession(session); } this._privateEvents.emit(BrowserEvents.TargetCreated, target); if (!targetInfo.oldTargetId && targetInfo.openerId) { const opener = this._targets.get(targetInfo.openerId); if (!opener) return; const openerPage = opener._frameManager ? opener._frameManager._page : null; if (!openerPage || !openerPage.listenerCount(Events.Page.Popup)) return; target.page().then(page => openerPage.emit(Events.Page.Popup, page)); } if (targetInfo.isPaused) this._connection.send('Target.resume', { targetId: targetInfo.targetId }).catch(debugError); } _onTargetDestroyed({targetId}) { const target = this._targets.get(targetId); this._targets.delete(targetId); target._didClose(); } _closePage(page: Page, runBeforeUnload: boolean) { this._connection.send('Target.close', { targetId: Target.fromPage(page)._targetId, runBeforeUnload }).catch(debugError); } async _activatePage(page: Page): Promise { await this._connection.send('Target.activate', { targetId: Target.fromPage(page)._targetId }); } async _onProvisionalTargetCommitted({oldTargetId, newTargetId}) { const oldTarget = this._targets.get(oldTargetId); const newTarget = this._targets.get(newTargetId); newTarget._swapWith(oldTarget); } disconnect() { throw new Error('Unsupported operation'); } isConnected(): boolean { return true; } async close() { helper.removeEventListeners(this._eventListeners); await this._closeCallback.call(null); } _createBrowserContext(browserContextId: string | undefined): BrowserContext { const isIncognito = !!browserContextId; const context = new BrowserContext({ contextPages: async (): Promise => { const targets = this.targets().filter(target => target._browserContext === context && target._type === 'page'); const pages = await Promise.all(targets.map(target => target.page())); return pages.filter(page => !!page); }, createPageInContext: async (): Promise => { const { targetId } = await this._connection.send('Browser.createPage', { browserContextId }); const target = this._targets.get(targetId); return await target.page(); }, closeContext: async (): Promise => { await this._connection.send('Browser.deleteContext', { browserContextId }); this._contexts.delete(browserContextId); }, getContextCookies: async (): Promise => { const { cookies } = await this._connection.send('Browser.getAllCookies', { browserContextId }); return cookies.map((c: network.NetworkCookie) => ({ ...c, expires: c.expires === 0 ? -1 : c.expires })); }, clearContextCookies: async (): Promise => { await this._connection.send('Browser.deleteAllCookies', { browserContextId }); }, setContextCookies: async (cookies: network.SetNetworkCookieParam[]): Promise => { const cc = cookies.map(c => ({ ...c, session: c.expires === -1 || c.expires === undefined })) as Protocol.Browser.SetCookieParam[]; await this._connection.send('Browser.setCookies', { cookies: cc, browserContextId }); }, }, this, isIncognito); return context; } async _setIgnoreTLSFailures(browserContextId: string | undefined) { await this._connection.send('Browser.setIgnoreCertificateErrors', { browserContextId, ignore: true }); } } const BrowserEvents = { TargetCreated: Symbol('BrowserEvents.TargetCreated'), TargetDestroyed: Symbol('BrowserEvents.TargetDestroyed'), };