/** * 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 { assert } from './helper'; import { Page } from './page'; import * as input from './input'; import * as network from './network'; import * as types from './types'; export interface BrowserDelegate { contextPages(): Promise; createPageInContext(): Promise; closeContext(): Promise; getContextCookies(): Promise; clearContextCookies(): Promise; setContextCookies(cookies: network.SetNetworkCookieParam[]): Promise; } export type BrowserContextOptions = { viewport?: types.Viewport | null, ignoreHTTPSErrors?: boolean, javaScriptEnabled?: boolean, bypassCSP?: boolean, mediaType?: input.MediaType, colorScheme?: input.ColorScheme, userAgent?: string, timezoneId?: string }; export class BrowserContext { private readonly _delegate: BrowserDelegate; private readonly _isIncognito: boolean; readonly _options: BrowserContextOptions; private _closed = false; constructor(delegate: BrowserDelegate, isIncognito: boolean, options: BrowserContextOptions) { this._delegate = delegate; this._isIncognito = isIncognito; this._options = options; if (!options.viewport && options.viewport !== null) options.viewport = { width: 800, height: 600 }; } async pages(): Promise { return this._delegate.contextPages(); } isIncognito(): boolean { return this._isIncognito; } async newPage(): Promise { return this._delegate.createPageInContext(); } async _createOwnerPage(): Promise { try { const page = await this._delegate.createPageInContext(); page._isContextOwner = true; return page; } catch (e) { await this.close(); throw e; } } async cookies(...urls: string[]): Promise { return network.filterCookies(await this._delegate.getContextCookies(), urls); } async clearCookies() { await this._delegate.clearContextCookies(); } async setCookies(cookies: network.SetNetworkCookieParam[]) { await this._delegate.setContextCookies(network.rewriteCookies(cookies)); } async close() { if (this._closed) return; assert(this._isIncognito, 'Non-incognito profiles cannot be closed!'); await this._delegate.closeContext(); this._closed = true; } }