puppeteer-core
Version:
A high-level API to control headless Chrome over the DevTools Protocol
207 lines • 10 kB
JavaScript
/**
* 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.
*/
var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
if (kind === "m") throw new TypeError("Private method is not writable");
if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
};
var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
};
var _Target_browserContext, _Target_session, _Target_targetInfo, _Target_sessionFactory, _Target_ignoreHTTPSErrors, _Target_defaultViewport, _Target_pagePromise, _Target_workerPromise, _Target_screenshotTaskQueue, _Target_targetManager;
import { WebWorker } from './WebWorker.js';
import { CDPPage } from './Page.js';
/**
* Target represents a
* {@link https://chromedevtools.github.io/devtools-protocol/tot/Target/ | CDP target}.
* In CDP a target is something that can be debugged such a frame, a page or a
* worker.
*
* @public
*/
export class Target {
/**
* @internal
*/
constructor(targetInfo, session, browserContext, targetManager, sessionFactory, ignoreHTTPSErrors, defaultViewport, screenshotTaskQueue, isPageTargetCallback) {
_Target_browserContext.set(this, void 0);
_Target_session.set(this, void 0);
_Target_targetInfo.set(this, void 0);
_Target_sessionFactory.set(this, void 0);
_Target_ignoreHTTPSErrors.set(this, void 0);
_Target_defaultViewport.set(this, void 0);
_Target_pagePromise.set(this, void 0);
_Target_workerPromise.set(this, void 0);
_Target_screenshotTaskQueue.set(this, void 0);
_Target_targetManager.set(this, void 0);
__classPrivateFieldSet(this, _Target_session, session, "f");
__classPrivateFieldSet(this, _Target_targetManager, targetManager, "f");
__classPrivateFieldSet(this, _Target_targetInfo, targetInfo, "f");
__classPrivateFieldSet(this, _Target_browserContext, browserContext, "f");
this._targetId = targetInfo.targetId;
__classPrivateFieldSet(this, _Target_sessionFactory, sessionFactory, "f");
__classPrivateFieldSet(this, _Target_ignoreHTTPSErrors, ignoreHTTPSErrors, "f");
__classPrivateFieldSet(this, _Target_defaultViewport, defaultViewport !== null && defaultViewport !== void 0 ? defaultViewport : undefined, "f");
__classPrivateFieldSet(this, _Target_screenshotTaskQueue, screenshotTaskQueue, "f");
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 || !__classPrivateFieldGet(opener, _Target_pagePromise, "f") || this.type() !== 'page') {
return true;
}
const openerPage = await __classPrivateFieldGet(opener, _Target_pagePromise, "f");
if (!openerPage.listenerCount("popup" /* PageEmittedEvents.Popup */)) {
return true;
}
const popupPage = await this.page();
openerPage.emit("popup" /* PageEmittedEvents.Popup */, popupPage);
return true;
});
this._isClosedPromise = new Promise(fulfill => {
return (this._closedCallback = fulfill);
});
this._isInitialized =
!this._isPageTargetCallback(__classPrivateFieldGet(this, _Target_targetInfo, "f")) ||
__classPrivateFieldGet(this, _Target_targetInfo, "f").url !== '';
if (this._isInitialized) {
this._initializedCallback(true);
}
}
/**
* @internal
*/
_session() {
return __classPrivateFieldGet(this, _Target_session, "f");
}
/**
* Creates a Chrome Devtools Protocol session attached to the target.
*/
createCDPSession() {
return __classPrivateFieldGet(this, _Target_sessionFactory, "f").call(this, false);
}
/**
* @internal
*/
_targetManager() {
return __classPrivateFieldGet(this, _Target_targetManager, "f");
}
/**
* @internal
*/
_getTargetInfo() {
return __classPrivateFieldGet(this, _Target_targetInfo, "f");
}
/**
* If the target is not of type `"page"` or `"background_page"`, returns `null`.
*/
async page() {
var _a;
if (this._isPageTargetCallback(__classPrivateFieldGet(this, _Target_targetInfo, "f")) && !__classPrivateFieldGet(this, _Target_pagePromise, "f")) {
__classPrivateFieldSet(this, _Target_pagePromise, (__classPrivateFieldGet(this, _Target_session, "f")
? Promise.resolve(__classPrivateFieldGet(this, _Target_session, "f"))
: __classPrivateFieldGet(this, _Target_sessionFactory, "f").call(this, true)).then(client => {
var _a;
return CDPPage._create(client, this, __classPrivateFieldGet(this, _Target_ignoreHTTPSErrors, "f"), (_a = __classPrivateFieldGet(this, _Target_defaultViewport, "f")) !== null && _a !== void 0 ? _a : null, __classPrivateFieldGet(this, _Target_screenshotTaskQueue, "f"));
}), "f");
}
return (_a = (await __classPrivateFieldGet(this, _Target_pagePromise, "f"))) !== null && _a !== void 0 ? _a : null;
}
/**
* If the target is not of type `"service_worker"` or `"shared_worker"`, returns `null`.
*/
async worker() {
if (__classPrivateFieldGet(this, _Target_targetInfo, "f").type !== 'service_worker' &&
__classPrivateFieldGet(this, _Target_targetInfo, "f").type !== 'shared_worker') {
return null;
}
if (!__classPrivateFieldGet(this, _Target_workerPromise, "f")) {
// TODO(einbinder): Make workers send their console logs.
__classPrivateFieldSet(this, _Target_workerPromise, (__classPrivateFieldGet(this, _Target_session, "f")
? Promise.resolve(__classPrivateFieldGet(this, _Target_session, "f"))
: __classPrivateFieldGet(this, _Target_sessionFactory, "f").call(this, false)).then(client => {
return new WebWorker(client, __classPrivateFieldGet(this, _Target_targetInfo, "f").url, () => { } /* consoleAPICalled */, () => { } /* exceptionThrown */);
}), "f");
}
return __classPrivateFieldGet(this, _Target_workerPromise, "f");
}
url() {
return __classPrivateFieldGet(this, _Target_targetInfo, "f").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() {
const type = __classPrivateFieldGet(this, _Target_targetInfo, "f").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() {
return __classPrivateFieldGet(this, _Target_browserContext, "f").browser();
}
/**
* Get the browser context the target belongs to.
*/
browserContext() {
return __classPrivateFieldGet(this, _Target_browserContext, "f");
}
/**
* Get the target that opened this target. Top-level targets return `null`.
*/
opener() {
const { openerId } = __classPrivateFieldGet(this, _Target_targetInfo, "f");
if (!openerId) {
return;
}
return this.browser()._targets.get(openerId);
}
/**
* @internal
*/
_targetInfoChanged(targetInfo) {
__classPrivateFieldSet(this, _Target_targetInfo, targetInfo, "f");
if (!this._isInitialized &&
(!this._isPageTargetCallback(__classPrivateFieldGet(this, _Target_targetInfo, "f")) ||
__classPrivateFieldGet(this, _Target_targetInfo, "f").url !== '')) {
this._isInitialized = true;
this._initializedCallback(true);
return;
}
}
}
_Target_browserContext = new WeakMap(), _Target_session = new WeakMap(), _Target_targetInfo = new WeakMap(), _Target_sessionFactory = new WeakMap(), _Target_ignoreHTTPSErrors = new WeakMap(), _Target_defaultViewport = new WeakMap(), _Target_pagePromise = new WeakMap(), _Target_workerPromise = new WeakMap(), _Target_screenshotTaskQueue = new WeakMap(), _Target_targetManager = new WeakMap();
//# sourceMappingURL=Target.js.map