/** * 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 types from '../../types'; import { BrowserChannel, BrowserInitializer } from '../channels'; import { BrowserContext } from './browserContext'; import { Page } from './page'; import { ChannelOwner } from './channelOwner'; import { ConnectionScope } from './connection'; import { Events } from '../../events'; import { CDPSession } from './cdpSession'; export class Browser extends ChannelOwner { readonly _contexts = new Set(); private _isConnected = true; private _isClosedOrClosing = false; private _closedPromise: Promise; static from(browser: BrowserChannel): Browser { return (browser as any)._object; } static fromNullable(browser: BrowserChannel | null): Browser | null { return browser ? Browser.from(browser) : null; } constructor(scope: ConnectionScope, guid: string, initializer: BrowserInitializer) { super(scope, guid, initializer, true); this._channel.on('close', () => { this._isConnected = false; this.emit(Events.Browser.Disconnected); this._isClosedOrClosing = true; this._scope.dispose(); }); this._closedPromise = new Promise(f => this.once(Events.Browser.Disconnected, f)); } async newContext(options: types.BrowserContextOptions = {}): Promise { delete (options as any).logger; const context = BrowserContext.from(await this._channel.newContext(options)); this._contexts.add(context); context._browser = this; return context; } contexts(): BrowserContext[] { return [...this._contexts]; } async newPage(options: types.BrowserContextOptions = {}): Promise { delete (options as any).logger; const context = await this.newContext(options); const page = await context.newPage(); page._ownedContext = context; context._ownerPage = page; return page; } isConnected(): boolean { return this._isConnected; } async close(): Promise { if (!this._isClosedOrClosing) { this._isClosedOrClosing = true; await this._channel.close(); } await this._closedPromise; } async newBrowserCDPSession(): Promise { return CDPSession.from(await this._channel.crNewBrowserCDPSession()); } async startTracing(page?: Page, options: { path?: string; screenshots?: boolean; categories?: string[]; } = {}) { await this._channel.crStartTracing({ ...options, page: page ? page._channel : undefined }); } async stopTracing(): Promise { return Buffer.from(await this._channel.crStopTracing(), 'base64'); } }