@browserless.io/browserless 2.37.0 → 2.38.0

package/static/docs/swagger.min.json

@@ -425,6 +425,9 @@
         "ignoreHTTPSErrors": {
           "type": "boolean"
         },
+        "acceptInsecureCerts": {
+          "type": "boolean"
+        },
         "slowMo": {
           "type": "number"
         },
@@ -981,7 +984,7 @@
   },
   "info": {
     "title": "Browserless",
-    "version": "2.37.0",
+    "version": "2.38.0",
     "x-logo": {
       "altText": "browserless logo",
       "url": "./docs/browserless-logo-inline.svg"

package/static/function/client.js

@@ -4419,11 +4419,6 @@
     }
   };
 
-  // node_modules/puppeteer-core/lib/esm/puppeteer/generated/version.js
-  init_dirname();
-  init_buffer2();
-  var packageVersion = "24.22.3";
-
   // node_modules/puppeteer-core/lib/esm/puppeteer/util/assert.js
   init_dirname();
   init_buffer2();
@@ -4474,6 +4469,11 @@
     return result;
   }
 
+  // node_modules/puppeteer-core/lib/esm/puppeteer/util/version.js
+  init_dirname();
+  init_buffer2();
+  var packageVersion = "24.26.1";
+
   // node_modules/puppeteer-core/lib/esm/puppeteer/common/Debug.js
   init_dirname();
   init_buffer2();
@@ -7399,14 +7399,12 @@
        * import {KnownDevices} from 'puppeteer';
        * const iPhone = KnownDevices['iPhone 15 Pro'];
        *
-       * (async () => {
-       *   const browser = await puppeteer.launch();
-       *   const page = await browser.newPage();
-       *   await page.emulate(iPhone);
-       *   await page.goto('https://www.google.com');
-       *   // other actions...
-       *   await browser.close();
-       * })();
+       * const browser = await puppeteer.launch();
+       * const page = await browser.newPage();
+       * await page.emulate(iPhone);
+       * await page.goto('https://www.google.com');
+       * // other actions...
+       * await browser.close();
        * ```
        */
       async emulate(device) {
@@ -7947,22 +7945,21 @@
        *
        * ```ts
        * import puppeteer from 'puppeteer';
-       * (async () => {
-       *   const browser = await puppeteer.launch();
-       *   const page = await browser.newPage();
-       *   let currentURL;
-       *   page
-       *     .waitForSelector('img')
-       *     .then(() => console.log('First URL with image: ' + currentURL));
-       *   for (currentURL of [
-       *     'https://example.com',
-       *     'https://google.com',
-       *     'https://bbc.com',
-       *   ]) {
-       *     await page.goto(currentURL);
-       *   }
-       *   await browser.close();
-       * })();
+       *
+       * const browser = await puppeteer.launch();
+       * const page = await browser.newPage();
+       * let currentURL;
+       * page
+       *   .waitForSelector('img')
+       *   .then(() => console.log('First URL with image: ' + currentURL));
+       * for (currentURL of [
+       *   'https://example.com',
+       *   'https://google.com',
+       *   'https://bbc.com',
+       * ]) {
+       *   await page.goto(currentURL);
+       * }
+       * await browser.close();
        * ```
        *
        * @param selector -
@@ -8012,14 +8009,13 @@
        *
        * ```ts
        * import puppeteer from 'puppeteer';
-       * (async () => {
-       *   const browser = await puppeteer.launch();
-       *   const page = await browser.newPage();
-       *   const watchDog = page.waitForFunction('window.innerWidth < 100');
-       *   await page.setViewport({width: 50, height: 50});
-       *   await watchDog;
-       *   await browser.close();
-       * })();
+       *
+       * const browser = await puppeteer.launch();
+       * const page = await browser.newPage();
+       * const watchDog = page.waitForFunction('window.innerWidth < 100');
+       * await page.setViewport({width: 50, height: 50});
+       * await watchDog;
+       * await browser.close();
        * ```
        *
        * @example
@@ -11288,24 +11284,22 @@
        * ```ts
        * import puppeteer from 'puppeteer';
        *
-       * (async () => {
-       *   const browser = await puppeteer.launch();
-       *   const page = await browser.newPage();
-       *   let currentURL;
-       *   page
-       *     .mainFrame()
-       *     .waitForSelector('img')
-       *     .then(() => console.log('First URL with image: ' + currentURL));
+       * const browser = await puppeteer.launch();
+       * const page = await browser.newPage();
+       * let currentURL;
+       * page
+       *   .mainFrame()
+       *   .waitForSelector('img')
+       *   .then(() => console.log('First URL with image: ' + currentURL));
        *
-       *   for (currentURL of [
-       *     'https://example.com',
-       *     'https://google.com',
-       *     'https://bbc.com',
-       *   ]) {
-       *     await page.goto(currentURL);
-       *   }
-       *   await browser.close();
-       * })();
+       * for (currentURL of [
+       *   'https://example.com',
+       *   'https://google.com',
+       *   'https://bbc.com',
+       * ]) {
+       *   await page.goto(currentURL);
+       * }
+       * await browser.close();
        * ```
        *
        * @param selector - The selector to query and wait for.
@@ -11327,14 +11321,14 @@
        * ```ts
        * import puppeteer from 'puppeteer';
        *
