@browserless.io/browserless 2.24.2 → 2.24.3

package/CHANGELOG.md

@@ -1,8 +1,15 @@
-# [Latest](https://github.com/browserless/chrome/compare/v2.24.2...main)
+# [Latest](https://github.com/browserless/chrome/compare/v2.24.3...main)
 
 - Dependency updates.
 
-# [Latest](https://github.com/browserless/chrome/compare/v2.24.1...v2.24.2)
+# [v2.24.3](https://github.com/browserless/chrome/compare/v2.24.2...v2.24.3)
+
+- Dependency updates.
+- Pins Ubuntu@22.04 in Github Actions.
+- Fixes `headless` types to use `--headless=new` when prior libraries attempt to do `--headless=old` (older playwright).
+- Typing fixes.
+
+# [v2.24.2](https://github.com/browserless/chrome/compare/v2.24.1...v2.24.2)
 
 - Dependency updates.
 - Fix issues with Firefox when using a proxy.

package/README.md

@@ -10,7 +10,7 @@
 ![Multi CI](https://github.com/browserless/chrome/actions/workflows/docker-multi.yml/badge.svg)
 
 > [!NOTE]  
-> [Looking for v1.x.x of browserless? You can find it here](https://github.com/browserless/chrome/tree/v1), although we recommend [migrating](/MIGRATION-2.0.md) to v2.
+> Looking to bypass bot detectors and solve captchas? [We would recommend using BrowserQL as our stealthiest option](https://www.browserless.io/feature/browserql).
 
 Browserless allows remote clients to connect and execute headless work, all inside of docker. It supports the standard, unforked Puppeteer and Playwright libraries, as well offering REST-based APIs for common actions like data collection, PDF generation and more.
 
@@ -57,12 +57,11 @@ If you've been struggling to deploy headless browsers without running into issue
 
 Our [cloud accounts](https://www.browserless.io/pricing/) include all the general features plus extras, such as:
 
-- Inbuilt [residential proxy](https://www.browserless.io/blog/residential-proxying/)
-- [/unblock API](https://www.browserless.io/blog/unblock-api) for avoiding detectors
-- [Automated captcha solving](https://www.browserless.io/blog/captcha-solving) for getting past mandatory checks
+- [BrowserQL](https://www.browserless.io/feature/browserql) for avoiding detectors and solving captchas
 - [Hybrid automations](https://www.browserless.io/blog/hybrid-automations-for-puppeteer/) for streaming login windows during scripts
 - [/reconnect API](https://www.browserless.io/blog/reconnect-api) for keeping browsers alive for reuse
 - [REST APIs](https://www.browserless.io/feature/rest-apis) for tasks such as retrieving HTML, PDFs or Lighthouse metrics
+- Inbuilt [residential proxy](https://www.browserless.io/blog/residential-proxying/)
 - SSO, tokens and user roles
 
 ## How it works

package/build/browsers/browsers.playwright.js

@@ -31,10 +31,15 @@ class BasePlaywright extends EventEmitter {
         this.removeAllListeners();
     }
     makeLaunchOptions(opts) {
+        // Strip headless=old as it'll cause issues with newer Chromium
+        const args = (opts.args ?? []).filter((a) => !a.includes('--headless=old'));
+        if (!args.some((a) => a.startsWith('--headless'))) {
+            args.push('--headless=new');
+        }
         return {
             ...opts,
             args: [
-                ...(opts.args || []),
+                ...args,
                 this.userDataDir ? `--user-data-dir=${this.userDataDir}` : '',
             ],
             executablePath: this.executablePath(),

package/build/routes/chrome/http/content.post.body.json

@@ -463,14 +463,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@29073": {
+                "__@toStringTag@25009": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@29073",
+                "__@toStringTag@25009",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -505,13 +505,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@29073": {
+        "__@toStringTag@25009": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@29073",
+        "__@toStringTag@25009",
         "byteLength"
       ]
     },
@@ -521,18 +521,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@29111": {
+        "__@species@25047": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@29073": {
+        "__@toStringTag@25009": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@29111",
-        "__@toStringTag@29073",
+        "__@species@25047",
+        "__@toStringTag@25009",
         "byteLength"
       ]
     },

package/build/routes/chrome/http/pdf.post.body.json

@@ -608,14 +608,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@378065": {
+                "__@toStringTag@112328": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@378065",
+                "__@toStringTag@112328",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -650,13 +650,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@378065": {
+        "__@toStringTag@112328": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@378065",
+        "__@toStringTag@112328",
         "byteLength"
       ]
     },
@@ -666,18 +666,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@378103": {
+        "__@species@112366": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@378065": {
+        "__@toStringTag@112328": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@378103",
-        "__@toStringTag@378065",
+        "__@species@112366",
+        "__@toStringTag@112328",
         "byteLength"
       ]
     },

package/build/routes/chrome/http/scrape.post.body.json

@@ -510,14 +510,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@116122": {
+                "__@toStringTag@124979": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@116122",
+                "__@toStringTag@124979",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -552,13 +552,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@116122": {
+        "__@toStringTag@124979": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@116122",
+        "__@toStringTag@124979",
         "byteLength"
       ]
     },
@@ -568,18 +568,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@116160": {
+        "__@species@125017": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@116122": {
+        "__@toStringTag@124979": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@116160",
-        "__@toStringTag@116122",
+        "__@species@125017",
+        "__@toStringTag@124979",
         "byteLength"
       ]
     },

package/build/routes/chrome/http/screenshot.post.body.json

@@ -553,14 +553,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@145363": {
+                "__@toStringTag@150362": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@145363",
+                "__@toStringTag@150362",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -595,13 +595,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@145363": {
+        "__@toStringTag@150362": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@145363",
+        "__@toStringTag@150362",
         "byteLength"
       ]
     },
@@ -611,18 +611,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@145401": {
+        "__@species@150400": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@145363": {
+        "__@toStringTag@150362": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@145401",
-        "__@toStringTag@145363",
+        "__@species@150400",
+        "__@toStringTag@150362",
         "byteLength"
       ]
     },

package/build/routes/chromium/http/content.post.body.json

@@ -463,14 +463,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@160033": {
+                "__@toStringTag@137683": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@160033",
+                "__@toStringTag@137683",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -505,13 +505,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@160033": {
+        "__@toStringTag@137683": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@160033",
+        "__@toStringTag@137683",
         "byteLength"
       ]
     },
@@ -521,18 +521,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@160071": {
+        "__@species@137721": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@160033": {
+        "__@toStringTag@137683": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@160071",
-        "__@toStringTag@160033",
+        "__@species@137721",
+        "__@toStringTag@137683",
         "byteLength"
       ]
     },

package/build/routes/chromium/http/pdf.post.body.json

@@ -608,14 +608,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@305471": {
+                "__@toStringTag@212748": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@305471",
+                "__@toStringTag@212748",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -650,13 +650,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@305471": {
+        "__@toStringTag@212748": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@305471",
+        "__@toStringTag@212748",
         "byteLength"
       ]
     },
@@ -666,18 +666,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@305509": {
+        "__@species@212786": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@305471": {
+        "__@toStringTag@212748": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@305509",
-        "__@toStringTag@305471",
+        "__@species@212786",
+        "__@toStringTag@212748",
         "byteLength"
       ]
     },

package/build/routes/chromium/http/scrape.post.body.json

@@ -510,14 +510,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@261543": {
+                "__@toStringTag@262923": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@261543",
+                "__@toStringTag@262923",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -552,13 +552,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@261543": {
+        "__@toStringTag@262923": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@261543",
+        "__@toStringTag@262923",
         "byteLength"
       ]
     },
@@ -568,18 +568,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@261581": {
+        "__@species@262961": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@261543": {
+        "__@toStringTag@262923": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@261581",
-        "__@toStringTag@261543",
+        "__@species@262961",
+        "__@toStringTag@262923",
         "byteLength"
       ]
     },

package/build/routes/chromium/http/screenshot.post.body.json

@@ -553,14 +553,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@290778": {
+                "__@toStringTag@237829": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@290778",
+                "__@toStringTag@237829",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -595,13 +595,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@290778": {
+        "__@toStringTag@237829": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@290778",
+        "__@toStringTag@237829",
         "byteLength"
       ]
     },
@@ -611,18 +611,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@290816": {
+        "__@species@237867": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@290778": {
+        "__@toStringTag@237829": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@290816",
-        "__@toStringTag@290778",
+        "__@species@237867",
+        "__@toStringTag@237829",
         "byteLength"
       ]
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserless.io/browserless",
-  "version": "2.24.2",
+  "version": "2.24.3",
   "license": "SSPL",
   "description": "The browserless platform",
   "author": "browserless.io",
@@ -51,7 +51,7 @@
     "debug": "^4.4.0",
     "del": "^8.0.0",
     "enjoi": "^9.0.1",
-    "file-type": "^19.6.0",
+    "file-type": "^20.0.0",
     "get-port": "^7.1.0",
     "gradient-string": "^3.0.0",
     "http-proxy": "^1.18.1",
@@ -62,12 +62,12 @@
     "playwright-1.47": "npm:playwright-core@1.47.2",
     "playwright-1.48": "npm:playwright-core@1.48.2",
     "playwright-core": "^1.49.1",
-    "puppeteer-core": "^23.11.1",
+    "puppeteer-core": "^24.1.1",
     "puppeteer-extra": "^3.3.6",
     "puppeteer-extra-plugin-stealth": "^2.11.2",
     "queue": "^7.0.0",
-    "systeminformation": "^5.25.5",
-    "tar-fs": "^3.0.6"
+    "systeminformation": "^5.25.11",
+    "tar-fs": "^3.0.8"
   },
   "optionalDependencies": {
     "@types/chai": "^5.0.1",
@@ -76,26 +76,26 @@
     "@types/http-proxy": "^1.17.15",
     "@types/micromatch": "^4.0.9",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^22.10.5",
+    "@types/node": "^22.10.10",
     "@types/sinon": "^17.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.19.1",
-    "@typescript-eslint/parser": "^8.19.1",
+    "@typescript-eslint/eslint-plugin": "^8.21.0",
+    "@typescript-eslint/parser": "^8.21.0",
     "assert": "^2.0.0",
     "chai": "^5.1.2",
     "cross-env": "^7.0.3",
     "env-cmd": "^10.1.0",
     "esbuild": "^0.24.2",
     "esbuild-plugin-polyfill-node": "^0.3.0",
-    "eslint": "^9.17.0",
+    "eslint": "^9.19.0",
     "extract-zip": "^2.0.1",
     "gunzip-maybe": "^1.4.2",
     "marked": "^15.0.6",
-    "mocha": "^11.0.1",
+    "mocha": "^11.1.0",
     "move-file": "^3.1.0",
     "prettier": "^3.4.2",
     "sinon": "^19.0.2",
     "ts-node": "^10.9.2",
-    "typescript": "^5.7.2",
+    "typescript": "^5.7.3",
     "typescript-json-schema": "^0.65.1"
   },
   "playwrightVersions": {

package/src/browsers/browsers.playwright.ts

@@ -56,10 +56,17 @@ class BasePlaywright extends EventEmitter {
   }
 
   protected makeLaunchOptions(opts: BrowserServerOptions) {
+    // Strip headless=old as it'll cause issues with newer Chromium
+    const args = (opts.args ?? []).filter((a) => !a.includes('--headless=old'));
+
+    if (!args.some((a) => a.startsWith('--headless'))) {
+      args.push('--headless=new');
+    }
+
     return {
       ...opts,
       args: [
-        ...(opts.args || []),
+        ...args,
         this.userDataDir ? `--user-data-dir=${this.userDataDir}` : '',
       ],
       executablePath: this.executablePath(),

package/src/routes/management/http/static.get.ts

@@ -28,7 +28,7 @@ const streamFile = (
   res: ServerResponse,
   file: string,
   contentType?: string,
-) =>
+): Promise<void> =>
   new Promise((resolve, reject) => {
     if (contentType) {
       logger.debug(`Setting content-type ${contentType}`);