@browserless.io/browserless 2.30.0 → 2.31.0

package/static/docs/swagger.min.json

@@ -280,14 +280,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@14939": {
+                "__@toStringTag@15012": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@14939",
+                "__@toStringTag@15012",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -322,13 +322,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@14939": {
+        "__@toStringTag@15012": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@14939",
+        "__@toStringTag@15012",
         "byteLength"
       ]
     },
@@ -338,18 +338,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@14977": {
+        "__@species@15050": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@14939": {
+        "__@toStringTag@15012": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@14977",
-        "__@toStringTag@14939",
+        "__@species@15050",
+        "__@toStringTag@15012",
         "byteLength"
       ]
     },
@@ -948,7 +948,20 @@
         },
         "path": {
           "description": "The file path to save the image to. The screenshot type will be inferred\nfrom file extension. If path is a relative path, then it is resolved\nrelative to current working directory. If no path is provided, the image\nwon't be saved to the disk.",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string",
+              "pattern": "^.*\\.webp$"
+            },
+            {
+              "type": "string",
+              "pattern": "^.*\\.jpeg$"
+            },
+            {
+              "type": "string",
+              "pattern": "^.*\\.png$"
+            }
+          ]
         },
         "clip": {
           "description": "Specifies the region of the page/element to clip.",
@@ -1001,7 +1014,7 @@
   },
   "info": {
     "title": "Browserless",
-    "version": "2.30.0",
+    "version": "2.31.0",
     "x-logo": {
       "altText": "browserless logo",
       "url": "./docs/browserless-logo-inline.svg"
@@ -3256,10 +3269,10 @@
         ]
       }
     },