-       * (async () => {
-       * .  const browser = await puppeteer.launch();
-       * .  const page = await browser.newPage();
-       * .  const watchDog = page.mainFrame().waitForFunction('window.innerWidth < 100');
-       * .  page.setViewport({width: 50, height: 50});
-       * .  await watchDog;
-       * .  await browser.close();
-       * })();
+       * const browser = await puppeteer.launch();
+       * const page = await browser.newPage();
+       * const watchDog = page
+       *   .mainFrame()
+       *   .waitForFunction('window.innerWidth < 100');
+       * page.setViewport({width: 50, height: 50});
+       * await watchDog;
+       * await browser.close();
        * ```
        *
        * To pass arguments from Node.js to the predicate of `page.waitForFunction` function:
@@ -12364,9 +12358,10 @@
        *
        * ```ts
        * const feedHandle = await page.$('.feed');
-       * expect(
-       *   await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText)),
-       * ).toEqual(['Hello!', 'Hi!']);
+       *
+       * const listOfTweets = await feedHandle.$$eval('.tweet', nodes =>
+       *   nodes.map(n => n.innerText),
+       * );
        * ```
        *
        * @param selector -
@@ -12424,24 +12419,22 @@
        * ```ts
        * import puppeteer from 'puppeteer';
        *
