@browserless.io/browserless 2.2.0-beta-8 → 2.2.0

package/static/docs/swagger.json

@@ -225,14 +225,14 @@
                 "length": {
                   "type": "number"
                 },
-                "__@toStringTag@10774": {
+                "__@toStringTag@10812": {
                   "type": "string",
                   "const": "Uint8Array"
                 }
               },
               "required": [
                 "BYTES_PER_ELEMENT",
-                "__@toStringTag@10774",
+                "__@toStringTag@10812",
                 "buffer",
                 "byteLength",
                 "byteOffset",
@@ -267,13 +267,13 @@
         "byteLength": {
           "type": "number"
         },
-        "__@toStringTag@10774": {
+        "__@toStringTag@10812": {
           "type": "string"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@toStringTag@10774",
+        "__@toStringTag@10812",
         "byteLength"
       ]
     },
@@ -283,18 +283,18 @@
         "byteLength": {
           "type": "number"
         },
-        "__@species@10875": {
+        "__@species@10913": {
           "$ref": "#/definitions/SharedArrayBuffer"
         },
-        "__@toStringTag@10774": {
+        "__@toStringTag@10812": {
           "type": "string",
           "const": "SharedArrayBuffer"
         }
       },
       "additionalProperties": false,
       "required": [
-        "__@species@10875",
-        "__@toStringTag@10774",
+        "__@species@10913",
+        "__@toStringTag@10812",
         "byteLength"
       ]
     },
@@ -1055,7 +1055,17 @@
           "type": "number"
         },
         "routePath": {
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            {
+              "type": "string"
+            }
+          ]
         },
         "startedOn": {
           "type": "number"
@@ -1087,9 +1097,9 @@
     }
   },
   "info": {
-    "description": "![browserless.io logo](/assets/logo.png)\n\n![Docker Pulls](https://img.shields.io/docker/pulls/browserless/chrome)\n![GitHub package.json version (subfolder of monorepo)](https://img.shields.io/github/package-json/v/browserless/chrome)\n![Chrome CI](https://github.com/browserless/chrome/actions/workflows/docker-chromium.yml/badge.svg)\n![Firefox CI](https://github.com/browserless/chrome/actions/workflows/docker-firefox.yml/badge.svg)\n![Webkit CI](https://github.com/browserless/chrome/actions/workflows/docker-webkit.yml/badge.svg)\n![Multi CI](https://github.com/browserless/chrome/actions/workflows/docker-multi.yml/badge.svg)\n\n\n> [Looking for v1.x.x of browserless? You can find it here](https://github.com/browserless/chrome/tree/v1), although we recommend migrating to v2.\n\nBrowserless 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.\n\nWe take care of common issues such as missing system-fonts, missing external libraries, and performance improvements, along with edge-cases like downloading files and managing sessions. For details, check out the documentation site built into the project which includes Open API docs.\n\nIf you've been struggling to deploy headless browsers without running into issues or bloated resource requirements, then Browserless was built for you. Run the browsers in [our cloud](https://browserless.io/) or your own, [free for non-commercial uses](https://github.com/browserless/browserless#licensing).\n# Table of Contents\n\n1. [Features](#features)\n2. [How it works](#how-it-works)\n3. [Docker](#docker)\n4. [Hosting](#hosting-providers)\n5. [Puppeteer](#puppeteer)\n6. [Playwright](#playwright)\n7. [Extending with NodeJS SDK](#extending-nodejs-skd)\n8. [Licensing](#licensing)\n9. [Changelog](https://github.com/browserless/chrome/blob/master/CHANGELOG.md)\n\n## External links\n\n1. [Full documentation site](https://www.browserless.io/docs/start)\n2. [Live Debugger (using browserless.io)](https://chrome.browserless.io/)\n3. [Docker](https://github.com/browserless/browserless/pkgs/container/base)\n4. [Slack](https://join.slack.com/t/browserless/shared_invite/enQtMzA3OTMwNjA3MzY1LTRmMWU5NjQ0MTQ2YTE2YmU3MzdjNmVlMmU4MThjM2UxODNmNzNlZjVkY2U2NjdkMzYyNTgyZTBiMmE3Nzg0MzY)\n\n# Features\n\n- Parallelism and request-queueing are built-in + configurable.\n- Fonts and emoji's working out-of-the-box.\n- Debug Viewer for actively viewing/debugging running sessions.\n- An interactive puppeteer debugger, so you can see what the headless browser is doing and use its DevTools.\n- Works with unforked Puppeteer and Playwright.\n- Configurable session timers and health-checks to keep things running smoothly.\n- Error tolerant: if Chrome dies it won't.\n- [Support for running and development on Apple's M1 machines](#building-for-arm64-apple-m1-machines)\n\n# How it works\n\nBrowserless listens for both incoming websocket requests, generally issued by most libraries, as well as pre-build REST APIs to do common functions (PDF generation, images and so on). When a websocket connects to Browserless it starts Chrome and proxies your request into it. Once the session is done then it closes and awaits for more connections. Some libraries use Chrome's HTTP endpoints, like `/json` to inspect debug-able targets, which Browserless also supports.\n\nYou still execute the script itself which gives you total control over what library you want to choose and when to do upgrades. This also comes with the benefit of keep your code proprietary and able to run on numerous platforms. We simply take care of all the browser-aspects and offer a management layer on top of the browser.\n\n# Docker\n\n> See more options on our [full documentation site](https://www.browserless.io/docs/docker-quickstart).\n\n1. `docker run -p 3000:3000 ghcr.io/browserless/chrome`\n2. Visit `http://localhost:3000/docs` to see the documentation site.\n3. See more at our [docker package](https://github.com/browserless/browserless/pkgs/container/base).\n\n# Hosting Providers\n\nWe offer a first-class hosted product located [here](https://browserless.io). Alternatively you can host this image on just about any major platform that offers hosting for docker. Our hosted service takes care of all the machine provisioning, notifications, dashboards and monitoring plus more:\n\n- Easily upgrade and toggle between versions at the press of a button. No managing repositories and other code artifacts.\n- Never need to update or pull anything from docker. There's literally zero software to install to get started.\n- Scale your consumption up or down with different plans. We support up to thousands of concurrent sessions at a given time.\n\nIf you're interested in using this image for commercial aspects, then please read the below section on licensing.\n\n# Puppeteer\n\nPuppeteer allows you to specify a remote location for chrome via the `browserWSEndpoint` option. Setting this for Browserless is a single line of code change.\n\n**Before**\n```js\nconst browser = await puppeteer.launch();\n```\n\n**After**\n```js\nconst browser = await puppeteer.connect({ browserWSEndpoint: 'ws://localhost:3000' });\n```\n\n# Playwright\n\nWe support running with playwright via their remote connection method on the `chromium` interface. Since playwright is very similar to puppeteer, even launch arguments and other things \"just work\":\n\n**Before**\n```js\nconst browser = await pw.chromium.launch();\n```\n\n**After**\n```js\nconst browser = await pw.chromium.connect('ws://localhost:3000/playwright/chromium');\n\n// OR\nconst browser = await pw.chromium.connectOverCDP('ws://localhost:3000');\n```\n\nAfter that, the rest of your code remains the same with no other changes required.\n\n# Extending (NodeJS SKD)\n\nBrowserless comes with built-in extension capabilities, and allows for extending nearly any aspect of the system (for Version 2+). For more details on how to write your own routes, build docker images, and more, [see our SDK README.md](/bin/scaffold/README.md) or simply run \"npx @browserless.io/browserless create\" in a terminal and follow the onscreen prompts.\n\n# Usage with other libraries\n\nMost libraries allow you to specify a remote instance of Chrome to interact with. They are either looking for a websocket endpoint, a host and port, or some address. Browserless supports these by default, however if you're having issues please make an issue in this project and we'll try and work with the library authors to get them integrated with browserless. Please note that in V2 we no longer support selenium or webdriver integrations.\n\nYou can find a much larger list of supported libraries [on our documentation site](https://www.browserless.io/docs/puppeteer-library).\n\n# Motivations\n\nRunning Chrome on lambda or on your own is a fantastic idea but in practice is quite challenging in production. You're met with pretty tough cloud limits, possibly building Chrome yourself, and then dealing with odd invocation issues should everything else go ok. A lot of issues in various repositories are due to just challenges of getting Chrome running smoothly in AWS (see [here](https://github.com/GoogleChrome/puppeteer/issues?q=is%3Aissue+is%3Aopen+sort%3Acomments-desc)). You can see for yourself by going to nearly any library and sorting issues by most commented.\n\nGetting Chrome running well in docker is also a challenge as there's quiet a few packages you need in order to get Chrome running. Once that's done then there's still missing fonts, getting libraries to work with it, and having limitations on service reliability. This is also ignoring CVEs, access-controls, and scaling strategies.\n\nAll of these issues prompted us to build a first-class image and workflow for interacting with Chrome in a more streamlined way. With Browserless you never have to worry about fonts, extra packages, library support, security, or anything else. It just works reliably like any other modern web service. On top of that it comes with a prescribed approach on how you interact with Chrome, which is through socket connections (similar to a database or any other external appliance). What this means is that you get the ability to drive Chrome remotely without having to do updates/releases to the thing that runs Chrome since it's divorced from your application.\n\n# Licensing\n\nSPDX-License-Identifier: SSPL-1.0 OR Browserless Commercial License.\n\nIf you want to use Browserless to build commercial sites, applications, or in a continuous-integration system that's closed-source then you'll need to purchase a commercial license. This allows you to keep your software proprietary whilst still using browserless. [You can purchase a commercial license here](https://www.browserless.io/contact). A commercial license grants you:\n\n- Priority support on issues and features.\n- On-premise running as well as running on public cloud providers for commercial/CI purposes for proprietary systems.\n- Ability to modify the source (forking) for your own purposes.\n- A new admin user-interface.\n\nNot only does it grant you a license to run such a critical piece of infrastructure, but you are also supporting further innovation in this space and our ability to contribute to it.\n\nIf you are creating an open source application under a license compatible with the Server Side License 1.0, you may use Browserless under those terms.\n\n# Changelog\n<h1><a href=\"https://github.com/browserless/chrome/compare/v2.1.0...main\">Latest</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Add <code>clean</code> command to <code>@browserless.io/browserless</code> CLI.</li>\n<li>Adds support for <code>/json/list</code>, <code>/json/new</code> and <code>json/protocol</code> APIs (Chrome only).</li>\n<li>Removes legacy <code>browser.json</code> files since browserless now generates those and caches when requested.</li>\n<li>Only verify that internally managed browsers are installed when starting.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/browserless/compare/v2.0.0-beta-1...v2.1.0\">v2.1.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Name is now <code>@browserless.io/browserless</code> to reflect our npm package.</li>\n<li>NEW: SDK is now live here: <a href=\"https://www.npmjs.com/package/@browserless.io/browserless\">https://www.npmjs.com/package/@browserless.io/browserless</a>.</li>\n<li>Drops gulp and other gulp utilities in favor of our own. Move to modules in <code>scripts</code> dir.</li>\n<li>Many private class properties now use <code>protected</code> so they can be referenced in SDK extensions.</li>\n<li>Adds a <code>/json/version</code> route for older libraries that use it.</li>\n<li>Merge startup/test scripts into <code>scripts</code> dir.</li>\n<li>Moves installed browsers to <code>/usr/local/bin/playwright-browsers</code>.</li>\n<li>Merge root files into package.json where possible.</li>\n<li>README updates and fixes.</li>\n<li>Numerous link and copyright fixes.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/master...feat/browserless-2.0\">v2.0.0</a></h1>\n<p>browserless 2.0.0 represents the best body of work after running browserless for over 5 years. It contains mostly the same functionality and more, and is rebuilt to be more modular and offer a NodeJS SDK. It&#39;s also much lighter and faster than prior versions and includes a lot of semantic changes.</p>\n<h2>Features</h2>\n<ul>\n<li>ECMAScript style module loading and dependencies.</li>\n<li>New routing system using purely NodeJS&#39;s HTTP module.</li>\n<li>Better logs and concurrency/queueing parameters.</li>\n<li>Support for running the other major browser vendors in the same format and package.</li>\n<li>The service now compiles TypeScript to runtime JOI validation for our routes.</li>\n<li>Soon: upcoming support for extensions, long-running sessions and more.</li>\n</ul>\n<h2>Breaking Changes</h2>\n<ul>\n<li>Remove support for Selenium.</li>\n<li>The <code>/function</code> API now runs inside the context of the browser and not in Node.</li>\n<li>Drop support for keep-alive and pre-booting.</li>\n<li>Support for a single <code>launch</code> query-string parameter for launching a browser versus many individual parameters.</li>\n</ul>\n<h2>Minor Changes</h2>\n<ul>\n<li>Many docker parameters have been renamed, but are backwards compatible. See config.ts for details.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.60.2...v1.61.0\">v1.61.0</a></h1>\n<ul>\n<li><strong>FINAL of V1 for browserless/chrome. <a href=\"https://github.com/browserless/chrome/pull/3345\">See notes on V2 here</a></strong></li>\n<li>Dependency updates.</li>\n<li>Added <code>fonts-urw-base35</code>.</li>\n<li>Supports puppeteer <code>1.20</code>, <code>10.4.0</code>, <code>13.1.3</code>, <code>14.4.1</code>, <code>16.2.0</code>, <code>19.7.5</code> and <code>21.4.1</code>.</li>\n<li>Supports playwright <code>1.39</code>, <code>1.38</code>, <code>1.37</code>, <code>1.36</code>, <code>1.35</code>, <code>1.34</code>, and <code>1.33</code>.</li>\n<li>Fixes an issue where keep-alive chrome instances aren&#39;t properly tracked when <code>browser.close</code> is called.</li>\n<li>Fix improper handling of HTTP writing on bare sockets with 500 errors.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.60.1...v1.60.2\">v1.60.2</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fixes an issue where calls to GET /sessions sometimes return blank results.</li>\n<li>Drop puppeteer <code>21.3.1</code> in favor of <code>21.3.6</code>.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.60.0...v1.60.1\">v1.60.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Drop the <code>partner</code> repo from builds as we no longer use it for installing <code>flash</code>.</li>\n<li>Bump to <code>Ubuntu</code> lunar.</li>\n<li>Bump to NodeJS 18.17.0</li>\n<li>Package.json <code>engines.node</code> now reflects what node version we run on the docker image.</li>\n<li>Drops support for playwright@<code>1.33</code> and default playwright to <code>1.38</code>.</li>\n<li>Drops support for puppeteer@<code>21.1.1</code> in favor of <code>21.3.1</code>.</li>\n<li>Replaces legacy <code>request</code> module with Node&#39;s native <code>fetch</code> for webhooks.</li>\n<li>Drops <code>node-fetch</code> across the board in favor of <code>fetch</code> native.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.59.0...v1.60.0\">v1.60.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New build arguments in our Dockerfile to apply different named base repo.</li>\n<li>New <code>CHROME_STABLE_VERSION</code> build arg for specifying a particular chrome stable version.</li>\n<li>Fixes in postinstall hooks for various platforms and chrome-stable.</li>\n<li>NEW: <code>waitFor</code> properties in our APIs now supports an object with selector + timeouts for more fine tuning.</li>\n<li>Bump puppeteer <code>20.x.x</code> to <code>21.1.1</code> (116.0.5845.96).</li>\n<li>Supports playwright versions <code>1.37</code>, <code>1.36</code>, <code>1.35</code>, <code>1.34</code>, and <code>1.33</code>.</li>\n<li>Fixes in deploy script to handle versions, platforms and architectures.</li>\n<li>Fixes an issue where headless defaults to <code>DEFAULT_STEALTH</code>.</li>\n<li>New <code>PREBOOT_QUANTITY</code> for overriding the amount of pre-booted instances of Chrome.</li>\n<li>Allow using a host&#39;s display by setting <code>DISPLAY</code> env variable.</li>\n<li>Link fixes in README.md.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.58.0...v1.59.0\">v1.59.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Bump to Ubuntu Kinetic release + updates to use relevant packages.</li>\n<li>In support of puppeteer 20+, updates to <code>env.js</code> for finding/symlinking Chrome.</li>\n<li>Supports playwright <code>1.33</code>, <code>1.32</code>, <code>1.31</code>, and <code>1.29.</code>. Drops support for earlier versions.</li>\n<li>Ad-blocking and other request-interception in browserless is graceful using the <code>isInterceptResolutionHandled</code> method.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.57.0...v1.58.0\">v1.58.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Documentation link fixes.</li>\n<li>Add new required lib <code>libu2f-udev</code>.</li>\n<li>Support for <a href=\"mailto:puppeteer@19.7.5\">puppeteer@19.7.5</a>.</li>\n<li>Supports playwright versions: <code>1.27</code>, <code>1.28</code>, <code>1.29</code>, <code>1.30</code> and <code>1.31</code>.</li>\n<li>Better internal TypeScript definitions.</li>\n<li>Print&#39;s a few extra log-lines at startup for links to various resources.</li>\n<li><code>/kill/all</code> now supports rebooting when PREBOOT is turned on.</li>\n<li>Fixes an issue with chromedriver boot-looping in modern versions.</li>\n<li>Adds support for <code>--headless=new</code>.</li>\n<li>Fixes an issue where user-data-dirs aren&#39;t deleted due to a crashed container.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.56.0...v1.57.0\">v1.57.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Add back in <code>puppeteer@13.1.3</code> for PDF/Screenshot performance.</li>\n<li>Replace <code>puppeteer@18.0.5</code> in favor of <code>puppeteer@19.2.2</code>.</li>\n<li>Better puppeteer install/binary path lookups.</li>\n<li>Support for the following playwright versions via the /playwright path:<ul>\n<li>1.23.3</li>\n<li>1.24.2</li>\n<li>1.25.2</li>\n<li>1.26.1</li>\n<li>1.27.1</li>\n</ul>\n</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.55.0...v1.56.0\">v1.56.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fixes various puppeteer issues with regards to revision information and browser-fetching.</li>\n<li>Fixes a Selenium issue where failed browsers can cause session to zombie.</li>\n<li>Small fix for route error handling.</li>\n<li>Better selenium W3C support.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.55.0...v1.54.1\">v1.55.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li>Update base OS from Ubuntu 20.04 to Ubuntu 22.04.</li>\n<li>Drops <code>path</code> support for both <code>addScriptTag</code> and <code>addStyleTag</code>. Use <code>url</code> or inject content directly.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency updates.</li>\n<li>We now support multiple versions of playwright via <code>playwright-core</code>. browserless checks the User-Agent string and tries to load a compatible playwright server at runtime in order to avoid breakages between versions.</li>\n<li>New <code>scrollPage</code> boolean parameter for the screenshot and other relevant APIs.</li>\n<li>browserless now writes appropriately formatted HTTP and WebSocket messages for non-2xx responses.</li>\n<li>Better CI coverage with prior puppeteer versions.</li>\n<li>Adds back a <code>browser.json</code> file in our docker images for easier CDP-related queries.</li>\n<li>A new <code>PORT</code> arg is available at build time in order to specify a PORT to listen onto.</li>\n<li>Updated links for browserless documentation in docs.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.54.1...v1.54.0\">v1.54.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Add <code>browser.json</code> file to git tags.</li>\n<li>Prettier fixes on source.</li>\n<li>deploy.js file fixes for creating production tags.</li>\n<li>Fix: add the <code>userDataDir</code> option so that we don&#39;t fill disks when using <code>stealth</code>.</li>\n<li>Fix: allow <code>disconnect</code> listeners to fire before closing.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.53.0...v1.54.0\">v1.54.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Move to using <code>mocha</code> for better esm support.</li>\n<li>Drop puppeteer <code>13.6.0</code> in favor of <code>14.4.1</code>.</li>\n<li>Utilize puppeteer <code>14.4.1</code> for <code>chrome-stable</code>.</li>\n<li>New internal <code>getCDPClient</code> for loading a page&#39;s CPD connection.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.52.1...v1.53.0\">v1.53.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Bump <code>browserless:base</code> to <code>1.16.0</code>.</li>\n<li>Drop <code>--quiet</code> from deploy scripts.</li>\n<li><code>arm64</code> support for latest as well as puppeteer at versions 9,10 and 13.</li>\n<li>Update puppeteer 13 from <code>13.5.2</code> to <code>13.6.0</code> (revision <code>982053</code>).</li>\n<li>README updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.52.0...v1.52.1\">v1.52.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Playwright example correction in README.md.</li>\n<li>Use revision <code>970485</code> for puppeteer 13.x.x, <code>latest</code>, chrome-stable and <code>arm64</code>.</li>\n<li>When using <code>KEEPALIVE</code> and <code>PREBOOT</code>, don&#39;t create new blank pages, and use the existing one instead.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.51.1...v1.52.0\">v1.52.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Added in new fonts: <code>fonts-gfs-neohellenic</code>.</li>\n<li>Minor code formatting changes.</li>\n<li>Drop <a href=\"mailto:puppeteer@13.1.3\">puppeteer@13.1.3</a> in favor of 13.5.2.</li>\n<li>Make <code>heapdump</code> an optional dependency as it&#39;s not always used, and add it back in.</li>\n<li>Utilize <code>fs/promise</code> vs home-rolled promisified utils.</li>\n<li>Fix an issue where PREBOOT and KEEPALIVE might return an <code>undefined</code> browser.</li>\n<li>Logging when file-protocol requests happen and terminate a session.</li>\n<li>Move the browser process exit listener into the puppeteer-provider for better session cleanup.</li>\n<li>Allow &quot;headfull&quot; playwright sessions.</li>\n<li>Don&#39;t <code>await</code> chrome-helper&#39;s closing of the browser as it&#39;s not truly async.</li>\n<li>Remove <code>body-parser</code> in favor of <code>express</code>&#39;s JSON and other parsers.</li>\n<li>Fixes an issue where using a user-data-dir that doesn&#39;t exist causes chrome to crash.</li>\n<li>Add in more unit and integration tests.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.51.1...v1.52.0\">v1.52.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Added in new fonts: <code>fonts-gfs-neohellenic</code>.</li>\n<li>Minor code formatting changes.</li>\n<li>Drop <a href=\"mailto:puppeteer@13.1.3\">puppeteer@13.1.3</a> in favor of 13.5.2.</li>\n<li>Make <code>heapdump</code> an optional dependency as it&#39;s not always used, and add it back in.</li>\n<li>Utilize <code>fs/promise</code> vs home-rolled promisified utils.</li>\n<li>Fix an issue where PREBOOT and KEEPALIVE might return an <code>undefined</code> browser.</li>\n<li>Logging when file-protocol requests happen and terminate a session.</li>\n<li>Move the browser process exit listener into the puppeteer-provider for better session cleanup.</li>\n<li>Allow &quot;headfull&quot; playwright sessions.</li>\n<li>Don&#39;t <code>await</code> chrome-helper&#39;s closing of the browser as it&#39;s not truly async.</li>\n<li>Remove <code>body-parser</code> in favor of <code>express</code>&#39;s JSON and other parsers.</li>\n<li>Fixes an issue where using a user-data-dir that doesn&#39;t exist causes chrome to crash.</li>\n<li>Add in more unit and integration tests.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.51.0...v1.51.1\">v1.51.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Updates the <code>vm2</code> module to <code>3.9.7</code>.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.50.0...v1.51.0\">v1.51.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New <code>viewport</code> option inside of the content API.</li>\n<li>New <code>encoding</code> option in the screenshot API.</li>\n<li>Drop <a href=\"mailto:puppeteer@12.x.x\">puppeteer@12.x.x</a> in favor of 13.x.x.</li>\n<li>Fixes in our deploy scripts.</li>\n<li>Fixes for windows binaries in our postinstall hook.</li>\n<li>Fixes an issue where playwright tries to use a pre-booted chrome instance.</li>\n<li>Small type updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.49.1...v1.50.0\">v1.50.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Drops support for <code>puppeteer-4.0.1</code> in favor of <code>puppeteer-12.0.1</code>.</li>\n<li>Chrome-stable now utilizes puppeteer @ <code>12.0.1</code>.</li>\n<li>Support for <code>arm64</code> via production tags (<code>1-arm64</code>) as well as in <code>latest</code>.</li>\n<li>Static JSON files (<code>protocol.json</code>, <code>version.json</code>) are built at runtime on their first request and then cached in memory.</li>\n<li>Bumps <code>browserless/base</code> to <code>1.14.0</code>.</li>\n<li>New <code>selector</code> property for screenshot-ing a single DOM node in the screenshot API.</li>\n<li><code>puppeteerVersions</code> in the package.json file has been rename do <code>chromeVersions</code>.</li>\n<li>Internal changes for deploying production tag scripts.</li>\n<li>Consolidate scripts for <code>postinstall</code>.</li>\n<li>Drop support for <code>heapdump</code> due to its age and lack of platform varieties.</li>\n<li>New <code>/metrics/total</code> route for summing up all statistics in a single JSON payload.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.49.0...v1.49.1\">v1.49.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fix webhook not using timeout URL.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.48.0...v1.49.0\">v1.49.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Support for ARM64 builds by dropping flash for it.</li>\n<li>Bump puppeteer 10.2.0 for 10.4.0.</li>\n<li>New puppeteer-hook for injecting a puppeteer-compatible library, eg. puppeteer-extra.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.47.0...v1.48.0\">v1.48.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li>API calls with <code>html</code> in their payloads now use the <code>page.setContent</code> API versus a prior hack using one-time network-request interception (<a href=\"https://github.com/browserless/chrome/compare/v1.47.0...master#diff-67b699af1b24472604e21081d0509620d4ab3d986fcd4f8aa0b04d5ee5e4c63fL88\">example here</a>). Old versions of puppeteer might not work properly with this (&lt;= 5.x.x). This effects the following APIS: <code>/content</code>, <code>/pdf</code> and <code>/screenshot</code>.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency updates.</li>\n<li>Bump <code>browserless/base</code> to <code>1.12.0</code> (add user-id to <code>blessuser</code> of <code>BLESS_USER_ID=999</code>).</li>\n<li>Bumps puppeteer @10.x.x to <code>10.2.0</code> with revision <code>901912</code>.</li>\n<li>Makes API calls use <code>setContent</code> properly now (no more one-time network interception). This fixes certain issues with images not loading in PDFs and screenshots.</li>\n<li>Fix some typings in tests.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.46.0...v1.47.0\">v1.47.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Bump <code>browserless/base</code> to <code>1.11.0</code>.</li>\n<li>Add new lint task and rename GitHub actions tasks, remove <code>tslint</code>.</li>\n<li>Lint and prettier fixes.</li>\n<li>Delay url parsing until after <code>before</code> hook runs.</li>\n<li>New <code>meta</code> object param for page hooks (passing through arbitrary meta data set by prior hooks).</li>\n<li>New <code>FUNCTION_ENV_VARS</code> environment variable pass through an allow-list of environment variables for functions to access.</li>\n<li>Fix <code>someObject.hasOwnProperty</code> to <code>Object.prototype.hasOwnProperty.call</code>.</li>\n<li></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.45.0...v1.46.0\">v1.46.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Move to Node 16.x.x.</li>\n<li>Bump browserless/base to 1.10.0.</li>\n<li>Limit <code>x-response-url</code> to 100 characters.</li>\n<li>Add support for <a href=\"mailto:puppeteer@10.x.x\">puppeteer@10.x.x</a>.</li>\n<li>Add <code>maxConcurrent</code> stat for metrics API + log stats every 5 minutes to stdout.</li>\n<li>Some performance improvements to how pages/browsers are setup and torn down.</li>\n<li>Add <code>API_DOCS_ENDPOINT</code> as a filterable API to deny access to.</li>\n<li>Minor code reformatting from prettier.</li>\n<li>Better page setup and logging.</li>\n<li>Fixes <code>DEFAULT_STEALTH</code> for self-hosted deployments.</li>\n<li>Improvements on how chrome is closed.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.44.0...v1.45.0\">1.45.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Support for <a href=\"https://github.com/browserless/chrome/commit/0903795e936b93a511ec04f7ae35c03397682905\">playwright proxies</a>.</li>\n<li>Fixes an issue with larger headers potentially causing load-balancers to crash and fail.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.43.0...v1.44.0\">v1.44.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li><code>PROXY_HOST</code> and <code>PROXY_PORT</code> are now replaced with a single <code>PROXY_URL</code> param, eg: <code>https://www.mybrowserless.com/optional/paths</code>. When set, browserless uses this fully-qualified URL to build out links <em>back</em> to its internal debugger and sessions. Useful when you&#39;re instance is behind a proxy or load-balancer of some kind.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency Updates.</li>\n<li>Use recent Node 14 (browserless-base 1.7.0).</li>\n<li>New <code>rejectResourceTypes</code> property on most APIs (content, screenshot, pdf, etc.).</li>\n<li>Allow serving of <code>file://</code> protocols when explicitly enabled (default is off due to security concerns). Set <code>ALLOW_FILE_PROTOCOL=true</code> in your env params.</li>\n<li>The <code>/pressure</code> API now takes into account CPU/Memory consumption, and adds a &quot;reason&quot; property for why the machine might be not available.</li>\n<li>Fixes an issue where playwright couldn&#39;t download files.</li>\n<li>You can now filter /sessions calls with a <code>trackingId</code> parameter.</li>\n<li><code>detached</code> functions now return a <code>trackingId</code> when present.</li>\n<li>More types, tests, and utility consolidation.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.42.0...v1.43.0\">v1.43.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Fixes an issue where --user-data-dirs aren&#39;t deleted properly, potentially filling disks.</li>\n<li>Changes CPU/Memory checks to be user-based and not the entire OS.</li>\n<li>Adds tests for the user-data-dir issue.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.41.0...v1.42.0\">v1.42.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Move to Node 14!</li>\n<li>Use <code>esModuleInterop</code> for imports.</li>\n<li>Remove <code>page.waitFor</code> in favor of downstream methods.</li>\n<li>Adds new <code>?stealth</code> parameter for API calls (see puppeteer-extra-stealth-plugin).</li>\n<li>New <code>DEFAULT_STEALTH</code> param for making stealth calls by default.</li>\n<li>Fixes <code>ignoreDefaultArgs</code> in chrome stable.</li>\n<li>Ensure temp user-data-dirs are always cleaned up.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.40.2...v1.41.0\">v1.41.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>New <code>SESSION_CHECK_FAIL_URL</code> webhook for when pre-session checks fail.</li>\n<li>Health checks now take the last two CPU/Memory samples to determine if a failure (5 minutes).</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.40.1...v1.40.2\">v1.40.2</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Fix potentially unhandled stream error events when closing chrome.</li>\n<li>Bump puppeteer to 5.4.1 for major 5.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.40.0...v1.40.1\">v1.40.1</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>New <code>SOCKET_CLOSE_METHOD</code> for better load-balancing behavior when under load.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.39.0...v1.40.0\">v1.40.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Support for playwright 1.4.0 and greater. <a href=\"https://github.com/microsoft/playwright/issues/4054\">See more here</a>.</li>\n<li>New <code>PRE_REQUEST_HEALTH_CHECK</code> env variable to check CPU/Memory prior to running a session. Set <code>MAX_CPU_PERCENT</code> or <code>MAX_MEMORY_PERCENT</code> for setting these thresholds. Responds with a <code>503</code> HTTP code if CPU/Memory are high on any inbound session (API, puppeteer or webdriver).</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.38.0...v1.39.0\">v1.39.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Fixes a crash due to <code>browser.close</code> streams not completing properly.</li>\n<li>Adds a <code>dumpio</code> query-string parameter for launching with puppeteer.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.37.2...v1.38.0\">v1.38.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Fixes a memory leak when browsers don&#39;t close properly.</li>\n<li>Adds a <code>/heapdump</code> route for capturing heap dumps. Turn on by setting <code>ENABLE_HEAP_DUMP=true</code> in your docker env.</li>\n<li><code>emulateMedia</code> fixes on the pdf route.</li>\n<li>CodeQL implemented.</li>\n<li>README fixes.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.37.1...v1.37.2\">v1.37.2</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Fixes an issue where the webserver can crash after rejecting a request.</li>\n<li>Fixes deployment script not waiting for zip files to be finished unzipped.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.37.0...v1.37.1\">1.37.1</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Fixes an issue in webdriver not starting properly.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.36.0...v1.37.0\">1.37.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li>Due to stability issues, puppeteer version 3.x.x and 4.x.x now use chromium revision <code>782078</code>. See our <code>package.json</code> for details.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency Updates</li>\n<li>README Updates</li>\n<li>Fixes an issue for secured containers using prometheus (plus tests).</li>\n<li>Support for puppeteer <code>5.2.1</code></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.35.0...v1.36.0\">1.36.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Drops support for puppeteer <code>2.0.0</code> and <code>3.0.4</code>, please use <code>2.1.1</code> and <code>3.3.0</code> for those revisions.</li>\n<li>Adds support for puppeteer <code>5.0.0</code>.</li>\n<li>Bug-fix with the server randomly closing with an uncaught error event thrown from inside underlying socket connection.</li>\n<li>Adds back in <code>--disable-dev-shm-usage</code> to default arguments for better SHM performance.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.34.0...v1.35.0\">1.35.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>New <code>maxTime</code>, <code>minTime</code>, <code>meanTime</code> and <code>totalTime</code> of all sessions for a given period in /stats.</li>\n<li>Bugfix on CPU/Memory triggering health failure webhooks.</li>\n<li>Fix issues in websocket errors by awaiting browser.close (or 5 seconds, whichever is quickest).</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.33.1...v1.34.0\">v1.34.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li>screencast API no longer supports <code>audio</code> or the <code>setPreferences</code> function in order to offer a better video experience. In order to set the width/height, simply set a page width height to what you&#39;d like.</li>\n<li><code>chrome-stable</code> will now use <code>puppeteer@3.1.0</code> for better compatibility.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency updates.</li>\n<li>Drops puppeteer version <code>1.20.0</code> and below.</li>\n<li>Move <code>browserless/base</code> to <code>v1.5.0</code>.</li>\n<li>Puppeteer support for <code>3.3.0</code> (3.2.x and 3.1.x have the same chromium revision).</li>\n<li>Fixes <code>trackingId</code> on pre-booted sessions.</li>\n<li><code>about:blank</code> pages now are returned in the <code>/sessions</code> API for transparency of open sessions/browsers.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.33.0...v1.33.1\">1.33.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fix socket errors from accidentally firing error webhooks.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.32.0...v1.33.0\">1.33.0</a></h1>\n<ul>\n<li>Drops support for puppeteer 1.17.x and 1.18.x</li>\n<li>Support for puppeteer 3.0.x</li>\n<li>Dependency updates</li>\n<li>Fix reject stat firing on debugger pages not being found</li>\n<li>Consolidates more types.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.31.1...v1.32.0\">1.32.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Adds roboto fonts.</li>\n<li>Updates <code>pressure</code> API to take account of running browsers in the <code>running</code> count.</li>\n<li>Adds <code>maxConcurrent</code>, <code>maxQueued</code>, <code>cpu</code> and <code>memory</code> to pressure.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.31.0...v1.31.1\">1.31.1</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Fixes a small issue where XVFB doesn&#39;t start properly during an automated restart.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.30.0...v1.31.0\">1.31.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Allows <code>trackingId</code> on uploaded files to save in the appropriate tracking-ID folder.</li>\n<li>New <code>userAgent</code> param for setting user-agent in API requests.</li>\n<li>Fixes an issue where chrome wasn&#39;t being closed in rare cases.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.29.1...v1.30.0\">1.30.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Updates to Node 13 for speed and memory improvements.</li>\n<li>browserless/<a href=\"mailto:base@1.4.0\">base@1.4.0</a></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.29.0...v1.29.1\">1.29.1</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Fixes how deploy script determines errors when running child commands.</li>\n<li>Fixes issues when many selenium sessions can potentially fill up disk space.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.28.0...v1.29.0\">1.29.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Uses <code>pipe</code>&#39;s for most API calls and other internal endpoints for faster/better throughput. Works only for <code>headless</code> API/puppeteer calls.</li>\n<li>Allows custom lighthouse configs via POST <code>config</code> property.</li>\n<li>Patches vm2.</li>\n<li>Before hooks no longer end requests forcefully -- external hooks must manually end the request/sockets themselves.</li>\n<li>Properly passes socket errors to the error handler/webhook</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.27.0...v1.28.0\">1.28.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Sets a system-default font of Ubuntu for most sites that use <code>system-ui</code> in their font declarations.</li>\n<li>Fixes health-check failure webhooks.</li>\n<li>New <code>PROXY_HOST</code>, <code>PROXY_PORT</code> and <code>PROXY_SSL</code> for external load-balancers. <a href=\"https://www.browserless.io/docs/docker.html#using-a-proxy\">See docsite for more info</a>.</li>\n<li>Moves over to GH actions over Travis for CI.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.26.1...v1.27.0\">1.27.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New <code>manipulate</code> params for screenshots, allowing for resizing, flipping and more.</li>\n<li>Better tracking of chrome-process for cleanup of zombied sessions.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.26.0...v1.26.1\">1.26.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Added <code>git</code> as a dependency in dockerfile for git-based npm dependencies to work.</li>\n<li>Fixed an issue in <code>start.sh</code> so that errors bubble up properly and close the process.</li>\n<li>Bumps <code>browserless/base</code> to <code>1.2.0</code>.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.25.0...v1.26.0\">1.26.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Dropping pre-push hooks for speed.</li>\n<li>Consolidate all interfaces/types to a types.d.ts file.</li>\n<li>Fixes an issue where numerous chrome instances launch when prebooting.</li>\n<li>Fixes an issue where incoming requests don&#39;t use the pre-booted chrome instance.</li>\n<li>Uses <code>page.setViewport</code> when <code>--window-size</code> is set in params to help with screenshots not appearing properly (chromedriver only).</li>\n<li></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.24.0...v1.25.0\">1.25.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Stricter build-time arguments for chromium and chromedriver assets.</li>\n<li>Better XVFB functionality.</li>\n<li>New parameters for most API&#39;s, <code>addScriptTag</code> and <code>addStyleTag</code>, accepting an array of scripts/styles respectively.</li>\n<li>Drop support for <code>puppeteer@1.17.0</code>.</li>\n<li>Proper support for parsing <code>ignoreDefaultArgs</code> query-parameters.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.23.1...v1.24.0\">1.24.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Bugfix on our debugger&#39;s play button being off-center.</li>\n<li>Fixes driver.close() calls not cleaning the browser.</li>\n<li>New <code>/GET</code> option for most our APIs. Stringify your JSON and add a ?body=YOUR-JSON with a /GET call to most of our functions! Requires <code>ENABLE_API_GET=true</code> in you docker env variables.</li>\n<li>WebSocket (Socket) exception handling and logging.</li>\n<li>More integration and unit tests added.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.23.0...v1.23.1\">1.23.1</a></h1>\n<ul>\n<li>Fixes an issue in chromedriver where commands would hang.</li>\n<li>Fixes an issue in chromedriver sessions not being removed properly.</li>\n<li>Fixes and pins the base image so that headful sessions work again.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.22.0...v1.23.0\">1.23.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Use <code>apt-get</code> to install <code>dumb-init</code>.</li>\n<li>Add a LANG arg in docker.</li>\n<li>New <code>setJavaScriptEnabled</code> property for REST APIs.</li>\n<li>Fixes an issue with <code>waitFor</code> functions in REST API calls.</li>\n<li>Fixes issues when PREBOOT_CHROME and KEEPALIVE are true.</li>\n<li>Updates protocol and host information in ad-blocking.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.21.0...v1.22.0\">1.22.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Removal of unnecessary &#39;--disable-dev-shm-usage&#39;</li>\n<li>Squelching of chromedriver&#39;s verbose args unless <code>DEBUG=*</code> is set.</li>\n<li>New <code>/kill/${id}</code> route for remotely killing a certain browser.</li>\n<li>Allowing of sub-child routes in workspaces.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.20.0...v1.21.0\">1.21.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New <code>viewport</code> property option for PDF endpoint.</li>\n<li>The <code>/stats</code> endpoint now runs in a separate process meaning it can be parallelized.</li>\n<li>Fixed a bug where hardware monitoring can cause the container to restart/crash.</li>\n<li>Fixes an issue with the file-chooser API not working in puppeteer.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.19.0...v1.20.0\">1.20.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New <code>/scrape</code> API!</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.18.0...v1.19.0\">1.19.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fixes chrome-stable&#39;s binary chromedriver.</li>\n<li>Move over to Node 12.</li>\n<li>Bugfix on width/height in the screencast API.</li>\n<li>Support for <a href=\"mailto:puppeteer@2.0.0\">puppeteer@2.0.0</a>.</li>\n<li>Fixed issues with the devtools JS files missing.</li>\n<li>Adds support for blacklisting routes in Docker.</li>\n<li>Consolidates hooks into a hooks module.</li>\n<li>Allows Selenium to specify download-paths and pausing via preferences.</li>\n<li>Fixes an issue in certain JSON-based CDP libraries.</li>\n<li>Function API&#39;s can now run incognito mode with a new Docker param.</li>\n<li></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.17.0...v1.18.0\">1.18.0</a></h1>\n<ul>\n<li>Dependency updates</li>\n<li>Better <code>IS_DOCKER</code> check for kubernetes.</li>\n<li>Updates to README.md, spelling fixes and Slack link.</li>\n<li>Fixes to debugger and larger code bodies.</li>\n<li>Removal of analytics in debugger.</li>\n<li>Screencast improvements and adding ability to set new options.</li>\n<li>New <code>waitFor</code> property in our APIs (content, pdf and screenshot).</li>\n<li>Don&#39;t allow file requests on the debugger for security reasons.</li>\n<li>Better metrics monitoring.</li>\n<li><code>singleRun</code> mode in docker.</li>\n<li>New prometheus support!</li>\n<li>Fixing issues with keeping chrome alive (only closing once TTL is met).</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.16.0...v1.17.0\">1.17.0</a></h1>\n<ul>\n<li>Dependency updates</li>\n<li>Splitting docker images into two repositories for faster builds and pulls</li>\n<li>Adding in external routing capabilities</li>\n<li>New error hook</li>\n<li>More/better types</li>\n<li>Updating <code>deviceScaleFactor</code> in API&#39;s for more granular control.</li>\n<li>Better chromedriver failure messages.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.15.0...v1.16.0\">1.16.0</a></h1>\n<ul>\n<li>Adding <code>ffmpeg</code> to the docker dependency list.</li>\n<li>Add <code>timecut</code> as a dependency for recording.</li>\n<li>Better logs on chrome PID&#39;s and closing forcefully.</li>\n<li>Fixed <code>DEFAULT_CHROME</code> =&gt; <code>DEFAULT_HEADLESS</code>.</li>\n<li>Fixed a bug where <code>xvfb</code> doesn&#39;t start in time.</li>\n<li>Use <code>SIGKILL</code> for killing chromedriver.</li>\n<li><code>/json/version</code> now returns a <code>webSocketDebuggerUrl</code>.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.14.1...v1.15.0\">1.15.0</a></h1>\n<ul>\n<li>New <code>page</code> and <code>browser</code> hooks for docker images that <code>FROM</code> browserless.</li>\n<li><code>bluebird</code> added as a module for <code>function</code> and other endpoints.</li>\n<li>More dependency updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.14.0...v1.14.1\">1.14.1</a></h1>\n<ul>\n<li>Bugfix when running multiple &quot;headfull&quot; sessions.</li>\n<li>Dependency updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.13.0...v1.14.0\">1.14.0</a></h1>\n<ul>\n<li>New <code>WORKSPACE_DELETE_EXPIRED</code> and <code>WORKSPACE_EXPIRE_DAYS</code> to auto-cleanup workspace dirs.</li>\n<li>README.md cleanup now that HTTPS is no longer required.</li>\n<li>Support for <code>~</code> in docker env parameters.</li>\n<li>More alignment with how chromedriver and puppeteer sessions get cleaned up.</li>\n<li><code>/session</code> API now returns <code>browserWSEndpoint</code> and <code>browserId</code> properties for having multiple debuggers connected.</li>\n<li>Support for reconnecting(!!). When a <code>?keepalive=KEEP-ALIVE-IN-MS</code> is seen in the <code>puppeteer.connect</code> call we keep the browser active for that many ms after the debugger disconnects.</li>\n<li>New <code>/kill/all</code> route which closes <em>all</em> actively running sessions.</li>\n<li>New internal scheduler module, making future things like cron-based jobs a possibility.</li>\n<li>Better internal types.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.12.0...v1.13.0\">1.13.0</a></h1>\n<ul>\n<li>A minor refactor to consolidate calls to <code>url.parse</code> for performance gains.</li>\n<li>Introduces a per-session based timeout that overrides the global timeout.</li>\n<li>Consolidates authorization checks to remove duplication.</li>\n<li>Moves more types into their backing modules in order to better consolidate files.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.11.0...v1.12.0\">1.12.0</a></h1>\n<ul>\n<li>Set&#39;s a non-conflicting <code>WORKSPACE_DIR</code> and <code>DEFAULT_USER_DATA_DIR</code> in docker by default.</li>\n<li>Drops support for puppeteer <code>1.15.0</code> and adds <code>1.19.0</code>.</li>\n<li>Web-based debugger now sends cookies for docker deployments that are secure.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.10.0...v1.11.0\">1.11.0</a></h1>\n<ul>\n<li>Live debugger is now self-hosted, no more enforced https though it&#39;s still recommended.</li>\n<li>Consolidated build steps.</li>\n<li>Using the same chromedriver binary that matches the puppeteer&#39;s bundled chromium.</li>\n<li>Introducing <code>trackingId</code> workflows.</li>\n<li>Fixing unused export&#39;s, removing extraneous internal methods.</li>\n<li><code>/workspace</code> API now returns sub-files and scopes sessions by <code>trackingId</code> when present.</li>\n<li>Support for <code>/json/new</code> protocol.</li>\n<li>Dependency updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.9.0...v1.10.0\">1.10.0</a></h1>\n<ul>\n<li>Dropped support for puppeteer <code>1.9.0 =&gt; 1.14.0</code>.</li>\n<li>Added support for puppeteer <code>1.16.0 =&gt; 1.18.0</code>.</li>\n<li>A version of chromedriver is now installed to perfectly match the version of puppeteer&#39;s chromium.</li>\n<li>In dev, chromedriver now uses the puppeteer version of chromium.</li>\n<li>Defaulted most ENV-variables in docker to sensible defaults.</li>\n<li>New <code>rotate</code> feature for PDF endpoint: <code>{ rotate: 90 }</code> =&gt; rotate left 90 degrees.</li>\n<li>Support for <code>browserless.token</code> in the docker image.</li>\n<li>puppeteer integration now returns semantic HTTP codes for certain errors (<code>400</code>, <code>403</code> and <code>429</code>).</li>\n<li>Support for chromedriver&#39;s move to the W3C spec &#39;goog:chromeOptions&#39;.</li>\n<li>The debugger now filters out <code>about:blank</code> pages, and includes sessions by Selenium.</li>\n<li>Workspace support for selenium-based integrations.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.8.0...v1.9.0\">1.9.0</a></h1>\n<ul>\n<li>Better handling of browser/socket closing in puppeteer integrations.</li>\n<li>Numerous screencast fixes.</li>\n<li>Moved all GH links to new repo location.</li>\n<li>Dep updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.7.0...v1.8.0\">1.8.0</a></h1>\n<ul>\n<li>Better windows dev experience.</li>\n<li>Indian font support.</li>\n<li>Video capture now supports audio and browser width/height.</li>\n<li>Dependency updates.</li>\n<li>DEFAULT env variables for launching pre-booted Chrome.</li>\n</ul>\n<h1>1.7.0</h1>\n<ul>\n<li>Dep updates</li>\n<li>New <code>?blockAds</code> query-parameter for disabling 3rd-party ad calls.</li>\n</ul>\n<h1>1.6.0</h1>\n<ul>\n<li>New <code>authenticate</code> and <code>setExtraHTTPHeaders</code> params for the <code>content</code>, <code>pdf</code>, and <code>screenshot</code> APIs. Useful for using proxies in our REST APIs.</li>\n<li>Fixed a bunch of bugs inside of the webdriver integration, making it more REST-ful.</li>\n<li>Updated dependencies inside of Chromedriver.</li>\n<li>New <code>DISABLE_AUTO_SET_DOWNLOAD_BEHAVIOR</code> for mitigating errors in puppeteer &lt; 1.15.0.</li>\n<li>Bumped Puppeteer to 1.15.0.</li>\n</ul>\n<h1>1.5.0</h1>\n<ul>\n<li>New <code>/session</code> API (and accompanying routes) for display/viewing active sesions in a remote debugger(!).</li>\n<li>New <code>?pause</code> query-param for pausing sessions prior to running them (useful for the live debug viewer).</li>\n<li>The browserless debugger now exposes links to these debug pages via the sidebar.</li>\n<li>New Debugger page can be disabled via the <code>ENABLE_DEBUG_VIEWER=false</code> environment variable flag.</li>\n<li>Move to use <code>node@10</code>.</li>\n<li>No more <code>no-implicit-any</code>&#39;s inside the codebase.</li>\n</ul>\n<h1>1.4.0</h1>\n<ul>\n<li>During connection, we now set the download dir of REST and puppeteer sessions. Cloud users and docker users no longer have to manually set this field, and the <code>/workspace</code> API references it as well!</li>\n</ul>\n<h1>1.3.1</h1>\n<h1>Fixes</h1>\n<ul>\n<li>New deploy.js file to do deployments &quot;on-prem&quot;</li>\n<li>Updated new builds for puppeteer 1.12.2 and 1.13.0</li>\n<li>Fixes an issues in CORS handling</li>\n</ul>\n<h1>1.3.0</h1>\n<h1>Minor changes</h1>\n<ul>\n<li>The <code>screenshot</code>, <code>function</code>, <code>pdf</code>, and <code>content</code> API&#39;s now accept new content-types for easier POSTing of small payloads (see docsite).</li>\n<li>The <code>screencast</code> API can now start/stop recording programmatically via a <code>startScreencast</code> and <code>stopScreencast</code> params (see docsite).</li>\n<li>New <code>external</code> dir for injecting custom <code>before</code> and <code>after</code> hooks in external docker builds.</li>\n<li>A new <code>timeout</code> query-option for session-based timeouts vs using the global one.</li>\n<li>New <code>requestInterceptors</code> for injection custom request behavior.</li>\n</ul>\n<h1>Fixes</h1>\n<ul>\n<li>Numerous default fixes in the APIs.</li>\n<li>Stray consoles removed :)</li>\n<li>Consolidated download behavior in <code>screencast</code> and <code>download</code> APIs</li>\n</ul>\n<h1>1.2.0</h1>\n<h1>Minor Changes</h1>\n<ul>\n<li>New <code>requestInterceptors</code> for the /screenshot API, <a href=\"https://github.com/browserless/chrome/pull/119\">allowing you to mock data in response to a request</a>.</li>\n<li>Code debugger now transmits code over-the-wire via cookies to avoid URL max-length issues.</li>\n<li>Now supports cookie-based authentication via a <code>browserless_token=TOKEN;</code> cookie.</li>\n</ul>\n<h1>Fixes</h1>\n<ul>\n<li><a href=\"https://github.com/browserless/chrome/issues/118\">Comments in the debugger won&#39;t break it.</a></li>\n<li>Requests that are rejected due to auth reasons aren&#39;t logged in stats.</li>\n</ul>\n<h1>1.1.0</h1>\n<p>With 1.1.0 we offer a refined way of dealing with both downloads and uploads. Both use-cases are tightly coupled to the file-system, and can leave you scratching your head as to what&#39;s going one. For more information and detailed documentation, please refer to our doc-site at <a href=\"https://www.browserless.io/\">https://www.browserless.io/</a></p>\n<h2>Minor Changes</h2>\n<ul>\n<li>New <code>WORKSPACE_DIR</code> variable for controlling where browserless stores files and uploads.</li>\n<li>New <code>/workspace</code> API for doing RESTful operations on the downloads/uploads file-system.</li>\n<li>New <code>/download</code> API for running a puppeteer-script, and responding with the resulting downloaded file.</li>\n</ul>\n<h2>Internal Changes</h2>\n<ul>\n<li>Moved routes out of the browserless module and into their own file/module.</li>\n<li>Renamed the <code>browserless-web-service</code> module to just <code>browserless</code> for simplicity.</li>\n<li>Moved the <code>DOWNLOAD_DIR</code> to <code>WORKSPACE_DIR</code> since it handles both uploads and downloads.</li>\n</ul>\n<h1>1.0.0</h1>\n<p>🥁 -- Stable version 1.0 is here! While this doesn&#39;t include major functionality changes, it <em>does</em> change how the docker builds are generated going forward. The versioning will now contain two pieces of crucial information: the version of the <em>browserless</em> service + the version of Chrome under-the-hood. For instance <code>1.2.3-puppeteer-1.10.0</code> is browserless at <code>1.2.3</code>, exposing puppeteer at <code>1.10.0</code>.</p>\n<p>Similar to how NodeJS itself does docker releases, we&#39;ll now provide releases in 3 distinct ways:</p>\n<ul>\n<li>An <em>immutable</em>, pinned version release: <code>1.0.0-puppeteer-1.11.0</code></li>\n<li>A mutable minor version release: <code>1.1-puppeteer-1.12.0</code></li>\n<li>A mutable major version release: <code>1-puppeteer-1.9.0</code></li>\n</ul>\n<p>For production deployments, we recommend using <em>pinned</em> version releases as they won&#39;t change once released. The mutable minor/major releases will receive on-going updates whenever we do changes that are bug-fixes or feature release. Even with the best intentions it&#39;s possible that instability can be introduced with these mutable images, hence why recommend the pinned version releases.</p>\n<p>Finally, we&#39;ll continue to ship support for the last 5 minor versions of Puppeteer + the Google Chrome (stable). Old images will remain, but newer versions of browserless won&#39;t be included.</p>\n<p>We&#39;ll continue to keep this changelog up-to-date anytime we do docker releases.</p>\n",
+    "description": "![browserless.io logo](/assets/logo.png)\n\n![Docker Pulls](https://img.shields.io/docker/pulls/browserless/chrome)\n![GitHub package.json version (subfolder of monorepo)](https://img.shields.io/github/package-json/v/browserless/chrome)\n![Chrome CI](https://github.com/browserless/chrome/actions/workflows/docker-chromium.yml/badge.svg)\n![Firefox CI](https://github.com/browserless/chrome/actions/workflows/docker-firefox.yml/badge.svg)\n![Webkit CI](https://github.com/browserless/chrome/actions/workflows/docker-webkit.yml/badge.svg)\n![Multi CI](https://github.com/browserless/chrome/actions/workflows/docker-multi.yml/badge.svg)\n\n\n> [Looking for v1.x.x of browserless? You can find it here](https://github.com/browserless/chrome/tree/v1), although we recommend migrating to v2.\n\nBrowserless 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.\n\nWe take care of common issues such as missing system-fonts, missing external libraries, and performance improvements, along with edge-cases like downloading files and managing sessions. For details, check out the documentation site built into the project which includes Open API docs.\n\nIf you've been struggling to deploy headless browsers without running into issues or bloated resource requirements, then Browserless was built for you. Run the browsers in [our cloud](https://browserless.io/) or your own, [free for non-commercial uses](https://github.com/browserless/browserless#licensing).\n# Table of Contents\n\n1. [Features](#features)\n2. [How it works](#how-it-works)\n3. [Docker](#docker)\n4. [Hosting](#hosting-providers)\n5. [Puppeteer](#puppeteer)\n6. [Playwright](#playwright)\n7. [Extending with NodeJS SDK](#extending-nodejs-skd)\n8. [Licensing](#licensing)\n9. [Changelog](https://github.com/browserless/chrome/blob/master/CHANGELOG.md)\n\n## External links\n\n1. [Full documentation site](https://www.browserless.io/docs/start)\n2. [Live Debugger (using browserless.io)](https://chrome.browserless.io/)\n3. [Docker](https://github.com/browserless/browserless/pkgs/container/base)\n4. [Slack](https://join.slack.com/t/browserless/shared_invite/enQtMzA3OTMwNjA3MzY1LTRmMWU5NjQ0MTQ2YTE2YmU3MzdjNmVlMmU4MThjM2UxODNmNzNlZjVkY2U2NjdkMzYyNTgyZTBiMmE3Nzg0MzY)\n\n# Features\n\n- Parallelism and request-queueing are built-in + configurable.\n- Fonts and emoji's working out-of-the-box.\n- Debug Viewer for actively viewing/debugging running sessions.\n- An interactive puppeteer debugger, so you can see what the headless browser is doing and use its DevTools.\n- Works with unforked Puppeteer and Playwright.\n- Configurable session timers and health-checks to keep things running smoothly.\n- Error tolerant: if Chrome dies it won't.\n- [Support for running and development on Apple's M1 machines](#building-for-arm64-apple-m1-machines)\n\n# How it works\n\nBrowserless listens for both incoming websocket requests, generally issued by most libraries, as well as pre-build REST APIs to do common functions (PDF generation, images and so on). When a websocket connects to Browserless it starts Chrome and proxies your request into it. Once the session is done then it closes and awaits for more connections. Some libraries use Chrome's HTTP endpoints, like `/json` to inspect debug-able targets, which Browserless also supports.\n\nYou still execute the script itself which gives you total control over what library you want to choose and when to do upgrades. This also comes with the benefit of keep your code proprietary and able to run on numerous platforms. We simply take care of all the browser-aspects and offer a management layer on top of the browser.\n\n# Docker\n\n> See more options on our [full documentation site](https://www.browserless.io/docs/docker-quickstart).\n\n1. `docker run -p 3000:3000 ghcr.io/browserless/chrome`\n2. Visit `http://localhost:3000/docs` to see the documentation site.\n3. See more at our [docker package](https://github.com/browserless/browserless/pkgs/container/base).\n\n# Hosting Providers\n\nWe offer a first-class hosted product located [here](https://browserless.io). Alternatively you can host this image on just about any major platform that offers hosting for docker. Our hosted service takes care of all the machine provisioning, notifications, dashboards and monitoring plus more:\n\n- Easily upgrade and toggle between versions at the press of a button. No managing repositories and other code artifacts.\n- Never need to update or pull anything from docker. There's literally zero software to install to get started.\n- Scale your consumption up or down with different plans. We support up to thousands of concurrent sessions at a given time.\n\nIf you're interested in using this image for commercial aspects, then please read the below section on licensing.\n\n# Puppeteer\n\nPuppeteer allows you to specify a remote location for chrome via the `browserWSEndpoint` option. Setting this for Browserless is a single line of code change.\n\n**Before**\n```js\nconst browser = await puppeteer.launch();\n```\n\n**After**\n```js\nconst browser = await puppeteer.connect({ browserWSEndpoint: 'ws://localhost:3000' });\n```\n\n# Playwright\n\nWe support running with playwright via their remote connection method on the `chromium` interface. Since playwright is very similar to puppeteer, even launch arguments and other things \"just work\":\n\n**Before**\n```js\nconst browser = await pw.chromium.launch();\n```\n\n**After**\n```js\nconst browser = await pw.chromium.connect('ws://localhost:3000/playwright/chromium');\n\n// OR\nconst browser = await pw.chromium.connectOverCDP('ws://localhost:3000');\n```\n\nAfter that, the rest of your code remains the same with no other changes required.\n\n# Extending (NodeJS SKD)\n\nBrowserless comes with built-in extension capabilities, and allows for extending nearly any aspect of the system (for Version 2+). For more details on how to write your own routes, build docker images, and more, [see our SDK README.md](/bin/scaffold/README.md) or simply run \"npx @browserless.io/browserless create\" in a terminal and follow the onscreen prompts.\n\n# Usage with other libraries\n\nMost libraries allow you to specify a remote instance of Chrome to interact with. They are either looking for a websocket endpoint, a host and port, or some address. Browserless supports these by default, however if you're having issues please make an issue in this project and we'll try and work with the library authors to get them integrated with browserless. Please note that in V2 we no longer support selenium or webdriver integrations.\n\nYou can find a much larger list of supported libraries [on our documentation site](https://www.browserless.io/docs/puppeteer-library).\n\n# Motivations\n\nRunning Chrome on lambda or on your own is a fantastic idea but in practice is quite challenging in production. You're met with pretty tough cloud limits, possibly building Chrome yourself, and then dealing with odd invocation issues should everything else go ok. A lot of issues in various repositories are due to just challenges of getting Chrome running smoothly in AWS (see [here](https://github.com/GoogleChrome/puppeteer/issues?q=is%3Aissue+is%3Aopen+sort%3Acomments-desc)). You can see for yourself by going to nearly any library and sorting issues by most commented.\n\nGetting Chrome running well in docker is also a challenge as there's quiet a few packages you need in order to get Chrome running. Once that's done then there's still missing fonts, getting libraries to work with it, and having limitations on service reliability. This is also ignoring CVEs, access-controls, and scaling strategies.\n\nAll of these issues prompted us to build a first-class image and workflow for interacting with Chrome in a more streamlined way. With Browserless you never have to worry about fonts, extra packages, library support, security, or anything else. It just works reliably like any other modern web service. On top of that it comes with a prescribed approach on how you interact with Chrome, which is through socket connections (similar to a database or any other external appliance). What this means is that you get the ability to drive Chrome remotely without having to do updates/releases to the thing that runs Chrome since it's divorced from your application.\n\n# Licensing\n\nSPDX-License-Identifier: SSPL-1.0 OR Browserless Commercial License.\n\nIf you want to use Browserless to build commercial sites, applications, or in a continuous-integration system that's closed-source then you'll need to purchase a commercial license. This allows you to keep your software proprietary whilst still using browserless. [You can purchase a commercial license here](https://www.browserless.io/contact). A commercial license grants you:\n\n- Priority support on issues and features.\n- On-premise running as well as running on public cloud providers for commercial/CI purposes for proprietary systems.\n- Ability to modify the source (forking) for your own purposes.\n- A new admin user-interface.\n\nNot only does it grant you a license to run such a critical piece of infrastructure, but you are also supporting further innovation in this space and our ability to contribute to it.\n\nIf you are creating an open source application under a license compatible with the Server Side License 1.0, you may use Browserless under those terms.\n\n# Changelog\n<h1><a href=\"https://github.com/browserless/chrome/compare/v2.2.0...main\">Latest</a></h1>\n<ul>\n<li>Dependency updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v2.1.0...v2.2.0\">v2.2.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li><code>ghcr.io/browserless/chrome</code> now runs actual Chrome and not Chromium! If you were using this tag please update to use <code>ghcr.io/browserless/chromium</code>!<ul>\n<li>This Chrome tag uses the new routing convention below. If you get random 404&#39;s, please add <code>/chrome</code> to the start of the route. EG, <code>/pdf</code> becomes <code>/chrome/pdf</code>.</li>\n<li>Websocket connections follow a similar breakage in that the URL will go from something like <code>ws://localhost:3000</code> to <code>ws://localhost:3000/chrome</code>.</li>\n</ul>\n</li>\n<li>Adds a new <code>ghcr.io/browserless/chromium</code>, and updates <code>ghcr.io/browserless/chrome</code> to use actual Chrome.</li>\n<li>New and current APIs now follow a routing convention of <code>/$BROWSER/$ACTION</code>. In our Chrome image, you&#39;ll see <code>/chrome/pdf</code> for the PDF route as opposed to <code>/pdf</code>.<ul>\n<li>To keep things backwards compatible, all our prior REST APIs still have the same path as well as the new semantic, but only in the <code>multi</code> and <code>chromium</code> tags.</li>\n<li>These backwards compatible routes are ONLY available in <code>ghcr.io/browserless/chromium</code> and <code>ghcr.io/browserless/multi</code>.</li>\n</ul>\n</li>\n<li>Refer to the embedded documentation site for any and all updates on API differences.</li>\n</ul>\n<p><strong>Other Changes</strong></p>\n<ul>\n<li>HTTPRoutes and WebSocket routes can now have multiple paths to listen on.</li>\n<li>Add <code>clean</code> command to <code>@browserless.io/browserless</code> CLI.</li>\n<li>Adds support for <code>/json/list</code>, <code>/json/new</code>, <code>/json/version</code> and <code>json/protocol</code> APIs (Chrome and Chromium only).<ul>\n<li>When both Chrome and Chromium are present (in the case of the multi image), browserless opts for Chromium for these requests.</li>\n</ul>\n</li>\n<li>Removes legacy <code>browser.json</code> files since browserless now generates those and caches when requested.</li>\n<li>Stable docker images are coming! Please be sure to see our packages page for stable tags.</li>\n<li>Only verify that internally managed browsers are installed when starting.</li>\n<li>Preliminary support for <code>--headless=shell</code>.</li>\n<li>More unit-tests for the Chrome /json APIs.</li>\n<li>Dependency updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/browserless/compare/v2.0.0-beta-1...v2.1.0\">v2.1.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Name is now <code>@browserless.io/browserless</code> to reflect our npm package.</li>\n<li>NEW: SDK is now live here: <a href=\"https://www.npmjs.com/package/@browserless.io/browserless\">https://www.npmjs.com/package/@browserless.io/browserless</a>.</li>\n<li>Drops gulp and other gulp utilities in favor of our own. Move to modules in <code>scripts</code> dir.</li>\n<li>Many private class properties now use <code>protected</code> so they can be referenced in SDK extensions.</li>\n<li>Adds a <code>/json/version</code> route for older libraries that use it.</li>\n<li>Merge startup/test scripts into <code>scripts</code> dir.</li>\n<li>Moves installed browsers to <code>/usr/local/bin/playwright-browsers</code>.</li>\n<li>Merge root files into package.json where possible.</li>\n<li>README updates and fixes.</li>\n<li>Numerous link and copyright fixes.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/master...feat/browserless-2.0\">v2.0.0</a></h1>\n<p>browserless 2.0.0 represents the best body of work after running browserless for over 5 years. It contains mostly the same functionality and more, and is rebuilt to be more modular and offer a NodeJS SDK. It&#39;s also much lighter and faster than prior versions and includes a lot of semantic changes.</p>\n<h2>Features</h2>\n<ul>\n<li>ECMAScript style module loading and dependencies.</li>\n<li>New routing system using purely NodeJS&#39;s HTTP module.</li>\n<li>Better logs and concurrency/queueing parameters.</li>\n<li>Support for running the other major browser vendors in the same format and package.</li>\n<li>The service now compiles TypeScript to runtime JOI validation for our routes.</li>\n<li>Soon: upcoming support for extensions, long-running sessions and more.</li>\n</ul>\n<h2>Breaking Changes</h2>\n<ul>\n<li>Remove support for Selenium.</li>\n<li>The <code>/function</code> API now runs inside the context of the browser and not in Node.</li>\n<li>Drop support for keep-alive and pre-booting.</li>\n<li>Support for a single <code>launch</code> query-string parameter for launching a browser versus many individual parameters.</li>\n</ul>\n<h2>Minor Changes</h2>\n<ul>\n<li>Many docker parameters have been renamed, but are backwards compatible. See config.ts for details.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.60.2...v1.61.0\">v1.61.0</a></h1>\n<ul>\n<li><strong>FINAL of V1 for browserless/chrome. <a href=\"https://github.com/browserless/chrome/pull/3345\">See notes on V2 here</a></strong></li>\n<li>Dependency updates.</li>\n<li>Added <code>fonts-urw-base35</code>.</li>\n<li>Supports puppeteer <code>1.20</code>, <code>10.4.0</code>, <code>13.1.3</code>, <code>14.4.1</code>, <code>16.2.0</code>, <code>19.7.5</code> and <code>21.4.1</code>.</li>\n<li>Supports playwright <code>1.39</code>, <code>1.38</code>, <code>1.37</code>, <code>1.36</code>, <code>1.35</code>, <code>1.34</code>, and <code>1.33</code>.</li>\n<li>Fixes an issue where keep-alive chrome instances aren&#39;t properly tracked when <code>browser.close</code> is called.</li>\n<li>Fix improper handling of HTTP writing on bare sockets with 500 errors.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.60.1...v1.60.2\">v1.60.2</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fixes an issue where calls to GET /sessions sometimes return blank results.</li>\n<li>Drop puppeteer <code>21.3.1</code> in favor of <code>21.3.6</code>.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.60.0...v1.60.1\">v1.60.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Drop the <code>partner</code> repo from builds as we no longer use it for installing <code>flash</code>.</li>\n<li>Bump to <code>Ubuntu</code> lunar.</li>\n<li>Bump to NodeJS 18.17.0</li>\n<li>Package.json <code>engines.node</code> now reflects what node version we run on the docker image.</li>\n<li>Drops support for playwright@<code>1.33</code> and default playwright to <code>1.38</code>.</li>\n<li>Drops support for puppeteer@<code>21.1.1</code> in favor of <code>21.3.1</code>.</li>\n<li>Replaces legacy <code>request</code> module with Node&#39;s native <code>fetch</code> for webhooks.</li>\n<li>Drops <code>node-fetch</code> across the board in favor of <code>fetch</code> native.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.59.0...v1.60.0\">v1.60.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New build arguments in our Dockerfile to apply different named base repo.</li>\n<li>New <code>CHROME_STABLE_VERSION</code> build arg for specifying a particular chrome stable version.</li>\n<li>Fixes in postinstall hooks for various platforms and chrome-stable.</li>\n<li>NEW: <code>waitFor</code> properties in our APIs now supports an object with selector + timeouts for more fine tuning.</li>\n<li>Bump puppeteer <code>20.x.x</code> to <code>21.1.1</code> (116.0.5845.96).</li>\n<li>Supports playwright versions <code>1.37</code>, <code>1.36</code>, <code>1.35</code>, <code>1.34</code>, and <code>1.33</code>.</li>\n<li>Fixes in deploy script to handle versions, platforms and architectures.</li>\n<li>Fixes an issue where headless defaults to <code>DEFAULT_STEALTH</code>.</li>\n<li>New <code>PREBOOT_QUANTITY</code> for overriding the amount of pre-booted instances of Chrome.</li>\n<li>Allow using a host&#39;s display by setting <code>DISPLAY</code> env variable.</li>\n<li>Link fixes in README.md.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.58.0...v1.59.0\">v1.59.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Bump to Ubuntu Kinetic release + updates to use relevant packages.</li>\n<li>In support of puppeteer 20+, updates to <code>env.js</code> for finding/symlinking Chrome.</li>\n<li>Supports playwright <code>1.33</code>, <code>1.32</code>, <code>1.31</code>, and <code>1.29.</code>. Drops support for earlier versions.</li>\n<li>Ad-blocking and other request-interception in browserless is graceful using the <code>isInterceptResolutionHandled</code> method.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.57.0...v1.58.0\">v1.58.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Documentation link fixes.</li>\n<li>Add new required lib <code>libu2f-udev</code>.</li>\n<li>Support for <a href=\"mailto:puppeteer@19.7.5\">puppeteer@19.7.5</a>.</li>\n<li>Supports playwright versions: <code>1.27</code>, <code>1.28</code>, <code>1.29</code>, <code>1.30</code> and <code>1.31</code>.</li>\n<li>Better internal TypeScript definitions.</li>\n<li>Print&#39;s a few extra log-lines at startup for links to various resources.</li>\n<li><code>/kill/all</code> now supports rebooting when PREBOOT is turned on.</li>\n<li>Fixes an issue with chromedriver boot-looping in modern versions.</li>\n<li>Adds support for <code>--headless=new</code>.</li>\n<li>Fixes an issue where user-data-dirs aren&#39;t deleted due to a crashed container.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.56.0...v1.57.0\">v1.57.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Add back in <code>puppeteer@13.1.3</code> for PDF/Screenshot performance.</li>\n<li>Replace <code>puppeteer@18.0.5</code> in favor of <code>puppeteer@19.2.2</code>.</li>\n<li>Better puppeteer install/binary path lookups.</li>\n<li>Support for the following playwright versions via the /playwright path:<ul>\n<li>1.23.3</li>\n<li>1.24.2</li>\n<li>1.25.2</li>\n<li>1.26.1</li>\n<li>1.27.1</li>\n</ul>\n</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.55.0...v1.56.0\">v1.56.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fixes various puppeteer issues with regards to revision information and browser-fetching.</li>\n<li>Fixes a Selenium issue where failed browsers can cause session to zombie.</li>\n<li>Small fix for route error handling.</li>\n<li>Better selenium W3C support.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.55.0...v1.54.1\">v1.55.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li>Update base OS from Ubuntu 20.04 to Ubuntu 22.04.</li>\n<li>Drops <code>path</code> support for both <code>addScriptTag</code> and <code>addStyleTag</code>. Use <code>url</code> or inject content directly.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency updates.</li>\n<li>We now support multiple versions of playwright via <code>playwright-core</code>. browserless checks the User-Agent string and tries to load a compatible playwright server at runtime in order to avoid breakages between versions.</li>\n<li>New <code>scrollPage</code> boolean parameter for the screenshot and other relevant APIs.</li>\n<li>browserless now writes appropriately formatted HTTP and WebSocket messages for non-2xx responses.</li>\n<li>Better CI coverage with prior puppeteer versions.</li>\n<li>Adds back a <code>browser.json</code> file in our docker images for easier CDP-related queries.</li>\n<li>A new <code>PORT</code> arg is available at build time in order to specify a PORT to listen onto.</li>\n<li>Updated links for browserless documentation in docs.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.54.1...v1.54.0\">v1.54.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Add <code>browser.json</code> file to git tags.</li>\n<li>Prettier fixes on source.</li>\n<li>deploy.js file fixes for creating production tags.</li>\n<li>Fix: add the <code>userDataDir</code> option so that we don&#39;t fill disks when using <code>stealth</code>.</li>\n<li>Fix: allow <code>disconnect</code> listeners to fire before closing.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.53.0...v1.54.0\">v1.54.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Move to using <code>mocha</code> for better esm support.</li>\n<li>Drop puppeteer <code>13.6.0</code> in favor of <code>14.4.1</code>.</li>\n<li>Utilize puppeteer <code>14.4.1</code> for <code>chrome-stable</code>.</li>\n<li>New internal <code>getCDPClient</code> for loading a page&#39;s CPD connection.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.52.1...v1.53.0\">v1.53.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Bump <code>browserless:base</code> to <code>1.16.0</code>.</li>\n<li>Drop <code>--quiet</code> from deploy scripts.</li>\n<li><code>arm64</code> support for latest as well as puppeteer at versions 9,10 and 13.</li>\n<li>Update puppeteer 13 from <code>13.5.2</code> to <code>13.6.0</code> (revision <code>982053</code>).</li>\n<li>README updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.52.0...v1.52.1\">v1.52.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Playwright example correction in README.md.</li>\n<li>Use revision <code>970485</code> for puppeteer 13.x.x, <code>latest</code>, chrome-stable and <code>arm64</code>.</li>\n<li>When using <code>KEEPALIVE</code> and <code>PREBOOT</code>, don&#39;t create new blank pages, and use the existing one instead.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.51.1...v1.52.0\">v1.52.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Added in new fonts: <code>fonts-gfs-neohellenic</code>.</li>\n<li>Minor code formatting changes.</li>\n<li>Drop <a href=\"mailto:puppeteer@13.1.3\">puppeteer@13.1.3</a> in favor of 13.5.2.</li>\n<li>Make <code>heapdump</code> an optional dependency as it&#39;s not always used, and add it back in.</li>\n<li>Utilize <code>fs/promise</code> vs home-rolled promisified utils.</li>\n<li>Fix an issue where PREBOOT and KEEPALIVE might return an <code>undefined</code> browser.</li>\n<li>Logging when file-protocol requests happen and terminate a session.</li>\n<li>Move the browser process exit listener into the puppeteer-provider for better session cleanup.</li>\n<li>Allow &quot;headfull&quot; playwright sessions.</li>\n<li>Don&#39;t <code>await</code> chrome-helper&#39;s closing of the browser as it&#39;s not truly async.</li>\n<li>Remove <code>body-parser</code> in favor of <code>express</code>&#39;s JSON and other parsers.</li>\n<li>Fixes an issue where using a user-data-dir that doesn&#39;t exist causes chrome to crash.</li>\n<li>Add in more unit and integration tests.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.51.1...v1.52.0\">v1.52.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Added in new fonts: <code>fonts-gfs-neohellenic</code>.</li>\n<li>Minor code formatting changes.</li>\n<li>Drop <a href=\"mailto:puppeteer@13.1.3\">puppeteer@13.1.3</a> in favor of 13.5.2.</li>\n<li>Make <code>heapdump</code> an optional dependency as it&#39;s not always used, and add it back in.</li>\n<li>Utilize <code>fs/promise</code> vs home-rolled promisified utils.</li>\n<li>Fix an issue where PREBOOT and KEEPALIVE might return an <code>undefined</code> browser.</li>\n<li>Logging when file-protocol requests happen and terminate a session.</li>\n<li>Move the browser process exit listener into the puppeteer-provider for better session cleanup.</li>\n<li>Allow &quot;headfull&quot; playwright sessions.</li>\n<li>Don&#39;t <code>await</code> chrome-helper&#39;s closing of the browser as it&#39;s not truly async.</li>\n<li>Remove <code>body-parser</code> in favor of <code>express</code>&#39;s JSON and other parsers.</li>\n<li>Fixes an issue where using a user-data-dir that doesn&#39;t exist causes chrome to crash.</li>\n<li>Add in more unit and integration tests.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.51.0...v1.51.1\">v1.51.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Updates the <code>vm2</code> module to <code>3.9.7</code>.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.50.0...v1.51.0\">v1.51.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New <code>viewport</code> option inside of the content API.</li>\n<li>New <code>encoding</code> option in the screenshot API.</li>\n<li>Drop <a href=\"mailto:puppeteer@12.x.x\">puppeteer@12.x.x</a> in favor of 13.x.x.</li>\n<li>Fixes in our deploy scripts.</li>\n<li>Fixes for windows binaries in our postinstall hook.</li>\n<li>Fixes an issue where playwright tries to use a pre-booted chrome instance.</li>\n<li>Small type updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.49.1...v1.50.0\">v1.50.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Drops support for <code>puppeteer-4.0.1</code> in favor of <code>puppeteer-12.0.1</code>.</li>\n<li>Chrome-stable now utilizes puppeteer @ <code>12.0.1</code>.</li>\n<li>Support for <code>arm64</code> via production tags (<code>1-arm64</code>) as well as in <code>latest</code>.</li>\n<li>Static JSON files (<code>protocol.json</code>, <code>version.json</code>) are built at runtime on their first request and then cached in memory.</li>\n<li>Bumps <code>browserless/base</code> to <code>1.14.0</code>.</li>\n<li>New <code>selector</code> property for screenshot-ing a single DOM node in the screenshot API.</li>\n<li><code>puppeteerVersions</code> in the package.json file has been rename do <code>chromeVersions</code>.</li>\n<li>Internal changes for deploying production tag scripts.</li>\n<li>Consolidate scripts for <code>postinstall</code>.</li>\n<li>Drop support for <code>heapdump</code> due to its age and lack of platform varieties.</li>\n<li>New <code>/metrics/total</code> route for summing up all statistics in a single JSON payload.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.49.0...v1.49.1\">v1.49.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fix webhook not using timeout URL.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.48.0...v1.49.0\">v1.49.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Support for ARM64 builds by dropping flash for it.</li>\n<li>Bump puppeteer 10.2.0 for 10.4.0.</li>\n<li>New puppeteer-hook for injecting a puppeteer-compatible library, eg. puppeteer-extra.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.47.0...v1.48.0\">v1.48.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li>API calls with <code>html</code> in their payloads now use the <code>page.setContent</code> API versus a prior hack using one-time network-request interception (<a href=\"https://github.com/browserless/chrome/compare/v1.47.0...master#diff-67b699af1b24472604e21081d0509620d4ab3d986fcd4f8aa0b04d5ee5e4c63fL88\">example here</a>). Old versions of puppeteer might not work properly with this (&lt;= 5.x.x). This effects the following APIS: <code>/content</code>, <code>/pdf</code> and <code>/screenshot</code>.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency updates.</li>\n<li>Bump <code>browserless/base</code> to <code>1.12.0</code> (add user-id to <code>blessuser</code> of <code>BLESS_USER_ID=999</code>).</li>\n<li>Bumps puppeteer @10.x.x to <code>10.2.0</code> with revision <code>901912</code>.</li>\n<li>Makes API calls use <code>setContent</code> properly now (no more one-time network interception). This fixes certain issues with images not loading in PDFs and screenshots.</li>\n<li>Fix some typings in tests.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.46.0...v1.47.0\">v1.47.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Bump <code>browserless/base</code> to <code>1.11.0</code>.</li>\n<li>Add new lint task and rename GitHub actions tasks, remove <code>tslint</code>.</li>\n<li>Lint and prettier fixes.</li>\n<li>Delay url parsing until after <code>before</code> hook runs.</li>\n<li>New <code>meta</code> object param for page hooks (passing through arbitrary meta data set by prior hooks).</li>\n<li>New <code>FUNCTION_ENV_VARS</code> environment variable pass through an allow-list of environment variables for functions to access.</li>\n<li>Fix <code>someObject.hasOwnProperty</code> to <code>Object.prototype.hasOwnProperty.call</code>.</li>\n<li></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.45.0...v1.46.0\">v1.46.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Move to Node 16.x.x.</li>\n<li>Bump browserless/base to 1.10.0.</li>\n<li>Limit <code>x-response-url</code> to 100 characters.</li>\n<li>Add support for <a href=\"mailto:puppeteer@10.x.x\">puppeteer@10.x.x</a>.</li>\n<li>Add <code>maxConcurrent</code> stat for metrics API + log stats every 5 minutes to stdout.</li>\n<li>Some performance improvements to how pages/browsers are setup and torn down.</li>\n<li>Add <code>API_DOCS_ENDPOINT</code> as a filterable API to deny access to.</li>\n<li>Minor code reformatting from prettier.</li>\n<li>Better page setup and logging.</li>\n<li>Fixes <code>DEFAULT_STEALTH</code> for self-hosted deployments.</li>\n<li>Improvements on how chrome is closed.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.44.0...v1.45.0\">1.45.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Support for <a href=\"https://github.com/browserless/chrome/commit/0903795e936b93a511ec04f7ae35c03397682905\">playwright proxies</a>.</li>\n<li>Fixes an issue with larger headers potentially causing load-balancers to crash and fail.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.43.0...v1.44.0\">v1.44.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li><code>PROXY_HOST</code> and <code>PROXY_PORT</code> are now replaced with a single <code>PROXY_URL</code> param, eg: <code>https://www.mybrowserless.com/optional/paths</code>. When set, browserless uses this fully-qualified URL to build out links <em>back</em> to its internal debugger and sessions. Useful when you&#39;re instance is behind a proxy or load-balancer of some kind.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency Updates.</li>\n<li>Use recent Node 14 (browserless-base 1.7.0).</li>\n<li>New <code>rejectResourceTypes</code> property on most APIs (content, screenshot, pdf, etc.).</li>\n<li>Allow serving of <code>file://</code> protocols when explicitly enabled (default is off due to security concerns). Set <code>ALLOW_FILE_PROTOCOL=true</code> in your env params.</li>\n<li>The <code>/pressure</code> API now takes into account CPU/Memory consumption, and adds a &quot;reason&quot; property for why the machine might be not available.</li>\n<li>Fixes an issue where playwright couldn&#39;t download files.</li>\n<li>You can now filter /sessions calls with a <code>trackingId</code> parameter.</li>\n<li><code>detached</code> functions now return a <code>trackingId</code> when present.</li>\n<li>More types, tests, and utility consolidation.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.42.0...v1.43.0\">v1.43.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Fixes an issue where --user-data-dirs aren&#39;t deleted properly, potentially filling disks.</li>\n<li>Changes CPU/Memory checks to be user-based and not the entire OS.</li>\n<li>Adds tests for the user-data-dir issue.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.41.0...v1.42.0\">v1.42.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Move to Node 14!</li>\n<li>Use <code>esModuleInterop</code> for imports.</li>\n<li>Remove <code>page.waitFor</code> in favor of downstream methods.</li>\n<li>Adds new <code>?stealth</code> parameter for API calls (see puppeteer-extra-stealth-plugin).</li>\n<li>New <code>DEFAULT_STEALTH</code> param for making stealth calls by default.</li>\n<li>Fixes <code>ignoreDefaultArgs</code> in chrome stable.</li>\n<li>Ensure temp user-data-dirs are always cleaned up.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.40.2...v1.41.0\">v1.41.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>New <code>SESSION_CHECK_FAIL_URL</code> webhook for when pre-session checks fail.</li>\n<li>Health checks now take the last two CPU/Memory samples to determine if a failure (5 minutes).</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.40.1...v1.40.2\">v1.40.2</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Fix potentially unhandled stream error events when closing chrome.</li>\n<li>Bump puppeteer to 5.4.1 for major 5.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.40.0...v1.40.1\">v1.40.1</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>New <code>SOCKET_CLOSE_METHOD</code> for better load-balancing behavior when under load.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.39.0...v1.40.0\">v1.40.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Support for playwright 1.4.0 and greater. <a href=\"https://github.com/microsoft/playwright/issues/4054\">See more here</a>.</li>\n<li>New <code>PRE_REQUEST_HEALTH_CHECK</code> env variable to check CPU/Memory prior to running a session. Set <code>MAX_CPU_PERCENT</code> or <code>MAX_MEMORY_PERCENT</code> for setting these thresholds. Responds with a <code>503</code> HTTP code if CPU/Memory are high on any inbound session (API, puppeteer or webdriver).</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.38.0...v1.39.0\">v1.39.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Fixes a crash due to <code>browser.close</code> streams not completing properly.</li>\n<li>Adds a <code>dumpio</code> query-string parameter for launching with puppeteer.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.37.2...v1.38.0\">v1.38.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Fixes a memory leak when browsers don&#39;t close properly.</li>\n<li>Adds a <code>/heapdump</code> route for capturing heap dumps. Turn on by setting <code>ENABLE_HEAP_DUMP=true</code> in your docker env.</li>\n<li><code>emulateMedia</code> fixes on the pdf route.</li>\n<li>CodeQL implemented.</li>\n<li>README fixes.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.37.1...v1.37.2\">v1.37.2</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Fixes an issue where the webserver can crash after rejecting a request.</li>\n<li>Fixes deployment script not waiting for zip files to be finished unzipped.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.37.0...v1.37.1\">1.37.1</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Fixes an issue in webdriver not starting properly.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.36.0...v1.37.0\">1.37.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li>Due to stability issues, puppeteer version 3.x.x and 4.x.x now use chromium revision <code>782078</code>. See our <code>package.json</code> for details.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency Updates</li>\n<li>README Updates</li>\n<li>Fixes an issue for secured containers using prometheus (plus tests).</li>\n<li>Support for puppeteer <code>5.2.1</code></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.35.0...v1.36.0\">1.36.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>Drops support for puppeteer <code>2.0.0</code> and <code>3.0.4</code>, please use <code>2.1.1</code> and <code>3.3.0</code> for those revisions.</li>\n<li>Adds support for puppeteer <code>5.0.0</code>.</li>\n<li>Bug-fix with the server randomly closing with an uncaught error event thrown from inside underlying socket connection.</li>\n<li>Adds back in <code>--disable-dev-shm-usage</code> to default arguments for better SHM performance.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.34.0...v1.35.0\">1.35.0</a></h1>\n<ul>\n<li>Dependency Updates</li>\n<li>New <code>maxTime</code>, <code>minTime</code>, <code>meanTime</code> and <code>totalTime</code> of all sessions for a given period in /stats.</li>\n<li>Bugfix on CPU/Memory triggering health failure webhooks.</li>\n<li>Fix issues in websocket errors by awaiting browser.close (or 5 seconds, whichever is quickest).</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.33.1...v1.34.0\">v1.34.0</a></h1>\n<p><strong>Potentially Breaking</strong></p>\n<ul>\n<li>screencast API no longer supports <code>audio</code> or the <code>setPreferences</code> function in order to offer a better video experience. In order to set the width/height, simply set a page width height to what you&#39;d like.</li>\n<li><code>chrome-stable</code> will now use <code>puppeteer@3.1.0</code> for better compatibility.</li>\n</ul>\n<hr>\n<ul>\n<li>Dependency updates.</li>\n<li>Drops puppeteer version <code>1.20.0</code> and below.</li>\n<li>Move <code>browserless/base</code> to <code>v1.5.0</code>.</li>\n<li>Puppeteer support for <code>3.3.0</code> (3.2.x and 3.1.x have the same chromium revision).</li>\n<li>Fixes <code>trackingId</code> on pre-booted sessions.</li>\n<li><code>about:blank</code> pages now are returned in the <code>/sessions</code> API for transparency of open sessions/browsers.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.33.0...v1.33.1\">1.33.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fix socket errors from accidentally firing error webhooks.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.32.0...v1.33.0\">1.33.0</a></h1>\n<ul>\n<li>Drops support for puppeteer 1.17.x and 1.18.x</li>\n<li>Support for puppeteer 3.0.x</li>\n<li>Dependency updates</li>\n<li>Fix reject stat firing on debugger pages not being found</li>\n<li>Consolidates more types.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.31.1...v1.32.0\">1.32.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Adds roboto fonts.</li>\n<li>Updates <code>pressure</code> API to take account of running browsers in the <code>running</code> count.</li>\n<li>Adds <code>maxConcurrent</code>, <code>maxQueued</code>, <code>cpu</code> and <code>memory</code> to pressure.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.31.0...v1.31.1\">1.31.1</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Fixes a small issue where XVFB doesn&#39;t start properly during an automated restart.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.30.0...v1.31.0\">1.31.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Allows <code>trackingId</code> on uploaded files to save in the appropriate tracking-ID folder.</li>\n<li>New <code>userAgent</code> param for setting user-agent in API requests.</li>\n<li>Fixes an issue where chrome wasn&#39;t being closed in rare cases.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.29.1...v1.30.0\">1.30.0</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Updates to Node 13 for speed and memory improvements.</li>\n<li>browserless/<a href=\"mailto:base@1.4.0\">base@1.4.0</a></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.29.0...v1.29.1\">1.29.1</a></h1>\n<ul>\n<li>Dependency Updates.</li>\n<li>Fixes how deploy script determines errors when running child commands.</li>\n<li>Fixes issues when many selenium sessions can potentially fill up disk space.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.28.0...v1.29.0\">1.29.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Uses <code>pipe</code>&#39;s for most API calls and other internal endpoints for faster/better throughput. Works only for <code>headless</code> API/puppeteer calls.</li>\n<li>Allows custom lighthouse configs via POST <code>config</code> property.</li>\n<li>Patches vm2.</li>\n<li>Before hooks no longer end requests forcefully -- external hooks must manually end the request/sockets themselves.</li>\n<li>Properly passes socket errors to the error handler/webhook</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.27.0...v1.28.0\">1.28.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Sets a system-default font of Ubuntu for most sites that use <code>system-ui</code> in their font declarations.</li>\n<li>Fixes health-check failure webhooks.</li>\n<li>New <code>PROXY_HOST</code>, <code>PROXY_PORT</code> and <code>PROXY_SSL</code> for external load-balancers. <a href=\"https://www.browserless.io/docs/docker.html#using-a-proxy\">See docsite for more info</a>.</li>\n<li>Moves over to GH actions over Travis for CI.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.26.1...v1.27.0\">1.27.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New <code>manipulate</code> params for screenshots, allowing for resizing, flipping and more.</li>\n<li>Better tracking of chrome-process for cleanup of zombied sessions.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.26.0...v1.26.1\">1.26.1</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Added <code>git</code> as a dependency in dockerfile for git-based npm dependencies to work.</li>\n<li>Fixed an issue in <code>start.sh</code> so that errors bubble up properly and close the process.</li>\n<li>Bumps <code>browserless/base</code> to <code>1.2.0</code>.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.25.0...v1.26.0\">1.26.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Dropping pre-push hooks for speed.</li>\n<li>Consolidate all interfaces/types to a types.d.ts file.</li>\n<li>Fixes an issue where numerous chrome instances launch when prebooting.</li>\n<li>Fixes an issue where incoming requests don&#39;t use the pre-booted chrome instance.</li>\n<li>Uses <code>page.setViewport</code> when <code>--window-size</code> is set in params to help with screenshots not appearing properly (chromedriver only).</li>\n<li></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.24.0...v1.25.0\">1.25.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Stricter build-time arguments for chromium and chromedriver assets.</li>\n<li>Better XVFB functionality.</li>\n<li>New parameters for most API&#39;s, <code>addScriptTag</code> and <code>addStyleTag</code>, accepting an array of scripts/styles respectively.</li>\n<li>Drop support for <code>puppeteer@1.17.0</code>.</li>\n<li>Proper support for parsing <code>ignoreDefaultArgs</code> query-parameters.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.23.1...v1.24.0\">1.24.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Bugfix on our debugger&#39;s play button being off-center.</li>\n<li>Fixes driver.close() calls not cleaning the browser.</li>\n<li>New <code>/GET</code> option for most our APIs. Stringify your JSON and add a ?body=YOUR-JSON with a /GET call to most of our functions! Requires <code>ENABLE_API_GET=true</code> in you docker env variables.</li>\n<li>WebSocket (Socket) exception handling and logging.</li>\n<li>More integration and unit tests added.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.23.0...v1.23.1\">1.23.1</a></h1>\n<ul>\n<li>Fixes an issue in chromedriver where commands would hang.</li>\n<li>Fixes an issue in chromedriver sessions not being removed properly.</li>\n<li>Fixes and pins the base image so that headful sessions work again.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.22.0...v1.23.0\">1.23.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Use <code>apt-get</code> to install <code>dumb-init</code>.</li>\n<li>Add a LANG arg in docker.</li>\n<li>New <code>setJavaScriptEnabled</code> property for REST APIs.</li>\n<li>Fixes an issue with <code>waitFor</code> functions in REST API calls.</li>\n<li>Fixes issues when PREBOOT_CHROME and KEEPALIVE are true.</li>\n<li>Updates protocol and host information in ad-blocking.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.21.0...v1.22.0\">1.22.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Removal of unnecessary &#39;--disable-dev-shm-usage&#39;</li>\n<li>Squelching of chromedriver&#39;s verbose args unless <code>DEBUG=*</code> is set.</li>\n<li>New <code>/kill/${id}</code> route for remotely killing a certain browser.</li>\n<li>Allowing of sub-child routes in workspaces.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.20.0...v1.21.0\">1.21.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New <code>viewport</code> property option for PDF endpoint.</li>\n<li>The <code>/stats</code> endpoint now runs in a separate process meaning it can be parallelized.</li>\n<li>Fixed a bug where hardware monitoring can cause the container to restart/crash.</li>\n<li>Fixes an issue with the file-chooser API not working in puppeteer.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.19.0...v1.20.0\">1.20.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>New <code>/scrape</code> API!</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.18.0...v1.19.0\">1.19.0</a></h1>\n<ul>\n<li>Dependency updates.</li>\n<li>Fixes chrome-stable&#39;s binary chromedriver.</li>\n<li>Move over to Node 12.</li>\n<li>Bugfix on width/height in the screencast API.</li>\n<li>Support for <a href=\"mailto:puppeteer@2.0.0\">puppeteer@2.0.0</a>.</li>\n<li>Fixed issues with the devtools JS files missing.</li>\n<li>Adds support for blacklisting routes in Docker.</li>\n<li>Consolidates hooks into a hooks module.</li>\n<li>Allows Selenium to specify download-paths and pausing via preferences.</li>\n<li>Fixes an issue in certain JSON-based CDP libraries.</li>\n<li>Function API&#39;s can now run incognito mode with a new Docker param.</li>\n<li></li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.17.0...v1.18.0\">1.18.0</a></h1>\n<ul>\n<li>Dependency updates</li>\n<li>Better <code>IS_DOCKER</code> check for kubernetes.</li>\n<li>Updates to README.md, spelling fixes and Slack link.</li>\n<li>Fixes to debugger and larger code bodies.</li>\n<li>Removal of analytics in debugger.</li>\n<li>Screencast improvements and adding ability to set new options.</li>\n<li>New <code>waitFor</code> property in our APIs (content, pdf and screenshot).</li>\n<li>Don&#39;t allow file requests on the debugger for security reasons.</li>\n<li>Better metrics monitoring.</li>\n<li><code>singleRun</code> mode in docker.</li>\n<li>New prometheus support!</li>\n<li>Fixing issues with keeping chrome alive (only closing once TTL is met).</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.16.0...v1.17.0\">1.17.0</a></h1>\n<ul>\n<li>Dependency updates</li>\n<li>Splitting docker images into two repositories for faster builds and pulls</li>\n<li>Adding in external routing capabilities</li>\n<li>New error hook</li>\n<li>More/better types</li>\n<li>Updating <code>deviceScaleFactor</code> in API&#39;s for more granular control.</li>\n<li>Better chromedriver failure messages.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.15.0...v1.16.0\">1.16.0</a></h1>\n<ul>\n<li>Adding <code>ffmpeg</code> to the docker dependency list.</li>\n<li>Add <code>timecut</code> as a dependency for recording.</li>\n<li>Better logs on chrome PID&#39;s and closing forcefully.</li>\n<li>Fixed <code>DEFAULT_CHROME</code> =&gt; <code>DEFAULT_HEADLESS</code>.</li>\n<li>Fixed a bug where <code>xvfb</code> doesn&#39;t start in time.</li>\n<li>Use <code>SIGKILL</code> for killing chromedriver.</li>\n<li><code>/json/version</code> now returns a <code>webSocketDebuggerUrl</code>.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.14.1...v1.15.0\">1.15.0</a></h1>\n<ul>\n<li>New <code>page</code> and <code>browser</code> hooks for docker images that <code>FROM</code> browserless.</li>\n<li><code>bluebird</code> added as a module for <code>function</code> and other endpoints.</li>\n<li>More dependency updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.14.0...v1.14.1\">1.14.1</a></h1>\n<ul>\n<li>Bugfix when running multiple &quot;headfull&quot; sessions.</li>\n<li>Dependency updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.13.0...v1.14.0\">1.14.0</a></h1>\n<ul>\n<li>New <code>WORKSPACE_DELETE_EXPIRED</code> and <code>WORKSPACE_EXPIRE_DAYS</code> to auto-cleanup workspace dirs.</li>\n<li>README.md cleanup now that HTTPS is no longer required.</li>\n<li>Support for <code>~</code> in docker env parameters.</li>\n<li>More alignment with how chromedriver and puppeteer sessions get cleaned up.</li>\n<li><code>/session</code> API now returns <code>browserWSEndpoint</code> and <code>browserId</code> properties for having multiple debuggers connected.</li>\n<li>Support for reconnecting(!!). When a <code>?keepalive=KEEP-ALIVE-IN-MS</code> is seen in the <code>puppeteer.connect</code> call we keep the browser active for that many ms after the debugger disconnects.</li>\n<li>New <code>/kill/all</code> route which closes <em>all</em> actively running sessions.</li>\n<li>New internal scheduler module, making future things like cron-based jobs a possibility.</li>\n<li>Better internal types.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.12.0...v1.13.0\">1.13.0</a></h1>\n<ul>\n<li>A minor refactor to consolidate calls to <code>url.parse</code> for performance gains.</li>\n<li>Introduces a per-session based timeout that overrides the global timeout.</li>\n<li>Consolidates authorization checks to remove duplication.</li>\n<li>Moves more types into their backing modules in order to better consolidate files.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.11.0...v1.12.0\">1.12.0</a></h1>\n<ul>\n<li>Set&#39;s a non-conflicting <code>WORKSPACE_DIR</code> and <code>DEFAULT_USER_DATA_DIR</code> in docker by default.</li>\n<li>Drops support for puppeteer <code>1.15.0</code> and adds <code>1.19.0</code>.</li>\n<li>Web-based debugger now sends cookies for docker deployments that are secure.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.10.0...v1.11.0\">1.11.0</a></h1>\n<ul>\n<li>Live debugger is now self-hosted, no more enforced https though it&#39;s still recommended.</li>\n<li>Consolidated build steps.</li>\n<li>Using the same chromedriver binary that matches the puppeteer&#39;s bundled chromium.</li>\n<li>Introducing <code>trackingId</code> workflows.</li>\n<li>Fixing unused export&#39;s, removing extraneous internal methods.</li>\n<li><code>/workspace</code> API now returns sub-files and scopes sessions by <code>trackingId</code> when present.</li>\n<li>Support for <code>/json/new</code> protocol.</li>\n<li>Dependency updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.9.0...v1.10.0\">1.10.0</a></h1>\n<ul>\n<li>Dropped support for puppeteer <code>1.9.0 =&gt; 1.14.0</code>.</li>\n<li>Added support for puppeteer <code>1.16.0 =&gt; 1.18.0</code>.</li>\n<li>A version of chromedriver is now installed to perfectly match the version of puppeteer&#39;s chromium.</li>\n<li>In dev, chromedriver now uses the puppeteer version of chromium.</li>\n<li>Defaulted most ENV-variables in docker to sensible defaults.</li>\n<li>New <code>rotate</code> feature for PDF endpoint: <code>{ rotate: 90 }</code> =&gt; rotate left 90 degrees.</li>\n<li>Support for <code>browserless.token</code> in the docker image.</li>\n<li>puppeteer integration now returns semantic HTTP codes for certain errors (<code>400</code>, <code>403</code> and <code>429</code>).</li>\n<li>Support for chromedriver&#39;s move to the W3C spec &#39;goog:chromeOptions&#39;.</li>\n<li>The debugger now filters out <code>about:blank</code> pages, and includes sessions by Selenium.</li>\n<li>Workspace support for selenium-based integrations.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.8.0...v1.9.0\">1.9.0</a></h1>\n<ul>\n<li>Better handling of browser/socket closing in puppeteer integrations.</li>\n<li>Numerous screencast fixes.</li>\n<li>Moved all GH links to new repo location.</li>\n<li>Dep updates.</li>\n</ul>\n<h1><a href=\"https://github.com/browserless/chrome/compare/v1.7.0...v1.8.0\">1.8.0</a></h1>\n<ul>\n<li>Better windows dev experience.</li>\n<li>Indian font support.</li>\n<li>Video capture now supports audio and browser width/height.</li>\n<li>Dependency updates.</li>\n<li>DEFAULT env variables for launching pre-booted Chrome.</li>\n</ul>\n<h1>1.7.0</h1>\n<ul>\n<li>Dep updates</li>\n<li>New <code>?blockAds</code> query-parameter for disabling 3rd-party ad calls.</li>\n</ul>\n<h1>1.6.0</h1>\n<ul>\n<li>New <code>authenticate</code> and <code>setExtraHTTPHeaders</code> params for the <code>content</code>, <code>pdf</code>, and <code>screenshot</code> APIs. Useful for using proxies in our REST APIs.</li>\n<li>Fixed a bunch of bugs inside of the webdriver integration, making it more REST-ful.</li>\n<li>Updated dependencies inside of Chromedriver.</li>\n<li>New <code>DISABLE_AUTO_SET_DOWNLOAD_BEHAVIOR</code> for mitigating errors in puppeteer &lt; 1.15.0.</li>\n<li>Bumped Puppeteer to 1.15.0.</li>\n</ul>\n<h1>1.5.0</h1>\n<ul>\n<li>New <code>/session</code> API (and accompanying routes) for display/viewing active sesions in a remote debugger(!).</li>\n<li>New <code>?pause</code> query-param for pausing sessions prior to running them (useful for the live debug viewer).</li>\n<li>The browserless debugger now exposes links to these debug pages via the sidebar.</li>\n<li>New Debugger page can be disabled via the <code>ENABLE_DEBUG_VIEWER=false</code> environment variable flag.</li>\n<li>Move to use <code>node@10</code>.</li>\n<li>No more <code>no-implicit-any</code>&#39;s inside the codebase.</li>\n</ul>\n<h1>1.4.0</h1>\n<ul>\n<li>During connection, we now set the download dir of REST and puppeteer sessions. Cloud users and docker users no longer have to manually set this field, and the <code>/workspace</code> API references it as well!</li>\n</ul>\n<h1>1.3.1</h1>\n<h1>Fixes</h1>\n<ul>\n<li>New deploy.js file to do deployments &quot;on-prem&quot;</li>\n<li>Updated new builds for puppeteer 1.12.2 and 1.13.0</li>\n<li>Fixes an issues in CORS handling</li>\n</ul>\n<h1>1.3.0</h1>\n<h1>Minor changes</h1>\n<ul>\n<li>The <code>screenshot</code>, <code>function</code>, <code>pdf</code>, and <code>content</code> API&#39;s now accept new content-types for easier POSTing of small payloads (see docsite).</li>\n<li>The <code>screencast</code> API can now start/stop recording programmatically via a <code>startScreencast</code> and <code>stopScreencast</code> params (see docsite).</li>\n<li>New <code>external</code> dir for injecting custom <code>before</code> and <code>after</code> hooks in external docker builds.</li>\n<li>A new <code>timeout</code> query-option for session-based timeouts vs using the global one.</li>\n<li>New <code>requestInterceptors</code> for injection custom request behavior.</li>\n</ul>\n<h1>Fixes</h1>\n<ul>\n<li>Numerous default fixes in the APIs.</li>\n<li>Stray consoles removed :)</li>\n<li>Consolidated download behavior in <code>screencast</code> and <code>download</code> APIs</li>\n</ul>\n<h1>1.2.0</h1>\n<h1>Minor Changes</h1>\n<ul>\n<li>New <code>requestInterceptors</code> for the /screenshot API, <a href=\"https://github.com/browserless/chrome/pull/119\">allowing you to mock data in response to a request</a>.</li>\n<li>Code debugger now transmits code over-the-wire via cookies to avoid URL max-length issues.</li>\n<li>Now supports cookie-based authentication via a <code>browserless_token=TOKEN;</code> cookie.</li>\n</ul>\n<h1>Fixes</h1>\n<ul>\n<li><a href=\"https://github.com/browserless/chrome/issues/118\">Comments in the debugger won&#39;t break it.</a></li>\n<li>Requests that are rejected due to auth reasons aren&#39;t logged in stats.</li>\n</ul>\n<h1>1.1.0</h1>\n<p>With 1.1.0 we offer a refined way of dealing with both downloads and uploads. Both use-cases are tightly coupled to the file-system, and can leave you scratching your head as to what&#39;s going one. For more information and detailed documentation, please refer to our doc-site at <a href=\"https://www.browserless.io/\">https://www.browserless.io/</a></p>\n<h2>Minor Changes</h2>\n<ul>\n<li>New <code>WORKSPACE_DIR</code> variable for controlling where browserless stores files and uploads.</li>\n<li>New <code>/workspace</code> API for doing RESTful operations on the downloads/uploads file-system.</li>\n<li>New <code>/download</code> API for running a puppeteer-script, and responding with the resulting downloaded file.</li>\n</ul>\n<h2>Internal Changes</h2>\n<ul>\n<li>Moved routes out of the browserless module and into their own file/module.</li>\n<li>Renamed the <code>browserless-web-service</code> module to just <code>browserless</code> for simplicity.</li>\n<li>Moved the <code>DOWNLOAD_DIR</code> to <code>WORKSPACE_DIR</code> since it handles both uploads and downloads.</li>\n</ul>\n<h1>1.0.0</h1>\n<p>🥁 -- Stable version 1.0 is here! While this doesn&#39;t include major functionality changes, it <em>does</em> change how the docker builds are generated going forward. The versioning will now contain two pieces of crucial information: the version of the <em>browserless</em> service + the version of Chrome under-the-hood. For instance <code>1.2.3-puppeteer-1.10.0</code> is browserless at <code>1.2.3</code>, exposing puppeteer at <code>1.10.0</code>.</p>\n<p>Similar to how NodeJS itself does docker releases, we&#39;ll now provide releases in 3 distinct ways:</p>\n<ul>\n<li>An <em>immutable</em>, pinned version release: <code>1.0.0-puppeteer-1.11.0</code></li>\n<li>A mutable minor version release: <code>1.1-puppeteer-1.12.0</code></li>\n<li>A mutable major version release: <code>1-puppeteer-1.9.0</code></li>\n</ul>\n<p>For production deployments, we recommend using <em>pinned</em> version releases as they won&#39;t change once released. The mutable minor/major releases will receive on-going updates whenever we do changes that are bug-fixes or feature release. Even with the best intentions it&#39;s possible that instability can be introduced with these mutable images, hence why recommend the pinned version releases.</p>\n<p>Finally, we&#39;ll continue to ship support for the last 5 minor versions of Puppeteer + the Google Chrome (stable). Old images will remain, but newer versions of browserless won&#39;t be included.</p>\n<p>We&#39;ll continue to keep this changelog up-to-date anytime we do docker releases.</p>\n",
     "title": "Browserless",
-    "version": "2.2.0-beta-8",
+    "version": "2.2.0",
     "x-logo": {
       "altText": "browserless logo",
       "url": "./docs/browserless-logo-inline.svg"
@@ -1097,7 +1107,7 @@
   },
   "openapi": "3.0.0",
   "paths": {
-    "/content": {
+    "/chrome/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.",
@@ -1370,13 +1380,13 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/content",
+        "summary": "/chrome/content",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/download": {
+    "/chrome/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.",
@@ -1486,13 +1496,13 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/download",
+        "summary": "/chrome/download",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/function": {
+    "/chrome/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.",
@@ -1602,7 +1612,7 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/function",
+        "summary": "/chrome/function",
         "tags": [
           "Browser REST APIs"
         ]
@@ -1611,7 +1621,7 @@
     "/json/list": {
       "get": {
         "definitions": {},
-        "description": "Returns a JSON payload that acts as a pass-through to the DevTools /json/list HTTP API in Chromium.\nBrowserless mocks this payload so that remote clients can connect to the underlying \"webSocketDebuggerUrl\"\nwhich will cause Browserless to start the browser and proxy that request into a blank page.",
+        "description": "Returns a JSON payload that acts as a pass-through to the DevTools /json/list HTTP API in Chromium and Chrome.\nBrowserless crafts this payload so that remote clients can connect to the underlying \"webSocketDebuggerUrl\"\nproperly, excluding any API tokens in that URL. If under authentication be sure to include your authorization.",
         "parameters": [],
         "requestBody": {
           "content": {}
@@ -1706,7 +1716,9 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/json/list",
+        "summary": [
+          "/json/list"
+        ],
         "tags": [
           "Browser REST APIs"
         ]
@@ -1715,7 +1727,7 @@
     "/json/new": {
       "put": {
         "definitions": {},
-        "description": "Returns a JSON payload that acts as a pass-through to the DevTools /json/list HTTP API in Chromium.\nBrowserless mocks this payload so that remote clients can connect to the underlying \"webSocketDebuggerUrl\"\nwhich will cause Browserless to start the browser and proxy that request into a blank page.",
+        "description": "Returns a JSON payload that acts as a pass-through to the DevTools /json/new HTTP API in Chromium.\nBrowserless mocks this payload so that remote clients can connect to the underlying \"webSocketDebuggerUrl\"\nwhich will cause Browserless to start the browser and proxy that request into a blank page.",
         "parameters": [],
         "requestBody": {
           "content": {}
@@ -1802,7 +1814,9 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/json/new",
+        "summary": [
+          "/json/new"
+        ],
         "tags": [
           "Browser REST APIs"
         ]
@@ -1811,7 +1825,7 @@
     "/json/protocol": {
       "get": {
         "definitions": {},
-        "description": "Returns Protocol JSON meta-data that Chrome comes with.",
+        "description": "Returns Protocol JSON meta-data that Chrome and Chromium come with.",
         "parameters": [],
         "requestBody": {
           "content": {}
@@ -1860,7 +1874,9 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/json/protocol",
+        "summary": [
+          "/json/protocol"
+        ],
         "tags": [
           "Browser REST APIs"
         ]
@@ -1869,7 +1885,7 @@
     "/json/version": {
       "get": {
         "definitions": {},
-        "description": "Returns a JSON payload that acts as a pass-through to the DevTools /json/version protocol in Chrome.",
+        "description": "Returns a JSON payload that acts as a pass-through to the DevTools /json/version protocol in Chrome and Chromium.",
         "parameters": [],
         "requestBody": {
           "content": {}
@@ -1881,36 +1897,43 @@
                 "schema": {
                   "type": "object",
                   "properties": {
-                    "Browser": {
+                    "description": {
+                      "description": "The description of the target. Generally the page's title.",
                       "type": "string"
                     },
-                    "Debugger-Version": {
+                    "devtoolsFrontendUrl": {
+                      "description": "The fully-qualified URL of the Devtools inspector app.",
                       "type": "string"
                     },
-                    "Protocol-Version": {
+                    "id": {
+                      "description": "A Unique Id for the underlying target.",
                       "type": "string"
                     },
-                    "User-Agent": {
+                    "title": {
+                      "description": "The title of the target. For pages this is the page's title.",
                       "type": "string"
                     },
-                    "V8-Version": {
+                    "type": {
+                      "description": "The type of target, generally \"page\" or \"background_page\".",
                       "type": "string"
                     },
-                    "WebKit-Version": {
+                    "url": {
+                      "description": "The current URL the target is consuming or visiting.",
                       "type": "string"
                     },
                     "webSocketDebuggerUrl": {
+                      "description": "The target or page's WebSocket Debugger URL. Primarily used for legacy\nlibraries to connect and inspect or remote automate this target.",
                       "type": "string"
                     }
                   },
                   "additionalProperties": false,
                   "required": [
-                    "Browser",
-                    "Debugger-Version",
-                    "Protocol-Version",
-                    "User-Agent",
-                    "V8-Version",
-                    "WebKit-Version",
+                    "description",
+                    "devtoolsFrontendUrl",
+                    "id",
+                    "title",
+                    "type",
+                    "url",
                     "webSocketDebuggerUrl"
                   ],
                   "$schema": "http://json-schema.org/draft-07/schema#"
@@ -1949,13 +1972,15 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/json/version",
+        "summary": [
+          "/json/version"
+        ],
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/pdf": {
+    "/chrome/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.",
@@ -2234,13 +2259,13 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/pdf",
+        "summary": "/chrome/pdf",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/performance": {
+    "/chrome/performance": {
       "post": {
         "definitions": {},
         "description": "Run lighthouse performance audits with a supplied \"url\" in your JSON payload.",
@@ -2366,13 +2391,13 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/performance",
+        "summary": "/chrome/performance",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/scrape": {
+    "/chrome/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.",
@@ -2957,13 +2982,13 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/scrape",
+        "summary": "/chrome/scrape",
         "tags": [
           "Browser REST APIs"
         ]
       }
     },
-    "/screenshot": {
+    "/chrome/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.",
@@ -3253,7 +3278,7 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/screenshot",
+        "summary": "/chrome/screenshot",
         "tags": [
           "Browser REST APIs"
         ]
@@ -3262,7 +3287,7 @@
     "/devtools/browser/*": {
       "get": {
         "definitions": {},
-        "description": "Connect to an already-running Chromium with a library like puppeteer, or others, that work over chrome-devtools-protocol.",
+        "description": "Connect to an already-running Chromium process with a library like\npuppeteer, or others, that work over chrome-devtools-protocol. Chromium\nmust already be launched in order to not return a 404.",
         "parameters": [
           {
             "in": "query",
@@ -3350,13 +3375,15 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/devtools/browser/*",
+        "summary": [
+          "/devtools/browser/*"
+        ],
         "tags": [
           "Browser WebSocket APIs"
         ]
       }
     },
-    "?(/)": {
+    "/chrome": {
       "get": {
         "definitions": {},
         "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
@@ -3447,7 +3474,7 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "?(/)",
+        "summary": "/chrome",
         "tags": [
           "Browser WebSocket APIs"
         ]
@@ -3456,7 +3483,7 @@
     "/devtools/page/*": {
       "get": {
         "definitions": {},
-        "description": "Connect to Chromium with a library like chrome-remote-interface or others that work over JSON chrome-devtools-protocol.",
+        "description": "Connect to an existing page in Chromium with a library like\nchrome-remote-interface or others that work the page websocketDebugger\nURL. You can get this unique URL by calling the /json/list API\nor by finding the page's unique ID from your library of choice.",
         "parameters": [
           {
             "in": "query",
@@ -3544,13 +3571,15 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/devtools/page/*",
+        "summary": [
+          "/devtools/page/*"
+        ],
         "tags": [
           "Browser WebSocket APIs"
         ]
       }
     },
-    "/playwright/chromium": {
+    "/chrome/playwright": {
       "get": {
         "definitions": {},
         "description": "Connect to Chromium with any playwright style library.",
@@ -3641,16 +3670,16 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/playwright/chromium",
+        "summary": "/chrome/playwright",
         "tags": [
           "Browser WebSocket APIs"
         ]
       }
     },
-    "/playwright/firefox": {
-      "get": {
+    "/content /chromium/content": {
+      "post": {
         "definitions": {},
-        "description": "Connect to Firefox with any playwright-compliant library.",
+        "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.",
         "parameters": [
           {
             "in": "query",
@@ -3664,10 +3693,9 @@
             "in": "query",
             "name": "launch",
             "schema": {
-              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
               "anyOf": [
                 {
-                  "$ref": "#/definitions/BrowserServerOptions"
+                  "$ref": "#/definitions/CDPLaunchOptions"
                 },
                 {
                   "type": "string"
@@ -3701,11 +3729,194 @@
           }
         ],
         "requestBody": {
-          "content": {}
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "addScriptTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddScriptTagOptions"
+                    }
+                  },
+                  "addStyleTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddStyleTagOptions"
+                    }
+                  },
+                  "authenticate": {
+                    "$ref": "#/definitions/Credentials"
+                  },
+                  "bestAttempt": {
+                    "description": "When bestAttempt is set to true, browserless attempt to proceed\nwhen \"awaited\" events fail or timeout. This includes things like\ngoto, waitForSelector, and more.",
+                    "type": "boolean"
+                  },
+                  "cookies": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/CookieParam"
+                    }
+                  },
+                  "emulateMediaType": {
+                    "type": "string"
+                  },
+                  "gotoOptions": {
+                    "$ref": "#/definitions/GoToOptions"
+                  },
+                  "html": {
+                    "type": "string"
+                  },
+                  "rejectRequestPattern": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "rejectResourceTypes": {
+                    "type": "array",
+                    "items": {
+                      "enum": [
+                        "cspviolationreport",
+                        "document",
+                        "eventsource",
+                        "fetch",
+                        "font",
+                        "image",
+                        "manifest",
+                        "media",
+                        "other",
+                        "ping",
+                        "prefetch",
+                        "preflight",
+                        "script",
+                        "signedexchange",
+                        "stylesheet",
+                        "texttrack",
+                        "websocket",
+                        "xhr"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "requestInterceptors": {
+                    "type": "array",
+                    "items": {
+                      "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                      "type": "object",
+                      "properties": {
+                        "pattern": {
+                          "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                          "type": "string"
+                        },
+                        "response": {
+                          "$ref": "#/definitions/Partial<ResponseForRequest>"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "pattern",
+                        "response"
+                      ]
+                    }
+                  },
+                  "setExtraHTTPHeaders": {
+                    "$ref": "#/definitions/Record<string,string>"
+                  },
+                  "setJavaScriptEnabled": {
+                    "description": "Whether or not to allow JavaScript to run on the page.",
+                    "type": "boolean"
+                  },
+                  "url": {
+                    "type": "string"
+                  },
+                  "userAgent": {
+                    "type": "string"
+                  },
+                  "viewport": {
+                    "$ref": "#/definitions/Viewport"
+                  },
+                  "waitForEvent": {
+                    "type": "object",
+                    "properties": {
+                      "event": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "event"
+                    ]
+                  },
+                  "waitForFunction": {
+                    "type": "object",
+                    "properties": {
+                      "fn": {
+                        "description": "The function, or statement, to be evaluated in browser context",
+                        "type": "string"
+                      },
+                      "polling": {
+                        "description": "An interval at which the pageFunction is executed, defaults to raf.\nIf polling is a number, then it is treated as an interval in milliseconds\nat which the function would be executed. If polling is a string,\nthen it can be one of the following values: \"raf\" or \"mutation\"",
+                        "type": [
+                          "string",
+                          "number"
+                        ]
+                      },
+                      "timeout": {
+                        "description": "Maximum time to wait for in milliseconds. Defaults to 30000 (30 seconds).\nPass 0 to disable timeout.",
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "fn"
+                    ]
+                  },
+                  "waitForSelector": {
+                    "type": "object",
+                    "properties": {
+                      "hidden": {
+                        "type": "boolean"
+                      },
+                      "selector": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      },
+                      "visible": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "selector"
+                    ]
+                  },
+                  "waitForTimeout": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          }
         },
         "responses": {
-          "101": {
-            "description": "Indicates successful WebSocket upgrade."
+          "200": {
+            "content": {
+              "text/html": {
+                "schema": {
+                  "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution.",
+                  "type": "string",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "An HTML payload of the website or HTML after JavaScript\nparsing and execution."
           },
           "400": {
             "code": 400,
@@ -3738,128 +3949,2081 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/playwright/firefox",
+        "summary": "/content /chromium/content",
         "tags": [
-          "Browser WebSocket APIs"
+          "Browser REST APIs"
         ]
       }
     },
-    "/config": {
-      "get": {
+    "/download /chromium/download": {
+      "post": {
         "definitions": {},
-        "description": "Returns a JSON payload of the current system configuration.",
-        "parameters": [],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "allowCORS": {
-                      "type": "boolean"
-                    },
-                    "allowFileProtocol": {
-                      "type": "boolean"
-                    },
+        "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.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/definitions/JSONSchema"
+              }
+            },
+            "application/javascript": {
+              "schema": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "*/*": {
+                "schema": {
+                  "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API.",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "Responses are determined by the returned value of the downloads\nthemselves, so there isn't a static response type for this API."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/download /chromium/download",
+        "tags": [
+          "Browser REST APIs"
+        ]
+      }
+    },
+    "/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.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/definitions/JSONSchema"
+              }
+            },
+            "application/javascript": {
+              "schema": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "*/*": {
+                "schema": {
+                  "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "Responses are determined by the returned value of the function\nitself. Binary responses (PDF's, screenshots) are returned back\nas binary data, and primitive JavaScript values are returned back\nby type (HTML data is \"text/html\", Objects are \"application/json\")"
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/function /chromium/function",
+        "tags": [
+          "Browser REST APIs"
+        ]
+      }
+    },
+    "/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.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "addScriptTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddScriptTagOptions"
+                    }
+                  },
+                  "addStyleTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddStyleTagOptions"
+                    }
+                  },
+                  "authenticate": {
+                    "$ref": "#/definitions/Credentials"
+                  },
+                  "bestAttempt": {
+                    "description": "When bestAttempt is set to true, browserless attempt to proceed\nwhen \"awaited\" events fail or timeout. This includes things like\ngoto, waitForSelector, and more.",
+                    "type": "boolean"
+                  },
+                  "blockModals": {
+                    "type": "boolean"
+                  },
+                  "cookies": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/CookieParam"
+                    }
+                  },
+                  "emulateMediaType": {
+                    "type": "string"
+                  },
+                  "gotoOptions": {
+                    "$ref": "#/definitions/GoToOptions"
+                  },
+                  "html": {
+                    "type": "string"
+                  },
+                  "options": {
+                    "$ref": "#/definitions/PDFOptions"
+                  },
+                  "rejectRequestPattern": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "rejectResourceTypes": {
+                    "type": "array",
+                    "items": {
+                      "enum": [
+                        "cspviolationreport",
+                        "document",
+                        "eventsource",
+                        "fetch",
+                        "font",
+                        "image",
+                        "manifest",
+                        "media",
+                        "other",
+                        "ping",
+                        "prefetch",
+                        "preflight",
+                        "script",
+                        "signedexchange",
+                        "stylesheet",
+                        "texttrack",
+                        "websocket",
+                        "xhr"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "requestInterceptors": {
+                    "type": "array",
+                    "items": {
+                      "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                      "type": "object",
+                      "properties": {
+                        "pattern": {
+                          "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                          "type": "string"
+                        },
+                        "response": {
+                          "$ref": "#/definitions/Partial<ResponseForRequest>"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "pattern",
+                        "response"
+                      ]
+                    }
+                  },
+                  "setExtraHTTPHeaders": {
+                    "$ref": "#/definitions/Record<string,string>"
+                  },
+                  "setJavaScriptEnabled": {
+                    "type": "boolean"
+                  },
+                  "url": {
+                    "type": "string"
+                  },
+                  "userAgent": {
+                    "type": "string"
+                  },
+                  "viewport": {
+                    "$ref": "#/definitions/Viewport"
+                  },
+                  "waitForEvent": {
+                    "type": "object",
+                    "properties": {
+                      "event": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "event"
+                    ]
+                  },
+                  "waitForFunction": {
+                    "type": "object",
+                    "properties": {
+                      "fn": {
+                        "description": "The function, or statement, to be evaluated in browser context",
+                        "type": "string"
+                      },
+                      "polling": {
+                        "description": "An interval at which the pageFunction is executed, defaults to raf.\nIf polling is a number, then it is treated as an interval in milliseconds\nat which the function would be executed. If polling is a string,\nthen it can be one of the following values: \"raf\" or \"mutation\"",
+                        "type": [
+                          "string",
+                          "number"
+                        ]
+                      },
+                      "timeout": {
+                        "description": "Maximum time to wait for in milliseconds. Defaults to 30000 (30 seconds).\nPass 0 to disable timeout.",
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "fn"
+                    ]
+                  },
+                  "waitForSelector": {
+                    "type": "object",
+                    "properties": {
+                      "hidden": {
+                        "type": "boolean"
+                      },
+                      "selector": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      },
+                      "visible": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "selector"
+                    ]
+                  },
+                  "waitForTimeout": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/pdf": {
+                "schema": {
+                  "description": "Responds with an application/pdf content-type and a binary PDF",
+                  "type": "string",
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "Responds with an application/pdf content-type and a binary PDF"
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/pdf /chromium/pdf",
+        "tags": [
+          "Browser REST APIs"
+        ]
+      }
+    },
+    "/performance /chromium/performance": {
+      "post": {
+        "definitions": {},
+        "description": "Run lighthouse performance audits with a supplied \"url\" in your JSON payload.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "budgets": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {},
+                      "additionalProperties": true
+                    }
+                  },
+                  "config": {
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": true
+                  },
+                  "url": {
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body",
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": true,
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "The response of the lighthouse stats. Response objects are\ndetermined by the type of budgets and config in the POST\nJSON body"
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/performance /chromium/performance",
+        "tags": [
+          "Browser REST APIs"
+        ]
+      }
+    },
+    "/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.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "addScriptTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddScriptTagOptions"
+                    }
+                  },
+                  "addStyleTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddStyleTagOptions"
+                    }
+                  },
+                  "authenticate": {
+                    "$ref": "#/definitions/Credentials"
+                  },
+                  "bestAttempt": {
+                    "description": "When bestAttempt is set to true, browserless attempt to proceed\nwhen \"awaited\" events fail or timeout. This includes things like\ngoto, waitForSelector, and more.",
+                    "type": "boolean"
+                  },
+                  "cookies": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/CookieParam"
+                    }
+                  },
+                  "debugOpts": {
+                    "$ref": "#/definitions/ScrapeDebugOptions"
+                  },
+                  "elements": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/ScrapeElementSelector"
+                    }
+                  },
+                  "emulateMediaType": {
+                    "type": "string"
+                  },
+                  "gotoOptions": {
+                    "$ref": "#/definitions/GoToOptions"
+                  },
+                  "html": {
+                    "type": "string"
+                  },
+                  "rejectRequestPattern": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "rejectResourceTypes": {
+                    "type": "array",
+                    "items": {
+                      "enum": [
+                        "cspviolationreport",
+                        "document",
+                        "eventsource",
+                        "fetch",
+                        "font",
+                        "image",
+                        "manifest",
+                        "media",
+                        "other",
+                        "ping",
+                        "prefetch",
+                        "preflight",
+                        "script",
+                        "signedexchange",
+                        "stylesheet",
+                        "texttrack",
+                        "websocket",
+                        "xhr"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "requestInterceptors": {
+                    "type": "array",
+                    "items": {
+                      "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                      "type": "object",
+                      "properties": {
+                        "pattern": {
+                          "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                          "type": "string"
+                        },
+                        "response": {
+                          "$ref": "#/definitions/Partial<ResponseForRequest>"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "pattern",
+                        "response"
+                      ]
+                    }
+                  },
+                  "setExtraHTTPHeaders": {
+                    "$ref": "#/definitions/Record<string,string>"
+                  },
+                  "setJavaScriptEnabled": {
+                    "type": "boolean"
+                  },
+                  "url": {
+                    "type": "string"
+                  },
+                  "userAgent": {
+                    "type": "string"
+                  },
+                  "viewport": {
+                    "$ref": "#/definitions/Viewport"
+                  },
+                  "waitForEvent": {
+                    "type": "object",
+                    "properties": {
+                      "event": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "event"
+                    ]
+                  },
+                  "waitForFunction": {
+                    "type": "object",
+                    "properties": {
+                      "fn": {
+                        "description": "The function, or statement, to be evaluated in browser context",
+                        "type": "string"
+                      },
+                      "polling": {
+                        "description": "An interval at which the pageFunction is executed, defaults to raf.\nIf polling is a number, then it is treated as an interval in milliseconds\nat which the function would be executed. If polling is a string,\nthen it can be one of the following values: \"raf\" or \"mutation\"",
+                        "type": [
+                          "string",
+                          "number"
+                        ]
+                      },
+                      "timeout": {
+                        "description": "Maximum time to wait for in milliseconds. Defaults to 30000 (30 seconds).\nPass 0 to disable timeout.",
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "fn"
+                    ]
+                  },
+                  "waitForSelector": {
+                    "type": "object",
+                    "properties": {
+                      "hidden": {
+                        "type": "boolean"
+                      },
+                      "selector": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      },
+                      "visible": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "selector"
+                    ]
+                  },
+                  "waitForTimeout": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "description": "The JSON response body",
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "anyOf": [
+                        {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "results": {
+                                "type": "array",
+                                "items": {
+                                  "type": "object",
+                                  "properties": {
+                                    "attributes": {
+                                      "description": "A list of HTML attributes of the element",
+                                      "type": "array",
+                                      "items": {
+                                        "type": "object",
+                                        "properties": {
+                                          "name": {
+                                            "description": "The name of the HTML attribute for the element",
+                                            "type": "string"
+                                          },
+                                          "value": {
+                                            "description": "The value of the HTML attribute for the element",
+                                            "type": "string"
+                                          }
+                                        },
+                                        "additionalProperties": false,
+                                        "required": [
+                                          "name",
+                                          "value"
+                                        ]
+                                      }
+                                    },
+                                    "height": {
+                                      "description": "The height the element",
+                                      "type": "number"
+                                    },
+                                    "html": {
+                                      "description": "The HTML the element",
+                                      "type": "string"
+                                    },
+                                    "left": {
+                                      "description": "The amount of pixels from the left of the page",
+                                      "type": "number"
+                                    },
+                                    "text": {
+                                      "description": "The text the element",
+                                      "type": "string"
+                                    },
+                                    "top": {
+                                      "description": "The amount of pixels from the top of the page",
+                                      "type": "number"
+                                    },
+                                    "width": {
+                                      "description": "The width the element",
+                                      "type": "number"
+                                    }
+                                  },
+                                  "additionalProperties": false,
+                                  "required": [
+                                    "attributes",
+                                    "height",
+                                    "html",
+                                    "left",
+                                    "text",
+                                    "top",
+                                    "width"
+                                  ]
+                                }
+                              },
+                              "selector": {
+                                "description": "The DOM selector of the element",
+                                "type": "string"
+                              }
+                            },
+                            "additionalProperties": false,
+                            "required": [
+                              "results",
+                              "selector"
+                            ]
+                          }
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    },
+                    "debug": {
+                      "description": "When debugOpts options are present, results are here",
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "console": {
+                              "description": "A list of console messages from the browser",
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            "cookies": {
+                              "description": "List of cookies for the site or null",
+                              "anyOf": [
+                                {
+                                  "type": "array",
+                                  "items": {
+                                    "$ref": "#/definitions/Cookie"
+                                  }
+                                },
+                                {
+                                  "type": "null"
+                                }
+                              ]
+                            },
+                            "html": {
+                              "description": "The HTML string of the website or null",
+                              "type": [
+                                "null",
+                                "string"
+                              ]
+                            },
+                            "network": {
+                              "type": "object",
+                              "properties": {
+                                "inbound": {
+                                  "type": "array",
+                                  "items": {
+                                    "$ref": "#/definitions/InBoundRequest"
+                                  }
+                                },
+                                "outbound": {
+                                  "type": "array",
+                                  "items": {
+                                    "$ref": "#/definitions/OutBoundRequest"
+                                  }
+                                }
+                              },
+                              "additionalProperties": false,
+                              "required": [
+                                "inbound",
+                                "outbound"
+                              ]
+                            },
+                            "screenshot": {
+                              "description": "A base64-encoded string of the site or null",
+                              "type": [
+                                "null",
+                                "string"
+                              ]
+                            }
+                          },
+                          "additionalProperties": false,
+                          "required": [
+                            "console",
+                            "cookies",
+                            "html",
+                            "network",
+                            "screenshot"
+                          ]
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ]
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "data",
+                    "debug"
+                  ],
+                  "definitions": {
+                    "Cookie": {
+                      "description": "Represents a cookie object.",
+                      "type": "object",
+                      "properties": {
+                        "name": {
+                          "description": "Cookie name.",
+                          "type": "string"
+                        },
+                        "value": {
+                          "description": "Cookie value.",
+                          "type": "string"
+                        },
+                        "domain": {
+                          "description": "Cookie domain.",
+                          "type": "string"
+                        },
+                        "path": {
+                          "description": "Cookie path.",
+                          "type": "string"
+                        },
+                        "expires": {
+                          "description": "Cookie expiration date as the number of seconds since the UNIX epoch. Set to `-1` for\nsession cookies",
+                          "type": "number"
+                        },
+                        "size": {
+                          "description": "Cookie size.",
+                          "type": "number"
+                        },
+                        "httpOnly": {
+                          "description": "True if cookie is http-only.",
+                          "type": "boolean"
+                        },
+                        "secure": {
+                          "description": "True if cookie is secure.",
+                          "type": "boolean"
+                        },
+                        "session": {
+                          "description": "True in case of session cookie.",
+                          "type": "boolean"
+                        },
+                        "sameSite": {
+                          "description": "Cookie SameSite type.",
+                          "enum": [
+                            "Lax",
+                            "None",
+                            "Strict"
+                          ],
+                          "type": "string"
+                        },
+                        "priority": {
+                          "description": "Cookie Priority. Supported only in Chrome.",
+                          "enum": [
+                            "High",
+                            "Low",
+                            "Medium"
+                          ],
+                          "type": "string"
+                        },
+                        "sameParty": {
+                          "description": "True if cookie is SameParty. Supported only in Chrome.",
+                          "type": "boolean"
+                        },
+                        "sourceScheme": {
+                          "description": "Cookie source scheme type. Supported only in Chrome.",
+                          "enum": [
+                            "NonSecure",
+                            "Secure",
+                            "Unset"
+                          ],
+                          "type": "string"
+                        },
+                        "partitionKey": {
+                          "description": "Cookie partition key. The site of the top-level URL the browser was visiting at the\nstart of the request to the endpoint that set the cookie. Supported only in Chrome.",
+                          "type": "string"
+                        },
+                        "partitionKeyOpaque": {
+                          "description": "True if cookie partition key is opaque. Supported only in Chrome.",
+                          "type": "boolean"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "domain",
+                        "expires",
+                        "httpOnly",
+                        "name",
+                        "path",
+                        "secure",
+                        "session",
+                        "size",
+                        "value"
+                      ]
+                    },
+                    "InBoundRequest": {
+                      "type": "object",
+                      "properties": {
+                        "headers": {},
+                        "status": {
+                          "type": "number"
+                        },
+                        "url": {
+                          "type": "string"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "headers",
+                        "status",
+                        "url"
+                      ]
+                    },
+                    "OutBoundRequest": {
+                      "type": "object",
+                      "properties": {
+                        "headers": {},
+                        "method": {
+                          "type": "string"
+                        },
+                        "url": {
+                          "type": "string"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "headers",
+                        "method",
+                        "url"
+                      ]
+                    }
+                  },
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            },
+            "description": "The JSON response body"
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/scrape /chromium/scrape",
+        "tags": [
+          "Browser REST APIs"
+        ]
+      }
+    },
+    "/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.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "properties": {
+                  "addScriptTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddScriptTagOptions"
+                    }
+                  },
+                  "addStyleTag": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/FrameAddStyleTagOptions"
+                    }
+                  },
+                  "authenticate": {
+                    "$ref": "#/definitions/Credentials"
+                  },
+                  "bestAttempt": {
+                    "description": "When bestAttempt is set to true, browserless attempt to proceed\nwhen \"awaited\" events fail or timeout. This includes things like\ngoto, waitForSelector, and more.",
+                    "type": "boolean"
+                  },
+                  "cookies": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/CookieParam"
+                    }
+                  },
+                  "emulateMediaType": {
+                    "type": "string"
+                  },
+                  "gotoOptions": {
+                    "$ref": "#/definitions/GoToOptions"
+                  },
+                  "html": {
+                    "type": "string"
+                  },
+                  "options": {
+                    "$ref": "#/definitions/ScreenshotOptions"
+                  },
+                  "rejectRequestPattern": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "rejectResourceTypes": {
+                    "type": "array",
+                    "items": {
+                      "enum": [
+                        "cspviolationreport",
+                        "document",
+                        "eventsource",
+                        "fetch",
+                        "font",
+                        "image",
+                        "manifest",
+                        "media",
+                        "other",
+                        "ping",
+                        "prefetch",
+                        "preflight",
+                        "script",
+                        "signedexchange",
+                        "stylesheet",
+                        "texttrack",
+                        "websocket",
+                        "xhr"
+                      ],
+                      "type": "string"
+                    }
+                  },
+                  "requestInterceptors": {
+                    "type": "array",
+                    "items": {
+                      "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                      "type": "object",
+                      "properties": {
+                        "pattern": {
+                          "description": "An array of patterns (using `req.url().match(r.pattern)` to match) and their\ncorresponding responses to use in order to fulfill those requests.",
+                          "type": "string"
+                        },
+                        "response": {
+                          "$ref": "#/definitions/Partial<ResponseForRequest>"
+                        }
+                      },
+                      "additionalProperties": false,
+                      "required": [
+                        "pattern",
+                        "response"
+                      ]
+                    }
+                  },
+                  "scrollPage": {
+                    "type": "boolean"
+                  },
+                  "selector": {
+                    "type": "string"
+                  },
+                  "setExtraHTTPHeaders": {
+                    "$ref": "#/definitions/Record<string,string>"
+                  },
+                  "setJavaScriptEnabled": {
+                    "type": "boolean"
+                  },
+                  "url": {
+                    "type": "string"
+                  },
+                  "userAgent": {
+                    "type": "string"
+                  },
+                  "viewport": {
+                    "$ref": "#/definitions/Viewport"
+                  },
+                  "waitForEvent": {
+                    "type": "object",
+                    "properties": {
+                      "event": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "event"
+                    ]
+                  },
+                  "waitForFunction": {
+                    "type": "object",
+                    "properties": {
+                      "fn": {
+                        "description": "The function, or statement, to be evaluated in browser context",
+                        "type": "string"
+                      },
+                      "polling": {
+                        "description": "An interval at which the pageFunction is executed, defaults to raf.\nIf polling is a number, then it is treated as an interval in milliseconds\nat which the function would be executed. If polling is a string,\nthen it can be one of the following values: \"raf\" or \"mutation\"",
+                        "type": [
+                          "string",
+                          "number"
+                        ]
+                      },
+                      "timeout": {
+                        "description": "Maximum time to wait for in milliseconds. Defaults to 30000 (30 seconds).\nPass 0 to disable timeout.",
+                        "type": "number"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "fn"
+                    ]
+                  },
+                  "waitForSelector": {
+                    "type": "object",
+                    "properties": {
+                      "hidden": {
+                        "type": "boolean"
+                      },
+                      "selector": {
+                        "type": "string"
+                      },
+                      "timeout": {
+                        "type": "number"
+                      },
+                      "visible": {
+                        "type": "boolean"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "selector"
+                    ]
+                  },
+                  "waitForTimeout": {
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "image/png": {
+                "schema": {
+                  "type": "text"
+                }
+              },
+              "image/jpeg": {
+                "schema": {
+                  "type": "text"
+                }
+              },
+              "text/plain": {
+                "schema": {
+                  "type": "text"
+                }
+              }
+            },
+            "description": "Response can either be a text/plain base64 encoded body\nor a binary stream with png/jpeg as a content-type"
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/screenshot /chromium/screenshot",
+        "tags": [
+          "Browser REST APIs"
+        ]
+      }
+    },
+    "?(/) /chromium": {
+      "get": {
+        "definitions": {},
+        "description": "Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/CDPLaunchOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "?(/) /chromium",
+        "tags": [
+          "Browser WebSocket APIs"
+        ]
+      }
+    },
+    "/playwright/chromium /chromium/playwright": {
+      "get": {
+        "definitions": {},
+        "description": "Connect to Chromium with any playwright style library.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/BrowserServerOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/playwright/chromium /chromium/playwright",
+        "tags": [
+          "Browser WebSocket APIs"
+        ]
+      }
+    },
+    "/playwright/firefox /firefox/playwright": {
+      "get": {
+        "definitions": {},
+        "description": "Connect to Firefox with any playwright-compliant library.",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "blockAds",
+            "schema": {
+              "description": "Whether or nor to load ad-blocking extensions for the session.\nThis currently uses uBlock Origin and may cause certain sites\nto not load properly.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "launch",
+            "schema": {
+              "description": "Launch options, which can be either an object\nof puppeteer.launch options or playwright.launchServer\noptions, depending on the API. Must be either JSON\nobject, or a base64-encoded JSON object.",
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/BrowserServerOptions"
+                },
+                {
+                  "type": "string"
+                }
+              ]
+            }
+          },
+          {
+            "in": "query",
+            "name": "record",
+            "schema": {
+              "description": "Whether or nor to record the session. The browser will run\nin \"head-full\" mode, and recording is started and closed\nvia the embedded browserless API. Please refer to the \"Recording\"\nsection in the live documentation site for more details.",
+              "type": "boolean"
+            }
+          },
+          {
+            "in": "query",
+            "name": "timeout",
+            "schema": {
+              "description": "Override the system-level timeout for this request.\nAccepts a value in milliseconds.",
+              "type": "number"
+            }
+          },
+          {
+            "in": "query",
+            "name": "token",
+            "schema": {
+              "description": "The authorization token",
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "101": {
+            "description": "Indicates successful WebSocket upgrade."
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": "/playwright/firefox /firefox/playwright",
+        "tags": [
+          "Browser WebSocket APIs"
+        ]
+      }
+    },
+    "/config": {
+      "get": {
+        "definitions": {},
+        "description": "Returns a JSON payload of the current system configuration.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "allowCORS": {
+                      "type": "boolean"
+                    },
+                    "allowFileProtocol": {
+                      "type": "boolean"
+                    },
                     "allowGetCalls": {
                       "type": "boolean"
                     },
                     "concurrent": {
                       "type": "number"
                     },
-                    "data": {
-                      "type": "string"
-                    },
-                    "debug": {
-                      "type": "string"
-                    },
-                    "errorAlertURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
-                    },
-                    "healthFailureURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
+                    "data": {
+                      "type": "string"
+                    },
+                    "debug": {
+                      "type": "string"
+                    },
+                    "errorAlertURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "healthFailureURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "host": {
+                      "type": "string"
+                    },
+                    "maxCPU": {
+                      "type": "number"
+                    },
+                    "maxMemory": {
+                      "type": "number"
+                    },
+                    "metricsJSONPath": {
+                      "type": "string"
+                    },
+                    "port": {
+                      "type": "number"
+                    },
+                    "queued": {
+                      "type": "number"
+                    },
+                    "queuedAlertURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "rejectAlertURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "retries": {
+                      "type": "number"
+                    },
+                    "timeout": {
+                      "type": "number"
+                    },
+                    "timeoutAlertURL": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    },
+                    "token": {
+                      "type": [
+                        "null",
+                        "string"
+                      ]
+                    }
+                  },
+                  "additionalProperties": false,
+                  "required": [
+                    "allowCORS",
+                    "allowFileProtocol",
+                    "allowGetCalls",
+                    "concurrent",
+                    "data",
+                    "debug",
+                    "errorAlertURL",
+                    "healthFailureURL",
+                    "host",
+                    "maxCPU",
+                    "maxMemory",
+                    "metricsJSONPath",
+                    "port",
+                    "queued",
+                    "queuedAlertURL",
+                    "rejectAlertURL",
+                    "retries",
+                    "timeout",
+                    "timeoutAlertURL",
+                    "token"
+                  ],
+                  "$schema": "http://json-schema.org/draft-07/schema#"
+                }
+              }
+            }
+          },
+          "400": {
+            "code": 400,
+            "description": "The request contains errors or didn't properly encode content.",
+            "message": "HTTP/1.1 400 Bad Request"
+          },
+          "401": {
+            "code": 401,
+            "description": "The request is missing, or contains bad, authorization credentials.",
+            "message": "HTTP/1.1 401 Unauthorized"
+          },
+          "404": {
+            "code": 404,
+            "description": "Resource couldn't be found.",
+            "message": "HTTP/1.1 404 Not Found"
+          },
+          "408": {
+            "code": 408,
+            "description": "The request took has taken too long to process.",
+            "message": "HTTP/1.1 408 Request Timeout"
+          },
+          "429": {
+            "code": 429,
+            "description": "Too many requests are currently being processed.",
+            "message": "HTTP/1.1 429 Too Many Requests"
+          },
+          "500": {
+            "code": 500,
+            "description": "An internal error occurred when handling the request.",
+            "message": "HTTP/1.1 500 Internal Server Error"
+          }
+        },
+        "summary": [
+          "/config"
+        ],
+        "tags": [
+          "Management REST APIs"
+        ]
+      }
+    },
+    "/metrics/total": {
+      "get": {
+        "definitions": {},
+        "description": "Gets total metric details summed from the time the server started.",
+        "parameters": [],
+        "requestBody": {
+          "content": {}
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "number"
+                    },
+                    "estimatedMonthlyUnits": {
+                      "type": "number"
                     },
-                    "host": {
-                      "type": "string"
+                    "maxConcurrent": {
+                      "type": "number"
                     },
-                    "maxCPU": {
+                    "maxTime": {
                       "type": "number"
                     },
-                    "maxMemory": {
+                    "meanTime": {
                       "type": "number"
                     },
-                    "metricsJSONPath": {
-                      "type": "string"
+                    "minTime": {
+                      "type": "number"
                     },
-                    "port": {
+                    "minutesOfMetricsAvailable": {
                       "type": "number"
                     },
                     "queued": {
                       "type": "number"
                     },
-                    "queuedAlertURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
+                    "rejected": {
+                      "type": "number"
                     },
-                    "rejectAlertURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
+                    "sessionTimes": {
+                      "type": "array",
+                      "items": {
+                        "type": "number"
+                      }
                     },
-                    "retries": {
+                    "successful": {
                       "type": "number"
                     },
-                    "timeout": {
+                    "timedout": {
                       "type": "number"
                     },
-                    "timeoutAlertURL": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
+                    "totalTime": {
+                      "type": "number"
                     },
-                    "token": {
-                      "type": [
-                        "null",
-                        "string"
-                      ]
+                    "unhealthy": {
+                      "type": "number"
+                    },
+                    "units": {
+                      "type": "number"
                     }
                   },
                   "additionalProperties": false,
                   "required": [
-                    "allowCORS",
-                    "allowFileProtocol",
-                    "allowGetCalls",
-                    "concurrent",
-                    "data",
-                    "debug",
-                    "errorAlertURL",
-                    "healthFailureURL",
-                    "host",
-                    "maxCPU",
-                    "maxMemory",
-                    "metricsJSONPath",
-                    "port",
+                    "error",
+                    "estimatedMonthlyUnits",
+                    "maxConcurrent",
+                    "maxTime",
+                    "meanTime",
+                    "minTime",
+                    "minutesOfMetricsAvailable",
                     "queued",
-                    "queuedAlertURL",
-                    "rejectAlertURL",
-                    "retries",
-                    "timeout",
-                    "timeoutAlertURL",
-                    "token"
+                    "rejected",
+                    "sessionTimes",
+                    "successful",
+                    "timedout",
+                    "totalTime",
+                    "unhealthy",
+                    "units"
                   ],
                   "$schema": "http://json-schema.org/draft-07/schema#"
                 }
@@ -3897,7 +6061,9 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/config",
+        "summary": [
+          "/metrics/total"
+        ],
         "tags": [
           "Management REST APIs"
         ]
@@ -4043,131 +6209,9 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/metrics",
-        "tags": [
-          "Management REST APIs"
-        ]
-      }
-    },
-    "/metrics/total": {
-      "get": {
-        "definitions": {},
-        "description": "Gets total metric details summed from the time the server started.",
-        "parameters": [],
-        "requestBody": {
-          "content": {}
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "number"
-                    },
-                    "estimatedMonthlyUnits": {
-                      "type": "number"
-                    },
-                    "maxConcurrent": {
-                      "type": "number"
-                    },
-                    "maxTime": {
-                      "type": "number"
-                    },
-                    "meanTime": {
-                      "type": "number"
-                    },
-                    "minTime": {
-                      "type": "number"
-                    },
-                    "minutesOfMetricsAvailable": {
-                      "type": "number"
-                    },
-                    "queued": {
-                      "type": "number"
-                    },
-                    "rejected": {
-                      "type": "number"
-                    },
-                    "sessionTimes": {
-                      "type": "array",
-                      "items": {
-                        "type": "number"
-                      }
-                    },
-                    "successful": {
-                      "type": "number"
-                    },
-                    "timedout": {
-                      "type": "number"
-                    },
-                    "totalTime": {
-                      "type": "number"
-                    },
-                    "unhealthy": {
-                      "type": "number"
-                    },
-                    "units": {
-                      "type": "number"
-                    }
-                  },
-                  "additionalProperties": false,
-                  "required": [
-                    "error",
-                    "estimatedMonthlyUnits",
-                    "maxConcurrent",
-                    "maxTime",
-                    "meanTime",
-                    "minTime",
-                    "minutesOfMetricsAvailable",
-                    "queued",
-                    "rejected",
-                    "sessionTimes",
-                    "successful",
-                    "timedout",
-                    "totalTime",
-                    "unhealthy",
-                    "units"
-                  ],
-                  "$schema": "http://json-schema.org/draft-07/schema#"
-                }
-              }
-            }
-          },
-          "400": {
-            "code": 400,
-            "description": "The request contains errors or didn't properly encode content.",
-            "message": "HTTP/1.1 400 Bad Request"
-          },
-          "401": {
-            "code": 401,
-            "description": "The request is missing, or contains bad, authorization credentials.",
-            "message": "HTTP/1.1 401 Unauthorized"
-          },
-          "404": {
-            "code": 404,
-            "description": "Resource couldn't be found.",
-            "message": "HTTP/1.1 404 Not Found"
-          },
-          "408": {
-            "code": 408,
-            "description": "The request took has taken too long to process.",
-            "message": "HTTP/1.1 408 Request Timeout"
-          },
-          "429": {
-            "code": 429,
-            "description": "Too many requests are currently being processed.",
-            "message": "HTTP/1.1 429 Too Many Requests"
-          },
-          "500": {
-            "code": 500,
-            "description": "An internal error occurred when handling the request.",
-            "message": "HTTP/1.1 500 Internal Server Error"
-          }
-        },
-        "summary": "/metrics/total",
+        "summary": [
+          "/metrics"
+        ],
         "tags": [
           "Management REST APIs"
         ]
@@ -4229,7 +6273,17 @@
                           "type": "number"
                         },
                         "routePath": {
-                          "type": "string"
+                          "anyOf": [
+                            {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            {
+                              "type": "string"
+                            }
+                          ]
                         },
                         "startedOn": {
                           "type": "number"
@@ -4444,7 +6498,9 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/sessions",
+        "summary": [
+          "/sessions"
+        ],
         "tags": [
           "Management REST APIs"
         ]
@@ -4490,13 +6546,15 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/",
+        "summary": [
+          "/"
+        ],
         "tags": [
           "Management REST APIs"
         ]
       }
     },
-    "/playwright/webkit": {
+    "/playwright/webkit /webkit/playwright": {
       "get": {
         "definitions": {},
         "description": "Connect to Webkit with any playwright-compliant library.",
@@ -4587,7 +6645,7 @@
             "message": "HTTP/1.1 500 Internal Server Error"
           }
         },
-        "summary": "/playwright/webkit",
+        "summary": "/playwright/webkit /webkit/playwright",
         "tags": [
           "Browser WebSocket APIs"
         ]