-    "/content /chromium/content": {
+    "/chromium/content": {
       "post": {
         "definitions": {},
-        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.",
+        "description": "A JSON-based API. Given a \"url\" or \"html\" field, runs and returns HTML content after the page has loaded and JavaScript has parsed.\n\n**Note:** This endpoint is also available at: `/content` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -3543,16 +3556,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/content /chromium/content",
+        "summary": "/chromium/content",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/download /chromium/download": {
+    "/chromium/download": {
       "post": {
         "definitions": {},
-        "description": "A JSON or JavaScript content-type API for returning files Chrome has downloaded during\nthe execution of puppeteer code, which is ran inside context of the browser.\nBrowserless sets up a blank page, a fresh download directory, injects your puppeteer code, and then executes it.\nYou can load external libraries via the \"import\" syntax, and import ESM-style modules\nthat are written for execution inside of the browser. Once your script is finished, any\ndownloaded files from Chromium are returned back with the appropriate content-type header.",
+        "description": "A JSON or JavaScript content-type API for returning files Chrome has downloaded during\nthe execution of puppeteer code, which is ran inside context of the browser.\nBrowserless sets up a blank page, a fresh download directory, injects your puppeteer code, and then executes it.\nYou can load external libraries via the \"import\" syntax, and import ESM-style modules\nthat are written for execution inside of the browser. Once your script is finished, any\ndownloaded files from Chromium are returned back with the appropriate content-type header.\n\n**Note:** This endpoint is also available at: `/download` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -3659,16 +3672,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/download /chromium/download",
+        "summary": "/chromium/download",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/function /chromium/function": {
+    "/chromium/function": {
       "post": {
         "definitions": {},
-        "description": "A JSON or JavaScript content-type API for running puppeteer code in the browser's context.\nBrowserless sets up a blank page, injects your puppeteer code, and runs it.\nYou can optionally load external libraries via the \"import\" module that are meant for browser usage.\nValues returned from the function are checked and an appropriate content-type and response is sent back\nto your HTTP call.",
+        "description": "A JSON or JavaScript content-type API for running puppeteer code in the browser's context.\nBrowserless sets up a blank page, injects your puppeteer code, and runs it.\nYou can optionally load external libraries via the \"import\" module that are meant for browser usage.\nValues returned from the function are checked and an appropriate content-type and response is sent back\nto your HTTP call.\n\n**Note:** This endpoint is also available at: `/function` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -3775,16 +3788,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/function /chromium/function",
+        "summary": "/chromium/function",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/pdf /chromium/pdf": {
+    "/chromium/pdf": {
       "post": {
         "definitions": {},
-        "description": "A JSON-based API for getting a PDF binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist for\ninjecting cookies, request interceptors, user-agents and waiting for\nselectors, timers and more.",
+        "description": "A JSON-based API for getting a PDF binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist for\ninjecting cookies, request interceptors, user-agents and waiting for\nselectors, timers and more.\n\n**Note:** This endpoint is also available at: `/pdf` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -4071,16 +4084,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/pdf /chromium/pdf",
+        "summary": "/chromium/pdf",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/performance /chromium/performance": {
+    "/chromium/performance": {
       "post": {
         "definitions": {},
-        "description": "Run lighthouse performance audits with a supplied \"url\" in your JSON payload.",
+        "description": "Run lighthouse performance audits with a supplied \"url\" in your JSON payload.\n\n**Note:** This endpoint is also available at: `/performance` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -4203,16 +4216,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/performance /chromium/performance",
+        "summary": "/chromium/performance",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/scrape /chromium/scrape": {
+    "/chromium/scrape": {
       "post": {
         "definitions": {},
-        "description": "A JSON-based API that returns text, html, and meta-data from a given list of selectors.\nDebugging information is available by sending in the appropriate flags in the \"debugOpts\"\nproperty. Responds with an array of JSON objects.",
+        "description": "A JSON-based API that returns text, html, and meta-data from a given list of selectors.\nDebugging information is available by sending in the appropriate flags in the \"debugOpts\"\nproperty. Responds with an array of JSON objects.\n\n**Note:** This endpoint is also available at: `/scrape` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -4833,16 +4846,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/scrape /chromium/scrape",
+        "summary": "/chromium/scrape",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/screenshot /chromium/screenshot": {
+    "/chromium/screenshot": {
       "post": {
         "definitions": {},
-        "description": "A JSON-based API for getting a screenshot binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist including\ncookies, user-agents, setting timers and network mocks.",
+        "description": "A JSON-based API for getting a screenshot binary from either a supplied\n\"url\" or \"html\" payload in your request. Many options exist including\ncookies, user-agents, setting timers and network mocks.\n\n**Note:** This endpoint is also available at: `/screenshot` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -5143,7 +5156,7 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/screenshot /chromium/screenshot",
+        "summary": "/chromium/screenshot",
         "tags": [
           "Browser REST APIs"
         ]
@@ -8137,10 +8150,10 @@
         ]
       }
     },
-    " /chromium": {
+    "/chromium": {
       "get": {
         "definitions": {},
-        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.\n\n**Note:** This endpoint is also available at: `` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -8228,16 +8241,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": " /chromium",
+        "summary": "/chromium",
         "tags": [
           "Browser WebSocket APIs"
         ]
       }
     },
-    "/playwright/chromium /chromium/playwright": {
+    "/playwright/chromium": {
       "get": {
         "definitions": {},
-        "description": "Connect to Chromium with any playwright style library.",
+        "description": "Connect to Chromium with any playwright style library.\n\n**Note:** This endpoint is also available at: `/chromium/playwright` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -8325,7 +8338,7 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/playwright/chromium /chromium/playwright",
+        "summary": "/playwright/chromium",
         "tags": [
           "Browser WebSocket APIs"
         ]
@@ -8525,10 +8538,10 @@
         ]
       }
     },
-    "/playwright/firefox /firefox/playwright": {
+    "/playwright/firefox": {
       "get": {
         "definitions": {},
-        "description": "Connect to Firefox with any playwright-compliant library.",
+        "description": "Connect to Firefox with any playwright-compliant library.\n\n**Note:** This endpoint is also available at: `/firefox/playwright` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -8680,16 +8693,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/playwright/firefox /firefox/playwright",
+        "summary": "/playwright/firefox",
         "tags": [
           "Browser WebSocket APIs"
         ]
       }
     },
-    "/playwright/webkit /webkit/playwright": {
+    "/playwright/webkit": {
       "get": {
         "definitions": {},
-        "description": "Connect to Webkit with any playwright-compliant library.",
+        "description": "Connect to Webkit with any playwright-compliant library.\n\n**Note:** This endpoint is also available at: `/webkit/playwright` for backwards compatibility.",
         "parameters": [
           {
             "in": "query",
@@ -8777,7 +8790,7 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/playwright/webkit /webkit/playwright",
+        "summary": "/playwright/webkit",
         "tags": [
           "Browser WebSocket APIs"
         ]

package/static/function/client.js

@@ -1998,7 +1998,7 @@
           createDebug.namespaces = namespaces;
           createDebug.names = [];
           createDebug.skips = [];
-          const split = (typeof namespaces === "string" ? namespaces : "").trim().replace(" ", ",").split(",").filter(Boolean);
+          const split = (typeof namespaces === "string" ? namespaces : "").trim().replace(/\s+/g, ",").split(",").filter(Boolean);
           for (const ns of split) {
             if (ns[0] === "-") {
               createDebug.skips.push(ns.slice(1));
@@ -2218,7 +2218,7 @@
       function load() {
         let r;
         try {
-          r = exports2.storage.getItem("debug");
+          r = exports2.storage.getItem("debug") || exports2.storage.getItem("DEBUG");
         } catch (error) {
         }
         if (!r && typeof process !== "undefined" && "env" in process) {
@@ -4401,7 +4401,7 @@
   // node_modules/puppeteer-core/lib/esm/puppeteer/generated/version.js
   init_dirname();
   init_buffer2();
-  var packageVersion = "24.8.2";
+  var packageVersion = "24.10.0";
 
   // node_modules/puppeteer-core/lib/esm/puppeteer/util/assert.js
   init_dirname();
@@ -7451,7 +7451,6 @@
         }
         const recorder = new ScreenRecorder(this, width, height, {
           ...options,
-          path: options.ffmpegPath,
           crop
         });
         try {
@@ -8505,14 +8504,18 @@
   function createIncrementalIdGenerator() {
     let id = 0;
     return () => {
+      if (id === Number.MAX_SAFE_INTEGER) {
+        id = 0;
+      }
       return ++id;
     };
   }
 
   // node_modules/puppeteer-core/lib/esm/puppeteer/common/CallbackRegistry.js
+  var idGenerator = createIncrementalIdGenerator();
   var CallbackRegistry = class {
     #callbacks = /* @__PURE__ */ new Map();
-    #idGenerator = createIncrementalIdGenerator();
+    #idGenerator = idGenerator;
     create(label, timeout2, request) {
       const callback = new Callback(this.#idGenerator(), label, timeout2);
       this.#callbacks.set(callback.id, callback);

package/static/function/index.html

@@ -2006,7 +2006,7 @@
           createDebug.namespaces = namespaces;
           createDebug.names = [];
           createDebug.skips = [];
-          const split = (typeof namespaces === "string" ? namespaces : "").trim().replace(" ", ",").split(",").filter(Boolean);
+          const split = (typeof namespaces === "string" ? namespaces : "").trim().replace(/\s+/g, ",").split(",").filter(Boolean);
           for (const ns of split) {
             if (ns[0] === "-") {
               createDebug.skips.push(ns.slice(1));
@@ -2226,7 +2226,7 @@
       function load() {
         let r;
         try {
-          r = exports2.storage.getItem("debug");
+          r = exports2.storage.getItem("debug") || exports2.storage.getItem("DEBUG");
         } catch (error) {
         }
         if (!r && typeof process !== "undefined" && "env" in process) {
@@ -4409,7 +4409,7 @@
   // node_modules/puppeteer-core/lib/esm/puppeteer/generated/version.js
   init_dirname();
   init_buffer2();
-  var packageVersion = "24.8.2";
+  var packageVersion = "24.10.0";
 
   // node_modules/puppeteer-core/lib/esm/puppeteer/util/assert.js
   init_dirname();
@@ -7459,7 +7459,6 @@
         }
         const recorder = new ScreenRecorder(this, width, height, {
           ...options,
-          path: options.ffmpegPath,
           crop
         });
         try {
@@ -8513,14 +8512,18 @@
   function createIncrementalIdGenerator() {
     let id = 0;
     return () => {
+      if (id === Number.MAX_SAFE_INTEGER) {
+        id = 0;
+      }
       return ++id;
     };
   }
 
   // node_modules/puppeteer-core/lib/esm/puppeteer/common/CallbackRegistry.js
+  var idGenerator = createIncrementalIdGenerator();
   var CallbackRegistry = class {
     #callbacks = /* @__PURE__ */ new Map();
-    #idGenerator = createIncrementalIdGenerator();
+    #idGenerator = idGenerator;
     create(label, timeout2, request) {
       const callback = new Callback(this.#idGenerator(), label, timeout2);
       this.#callbacks.set(callback.id, callback);