-       * (async () => {
-       *   const browser = await puppeteer.launch();
-       *   const page = await browser.newPage();
-       *   let currentURL;
-       *   page
-       *     .mainFrame()
-       *     .waitForSelector('img')
-       *     .then(() => console.log('First URL with image: ' + currentURL));
+       * const browser = await puppeteer.launch();
+       * const page = await browser.newPage();
+       * let currentURL;
+       * page
+       *   .mainFrame()
+       *   .waitForSelector('img')
+       *   .then(() => console.log('First URL with image: ' + currentURL));
        *
-       *   for (currentURL of [
-       *     'https://example.com',
-       *     'https://google.com',
-       *     'https://bbc.com',
-       *   ]) {
-       *     await page.goto(currentURL);
-       *   }
-       *   await browser.close();
-       * })();
+       * for (currentURL of [
+       *   'https://example.com',
+       *   'https://google.com',
+       *   'https://bbc.com',
+       * ]) {
+       *   await page.goto(currentURL);
+       * }
+       * await browser.close();
        * ```
        *
        * @param selector - The selector to query and wait for.
@@ -14247,6 +14240,7 @@ ${sourceUrlComment}
     #name;
     #role;
     #ignored;
+    #cachedHasFocusableChild;
     #realm;
     constructor(realm, payload) {
       this.payload = payload;
@@ -14280,6 +14274,18 @@ ${sourceUrlComment}
       const role = this.#role;
       return role === "LineBreak" || role === "text" || role === "InlineTextBox" || role === "StaticText";
     }
+    #hasFocusableChild() {
+      if (this.#cachedHasFocusableChild === void 0) {
+        this.#cachedHasFocusableChild = false;
+        for (const child of this.children) {
+          if (child.#focusable || child.#hasFocusableChild()) {
+            this.#cachedHasFocusableChild = true;
+            break;
+          }
+        }
+      }
+      return this.#cachedHasFocusableChild;
+    }
     find(predicate) {
       if (predicate(this)) {
         return this;
@@ -14313,6 +14319,9 @@ ${sourceUrlComment}
         default:
           break;
       }
+      if (this.#hasFocusableChild()) {
+        return false;
+      }
       if (this.#role === "heading" && this.#name) {
         return true;
       }
@@ -14346,11 +14355,29 @@ ${sourceUrlComment}
           return false;
       }
     }
+    isLandmark() {
+      switch (this.#role) {
+        case "banner":
+        case "complementary":
+        case "contentinfo":
+        case "form":
+        case "main":
+        case "navigation":
+        case "region":
+        case "search":
+          return true;
+        default:
+          return false;
+      }
+    }
     isInteresting(insideControl) {
       const role = this.#role;
       if (role === "Ignored" || this.#hidden || this.#ignored) {
         return false;
       }
+      if (this.isLandmark()) {
+        return true;
+      }
       if (this.#focusable || this.#richlyEditable) {
         return true;
       }
@@ -14402,7 +14429,8 @@ ${sourceUrlComment}
         "description",
         "keyshortcuts",
         "roledescription",
-        "valuetext"
+        "valuetext",
+        "url"
       ];
       const getUserStringPropertyValue = (key) => {
         return properties.get(key);
@@ -15466,7 +15494,6 @@ ${sourceUrlComment}
      * `respond()` aren't called).
      */
     continueRequestOverrides() {
-      assert(this.interception.enabled, "Request Interception is not enabled!");
       return this.interception.requestOverrides;
     }
     /**
@@ -15474,14 +15501,12 @@ ${sourceUrlComment}
      * interception is allowed to respond (ie, `abort()` is not called).
      */
     responseForRequest() {
-      assert(this.interception.enabled, "Request Interception is not enabled!");
       return this.interception.response;
     }
     /**
      * The most recent reason for aborting the request
      */
     abortErrorReason() {
-      assert(this.interception.enabled, "Request Interception is not enabled!");
       return this.interception.abortReason;
     }
     /**
@@ -15542,8 +15567,12 @@ ${sourceUrlComment}
           return await this._continue(this.interception.requestOverrides);
       }
     }
-    #canBeIntercepted() {
-      return !this.url().startsWith("data:") && !this._fromMemoryCache;
+    /**
+     * @internal
+     */
+    verifyInterception() {
+      assert(this.interception.enabled, "Request Interception is not enabled!");
+      assert(!this.interception.handled, "Request is already handled!");
     }
     /**
      * Continues request with optional request overrides.
@@ -15574,11 +15603,10 @@ ${sourceUrlComment}
      * Exception is immediately thrown if the request interception is not enabled.
      */
     async continue(overrides = {}, priority) {
-      if (!this.#canBeIntercepted()) {
+      this.verifyInterception();
+      if (!this.canBeIntercepted()) {
         return;
       }
-      assert(this.interception.enabled, "Request Interception is not enabled!");
-      assert(!this.interception.handled, "Request is already handled!");
       if (priority === void 0) {
         return await this._continue(overrides);
       }
@@ -15631,11 +15659,10 @@ ${sourceUrlComment}
      * Exception is immediately thrown if the request interception is not enabled.
      */
     async respond(response, priority) {
-      if (!this.#canBeIntercepted()) {
+      this.verifyInterception();
+      if (!this.canBeIntercepted()) {
         return;
       }
-      assert(this.interception.enabled, "Request Interception is not enabled!");
-      assert(!this.interception.handled, "Request is already handled!");
       if (priority === void 0) {
         return await this._respond(response);
       }
@@ -15669,13 +15696,12 @@ ${sourceUrlComment}
      * throw an exception immediately.
      */
     async abort(errorCode = "failed", priority) {
-      if (!this.#canBeIntercepted()) {
+      this.verifyInterception();
+      if (!this.canBeIntercepted()) {
         return;
       }
       const errorReason = errorReasons[errorCode];
       assert(errorReason, "Unknown error code: " + errorCode);
-      assert(this.interception.enabled, "Request Interception is not enabled!");
-      assert(!this.interception.handled, "Request is already handled!");
       if (priority === void 0) {
         return await this._abort(errorReason);
       }
@@ -15875,7 +15901,7 @@ ${sourceUrlComment}
       }
     }
     headers() {
-      return this.#headers;
+      return structuredClone(this.#headers);
     }
     response() {
       return this._response;
@@ -15900,6 +15926,9 @@ ${sourceUrlComment}
         errorText: this._failureText
       };
     }
+    canBeIntercepted() {
+      return !this.url().startsWith("data:") && !this._fromMemoryCache;
+    }
     /**
      * @internal
      */
@@ -16164,7 +16193,7 @@ ${sourceUrlComment}
             return stringToTypedArray(response.body, response.base64Encoded);
           } catch (error) {
             if (error instanceof ProtocolError && error.originalMessage === "No resource with given identifier found") {
-              throw new ProtocolError("Could not load body for this request. This might happen if the request is a preflight request.");
+              throw new ProtocolError("Could not load response body for this request. This might happen if the request is a preflight request.");
             }
             throw error;
           }
@@ -19931,8 +19960,8 @@ ${sourceUrlComment}
   // node_modules/puppeteer-core/lib/esm/puppeteer/cdp/Browser.js
   var CdpBrowser = class _CdpBrowser extends Browser {
     protocol = "cdp";
-    static async _create(connection, contextIds, acceptInsecureCerts, defaultViewport, downloadBehavior, process3, closeCallback, targetFilterCallback, isPageTargetCallback, waitForInitiallyDiscoveredTargets = true, networkEnabled = true) {
-      const browser = new _CdpBrowser(connection, contextIds, defaultViewport, process3, closeCallback, targetFilterCallback, isPageTargetCallback, waitForInitiallyDiscoveredTargets, networkEnabled);
+    static async _create(connection, contextIds, acceptInsecureCerts, defaultViewport, downloadBehavior, process3, closeCallback, targetFilterCallback, isPageTargetCallback, waitForInitiallyDiscoveredTargets = true, networkEnabled = true, handleDevToolsAsPage = false) {
+      const browser = new _CdpBrowser(connection, contextIds, defaultViewport, process3, closeCallback, targetFilterCallback, isPageTargetCallback, waitForInitiallyDiscoveredTargets, networkEnabled, handleDevToolsAsPage);
       if (acceptInsecureCerts) {
         await connection.send("Security.setIgnoreCertificateErrors", {
           ignore: true
@@ -19951,7 +19980,8 @@ ${sourceUrlComment}
     #contexts = /* @__PURE__ */ new Map();
     #networkEnabled = true;
     #targetManager;
-    constructor(connection, contextIds, defaultViewport, process3, closeCallback, targetFilterCallback, isPageTargetCallback, waitForInitiallyDiscoveredTargets = true, networkEnabled = true) {
+    #handleDevToolsAsPage = false;
+    constructor(connection, contextIds, defaultViewport, process3, closeCallback, targetFilterCallback, isPageTargetCallback, waitForInitiallyDiscoveredTargets = true, networkEnabled = true, handleDevToolsAsPage = false) {
       super();
       this.#networkEnabled = networkEnabled;
       this.#defaultViewport = defaultViewport;
@@ -19962,6 +19992,7 @@ ${sourceUrlComment}
       this.#targetFilterCallback = targetFilterCallback || (() => {
         return true;
       });
+      this.#handleDevToolsAsPage = handleDevToolsAsPage;
       this.#setIsPageTargetCallback(isPageTargetCallback);
       this.#targetManager = new TargetManager(connection, this.#createTarget, this.#targetFilterCallback, waitForInitiallyDiscoveredTargets);
       this.#defaultContext = new CdpBrowserContext(this.#connection, this);
@@ -19998,7 +20029,7 @@ ${sourceUrlComment}
     }
     #setIsPageTargetCallback(isPageTargetCallback) {
       this.#isPageTargetCallback = isPageTargetCallback || ((target) => {
-        return target.type() === "page" || target.type() === "background_page" || target.type() === "webview";
+        return target.type() === "page" || target.type() === "background_page" || target.type() === "webview" || this.#handleDevToolsAsPage && target.type() === "other" && target.url().startsWith("devtools://");
       });
     }
     _getIsPageTargetCallback() {
@@ -20158,12 +20189,12 @@ ${sourceUrlComment}
 
   // node_modules/puppeteer-core/lib/esm/puppeteer/cdp/BrowserConnector.js
   async function _connectToCdpBrowser(connectionTransport, url, options) {
-    const { acceptInsecureCerts = false, networkEnabled = true, defaultViewport = DEFAULT_VIEWPORT, downloadBehavior, targetFilter, _isPageTarget: isPageTarget, slowMo = 0, protocolTimeout } = options;
+    const { acceptInsecureCerts = false, networkEnabled = true, defaultViewport = DEFAULT_VIEWPORT, downloadBehavior, targetFilter, _isPageTarget: isPageTarget, slowMo = 0, protocolTimeout, handleDevToolsAsPage } = options;
     const connection = new Connection(url, connectionTransport, slowMo, protocolTimeout);
     const { browserContextIds } = await connection.send("Target.getBrowserContexts");
     const browser = await CdpBrowser._create(connection, browserContextIds, acceptInsecureCerts, defaultViewport, downloadBehavior, void 0, () => {
       return connection.send("Browser.close").catch(debugError);
-    }, targetFilter, isPageTarget, void 0, networkEnabled);
+    }, targetFilter, isPageTarget, void 0, networkEnabled, handleDevToolsAsPage);
     return browser;
   }
 
@@ -20277,6 +20308,13 @@ puppeteer-core/lib/esm/puppeteer/cdp/BrowserContext.js:
    * SPDX-License-Identifier: Apache-2.0
    *)
 
+puppeteer-core/lib/esm/puppeteer/util/version.js:
+  (**
+   * @license
+   * Copyright 2025 Google Inc.
+   * SPDX-License-Identifier: Apache-2.0
+   *)
+
 puppeteer-core/lib/esm/puppeteer/common/Errors.js:
 puppeteer-core/lib/esm/puppeteer/cdp/Accessibility.js:
 puppeteer-core/lib/esm/puppeteer/api/WebWorker.js: