/** * Copyright 2019 Google Inc. All rights reserved. * * 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 {Page, PageEmittedEvents} from './Page.js'; import {WebWorker} from './WebWorker.js'; import {CDPSession} from './Connection.js'; import type { Browser, BrowserContext, IsPageTargetCallback, } from '../api/Browser.js'; import {Viewport} from './PuppeteerViewport.js'; import {Protocol} from 'devtools-protocol'; import {TaskQueue} from './TaskQueue.js'; import {TargetManager} from './TargetManager.js'; /** * @public */ export class Target { #browserContext: BrowserContext; #session?: CDPSession; #targetInfo: Protocol.Target.TargetInfo; #sessionFactory: (isAutoAttachEmulated: boolean) => Promise; #ignoreHTTPSErrors: boolean; #defaultViewport?: Viewport; #pagePromise?: Promise; #workerPromise?: Promise; #screenshotTaskQueue: TaskQueue; /** * @internal */ _initializedPromise: Promise; /** * @internal */ _initializedCallback!: (x: boolean) => void; /** * @internal */ _isClosedPromise: Promise; /** * @internal */ _closedCallback!: () => void; /** * @internal */ _isInitialized: boolean; /** * @internal */ _targetId: string; /** * @internal */ _isPageTargetCallback: IsPageTargetCallback; #targetManager: TargetManager; /** * @internal */ constructor( targetInfo: Protocol.Target.TargetInfo, session: CDPSession | undefined, browserContext: BrowserContext, targetManager: TargetManager, sessionFactory: (isAutoAttachEmulated: boolean) => Promise, ignoreHTTPSErrors: boolean, defaultViewport: Viewport | null, screenshotTaskQueue: TaskQueue, isPageTargetCallback: IsPageTargetCallback ) { this.#session = session; this.#targetManager = targetManager; this.#targetInfo = targetInfo; this.#browserContext = browserContext; this._targetId = targetInfo.targetId; this.#sessionFactory = sessionFactory; this.#ignoreHTTPSErrors = ignoreHTTPSErrors; this.#defaultViewport = defaultViewport ?? undefined; this.#screenshotTaskQueue = screenshotTaskQueue; this._isPageTargetCallback = isPageTargetCallback; this._initializedPromise = new Promise(fulfill => { return (this._initializedCallback = fulfill); }).then(async success => { if (!success) { return false; } const opener = this.opener(); if (!opener || !opener.#pagePromise || this.type() !== 'page') { return true; } const openerPage = await opener.#pagePromise; if (!openerPage.listenerCount(PageEmittedEvents.Popup)) { return true; } const popupPage = await this.page(); openerPage.emit(PageEmittedEvents.Popup, popupPage); return true; }); this._isClosedPromise = new Promise(fulfill => { return (this._closedCallback = fulfill); }); this._isInitialized = !this._isPageTargetCallback(this.#targetInfo) || this.#targetInfo.url !== ''; if (this._isInitialized) { this._initializedCallback(true); } } /** * @internal */ _session(): CDPSession | undefined { return this.#session; } /** * Creates a Chrome Devtools Protocol session attached to the target. */ createCDPSession(): Promise { return this.#sessionFactory(false); } /** * @internal */ _targetManager(): TargetManager { return this.#targetManager; } /** * @internal */ _getTargetInfo(): Protocol.Target.TargetInfo { return this.#targetInfo; } /** * If the target is not of type `"page"` or `"background_page"`, returns `null`. */ async page(): Promise { if (this._isPageTargetCallback(this.#targetInfo) && !this.#pagePromise) { this.#pagePromise = ( this.#session ? Promise.resolve(this.#session) : this.#sessionFactory(true) ).then(client => { return Page._create( client, this, this.#ignoreHTTPSErrors, this.#defaultViewport ?? null, this.#screenshotTaskQueue ); }); } return (await this.#pagePromise) ?? null; } /** * If the target is not of type `"service_worker"` or `"shared_worker"`, returns `null`. */ async worker(): Promise { if ( this.#targetInfo.type !== 'service_worker' && this.#targetInfo.type !== 'shared_worker' ) { return null; } if (!this.#workerPromise) { // TODO(einbinder): Make workers send their console logs. this.#workerPromise = ( this.#session ? Promise.resolve(this.#session) : this.#sessionFactory(false) ).then(client => { return new WebWorker( client, this.#targetInfo.url, () => {} /* consoleAPICalled */, () => {} /* exceptionThrown */ ); }); } return this.#workerPromise; } url(): string { return this.#targetInfo.url; } /** * Identifies what kind of target this is. * * @remarks * * See {@link https://developer.chrome.com/extensions/background_pages | docs} for more info about background pages. */ type(): | 'page' | 'background_page' | 'service_worker' | 'shared_worker' | 'other' | 'browser' | 'webview' { const type = this.#targetInfo.type; if ( type === 'page' || type === 'background_page' || type === 'service_worker' || type === 'shared_worker' || type === 'browser' || type === 'webview' ) { return type; } return 'other'; } /** * Get the browser the target belongs to. */ browser(): Browser { return this.#browserContext.browser(); } /** * Get the browser context the target belongs to. */ browserContext(): BrowserContext { return this.#browserContext; } /** * Get the target that opened this target. Top-level targets return `null`. */ opener(): Target | undefined { const {openerId} = this.#targetInfo; if (!openerId) { return; } return this.browser()._targets.get(openerId); } /** * @internal */ _targetInfoChanged(targetInfo: Protocol.Target.TargetInfo): void { this.#targetInfo = targetInfo; if ( !this._isInitialized && (!this._isPageTargetCallback(this.#targetInfo) || this.#targetInfo.url !== '') ) { this._isInitialized = true; this._initializedCallback(true); return; } } }