"use strict"; /** * Copyright 2017 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. */ Object.defineProperty(exports, "__esModule", { value: true }); exports.Puppeteer = void 0; const CustomQueryHandler_js_1 = require("../common/CustomQueryHandler.js"); const BrowserConnector_js_1 = require("./BrowserConnector.js"); /** * The main Puppeteer class. * * IMPORTANT: if you are using Puppeteer in a Node environment, you will get an * instance of {@link PuppeteerNode} when you import or require `puppeteer`. * That class extends `Puppeteer`, so has all the methods documented below as * well as all that are defined on {@link PuppeteerNode}. * * @public */ class Puppeteer { /** * Operations for {@link CustomQueryHandler | custom query handlers}. See * {@link CustomQueryHandlerRegistry}. * * @internal */ static customQueryHandlers = CustomQueryHandler_js_1.customQueryHandlers; /** * Registers a {@link CustomQueryHandler | custom query handler}. * * @remarks * After registration, the handler can be used everywhere where a selector is * expected by prepending the selection string with `/`. The name is only * allowed to consist of lower- and upper case latin letters. * * @example * * ``` * puppeteer.registerCustomQueryHandler('text', { … }); * const aHandle = await page.$('text/…'); * ``` * * @param name - The name that the custom query handler will be registered * under. * @param queryHandler - The {@link CustomQueryHandler | custom query handler} * to register. * * @public */ static registerCustomQueryHandler(name, queryHandler) { return this.customQueryHandlers.register(name, queryHandler); } /** * Unregisters a custom query handler for a given name. */ static unregisterCustomQueryHandler(name) { return this.customQueryHandlers.unregister(name); } /** * Gets the names of all custom query handlers. */ static customQueryHandlerNames() { return this.customQueryHandlers.names(); } /** * Unregisters all custom query handlers. */ static clearCustomQueryHandlers() { return this.customQueryHandlers.clear(); } /** * @internal */ _isPuppeteerCore; /** * @internal */ _changedProduct = false; /** * @internal */ constructor(settings) { this._isPuppeteerCore = settings.isPuppeteerCore; this.connect = this.connect.bind(this); } /** * This method attaches Puppeteer to an existing browser instance. * * @remarks * * @param options - Set of configurable options to set on the browser. * @returns Promise which resolves to browser instance. */ connect(options) { return (0, BrowserConnector_js_1._connectToCdpBrowser)(options); } } exports.Puppeteer = Puppeteer; //# sourceMappingURL=Puppeteer.js.map