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

package/src/routes/chromium/tests/websocket.spec.ts

@@ -12,7 +12,7 @@ import { deleteAsync } from 'del';
 import { expect } from 'chai';
 import puppeteer from 'puppeteer-core';
 
-describe('WebSocket API', function () {
+describe('Chromium WebSocket API', function () {
   // Server shutdown can take a few seconds
   // and so can these tests :/
   this.timeout(5000);
@@ -38,38 +38,25 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
     });
 
-    await browser.disconnect();
+    await browser.close();
   });
 
-  it('runs chromium CDP requests', async () => {
+  it('runs chromium Playwright-CDP requests', async () => {
     const config = new Config();
     config.setToken('browserless');
     const metrics = new Metrics();
     await start({ config, metrics });
 
     const browser = await chromium.connectOverCDP(
-      `ws://localhost:3000?token=browserless`,
+      `ws://localhost:3000/chromium?token=browserless`,
     );
 
     await browser.close();
   });
 
-  it('runs chromium websocket requests', async () => {
-    const config = new Config();
-    config.setToken('browserless');
-    const metrics = new Metrics();
-    await start({ config, metrics });
-
-    const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless`,
-    });
-
-    await browser.disconnect();
-  });
-
   it('runs multiple websocket requests', async () => {
     const config = new Config();
     config.setToken('browserless');
@@ -77,11 +64,11 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
     });
 
     const browserTwo = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
     });
 
     await Promise.all([browser.disconnect(), browserTwo.disconnect()]);
@@ -95,8 +82,9 @@ describe('WebSocket API', function () {
 
     // Single session
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
     });
+    await sleep(100);
     const [session] = (await fetchJson(
       'http://localhost:3000/sessions?token=browserless',
     )) as BrowserlessSessionJSON[];
@@ -106,6 +94,7 @@ describe('WebSocket API', function () {
     const browserTwo = await puppeteer.connect({
       browserWSEndpoint: `ws://localhost:3000/devtools/browser/${session.browserId}?token=browserless`,
     });
+    await sleep(100);
     const [twoSessions] = (await fetchJson(
       'http://localhost:3000/sessions?token=browserless',
     )) as BrowserlessSessionJSON[];
@@ -113,7 +102,7 @@ describe('WebSocket API', function () {
 
     // Back to a single session
     await browser.disconnect();
-    await sleep(50);
+    await sleep(100);
     const [oneSession] = (await fetchJson(
       'http://localhost:3000/sessions?token=browserless',
     )) as BrowserlessSessionJSON[];
@@ -121,7 +110,7 @@ describe('WebSocket API', function () {
 
     // No sessions connected
     await browserTwo.disconnect();
-    await sleep(50);
+    await sleep(100);
     const sessionsFinal = (await fetchJson(
       'http://localhost:3000/sessions?token=browserless',
     )) as BrowserlessSessionJSON[];
@@ -136,7 +125,7 @@ describe('WebSocket API', function () {
     const metrics = new Metrics();
     await start({ config, metrics });
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
     });
     const [session] = (await fetchJson(
       'http://localhost:3000/sessions?token=browserless',
@@ -159,7 +148,7 @@ describe('WebSocket API', function () {
 
     const didError = await puppeteer
       .connect({
-        browserWSEndpoint: `ws://localhost:3000?token=bad`,
+        browserWSEndpoint: `ws://localhost:3000/chromium?token=bad`,
       })
       .then(() => false)
       .catch(() => true);
@@ -175,7 +164,7 @@ describe('WebSocket API', function () {
 
     const didError = await puppeteer
       .connect({
-        browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+        browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
       })
       .then(async (b) => {
         const page = await b.newPage();
@@ -200,7 +189,7 @@ describe('WebSocket API', function () {
 
     const success = await puppeteer
       .connect({
-        browserWSEndpoint: `ws://localhost:3000?token=browserless&launch=${JSON.stringify(
+        browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless&launch=${JSON.stringify(
           args,
         )}`,
       })
@@ -222,7 +211,7 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
     });
 
     const [{ userDataDir }] = await fetch(
@@ -247,7 +236,7 @@ describe('WebSocket API', function () {
     });
 
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless&launch=${launch}`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless&launch=${launch}`,
     });
 
     const [{ userDataDir }] = await fetch(
@@ -274,7 +263,7 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless&launch=${launch}`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless&launch=${launch}`,
     });
 
     const [{ userDataDir }] = await fetch(
@@ -302,7 +291,7 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?token=browserless&launch=${launch}`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless&launch=${launch}`,
     });
 
     const [{ userDataDir }] = await fetch(
@@ -327,7 +316,7 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000?timeout=1000&token=browserless`,
+      browserWSEndpoint: `ws://localhost:3000/chromium?timeout=1000&token=browserless`,
     });
     expect(browser.connected).to.be.true;
     await sleep(1200);
@@ -344,7 +333,7 @@ describe('WebSocket API', function () {
       await start({ config, metrics });
       const job = async () => {
         const browser = await puppeteer.connect({
-          browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+          browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
         });
 
         const page = await browser.newPage();
@@ -377,7 +366,7 @@ describe('WebSocket API', function () {
 
     const job = async () => {
       const browser = await puppeteer.connect({
-        browserWSEndpoint: `ws://localhost:3000?token=browserless`,
+        browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
       });
       await sleep(100);
 
@@ -403,7 +392,9 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     return puppeteer
-      .connect({ browserWSEndpoint: `ws://localhost:3000?token=browserless` })
+      .connect({
+        browserWSEndpoint: `ws://localhost:3000/chromium?token=browserless`,
+      })
       .catch((error) => {
         const results = metrics.get();
         expect(results.successful).to.equal(0);
@@ -420,7 +411,7 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     return puppeteer
-      .connect({ browserWSEndpoint: `ws://localhost:3000` })
+      .connect({ browserWSEndpoint: `ws://localhost:3000/chromium` })
       .catch((error: Error) => {
         const results = metrics.get();
         expect(results.successful).to.equal(0);
@@ -437,7 +428,7 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     const browser = await chromium.connect(
-      `ws://localhost:3000/playwright/chromium?token=browserless`,
+      `ws://localhost:3000/chromium/playwright?token=browserless`,
     );
 
     await browser.close();
@@ -457,7 +448,7 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     const browser = await chromium.connectOverCDP(
-      `ws://localhost:3000?token=browserless`,
+      `ws://localhost:3000/chromium?token=browserless`,
     );
 
     await browser.close();
@@ -477,7 +468,7 @@ describe('WebSocket API', function () {
     await start({ config, metrics });
 
     await chromium
-      .connect(`ws://localhost:3000/playwright/chromium`)
+      .connect(`ws://localhost:3000/chromium/playwright`)
       .catch((e) => {
         const results = metrics.get();
         expect(e.message).to.include('Bad or missing authentication');
@@ -492,7 +483,7 @@ describe('WebSocket API', function () {
     await start();
 
     const browser = await puppeteer.connect({
-      browserWSEndpoint: `ws://localhost:3000`,
+      browserWSEndpoint: `ws://localhost:3000/chromium`,
     });
 
     await browser.disconnect();

package/src/routes/chromium/ws/browser.ts

@@ -1,29 +1 @@
-import {
-  APITags,
-  BrowserWebsocketRoute,
-  CDPChromium,
-  CDPLaunchOptions,
-  Request,
-  SystemQueryParameters,
-  WebsocketRoutes,
-} from '@browserless.io/browserless';
-import { Duplex } from 'stream';
-
-export interface QuerySchema extends SystemQueryParameters {
-  launch?: CDPLaunchOptions | string;
-}
-
-export default class CDPExistingBrowser extends BrowserWebsocketRoute {
-  auth = true;
-  browser = CDPChromium;
-  concurrency = true;
-  description = `Connect to an already-running Chromium with a library like puppeteer, or others, that work over chrome-devtools-protocol.`;
-  path = WebsocketRoutes.browser;
-  tags = [APITags.browserWS];
-  handler = async (
-    req: Request,
-    socket: Duplex,
-    head: Buffer,
-    chrome: CDPChromium,
-  ): Promise<void> => chrome.proxyWebSocket(req, socket, head);
-}
+export { default, QuerySchema } from '../../../shared/browser.ws.js';

package/src/routes/chromium/ws/cdp.ts

@@ -0,0 +1 @@
+export { default, QuerySchema } from '../../../shared/chromium.ws.js';

package/src/routes/chromium/ws/page.ts

@@ -1,29 +1 @@
-import {
-  APITags,
-  BrowserWebsocketRoute,
-  CDPChromium,
-  CDPLaunchOptions,
-  Request,
-  SystemQueryParameters,
-  WebsocketRoutes,
-} from '@browserless.io/browserless';
-import { Duplex } from 'stream';
-
-export interface QuerySchema extends SystemQueryParameters {
-  launch?: CDPLaunchOptions | string;
-}
-
-export default class PageWebSocketRoute extends BrowserWebsocketRoute {
-  auth = true;
-  browser = CDPChromium;
-  concurrency = false;
-  description = `Connect to Chromium with a library like chrome-remote-interface or others that work over JSON chrome-devtools-protocol.`;
-  path = WebsocketRoutes.page;
-  tags = [APITags.browserWS];
-  handler = async (
-    req: Request,
-    socket: Duplex,
-    head: Buffer,
-    chrome: CDPChromium,
-  ): Promise<void> => chrome.proxyPageWebSocket(req, socket, head);
-}
+export { default, QuerySchema } from '../../../shared/page.ws.js';

package/src/routes/chromium/ws/playwright.ts

@@ -0,0 +1,4 @@
+export {
+  default,
+  QuerySchema,
+} from '../../../shared/chromium.playwright.ws.js';

package/src/routes/firefox/ws/{playwright-firefox.ts → playwright.ts}

@@ -3,7 +3,7 @@ import {
   BadRequest,
   BrowserServerOptions,
   BrowserWebsocketRoute,
-  PlaywrightFirefox,
+  FirefoxPlaywright,
   Request,
   SystemQueryParameters,
   WebsocketRoutes,
@@ -14,18 +14,18 @@ export interface QuerySchema extends SystemQueryParameters {
   launch?: BrowserServerOptions | string;
 }
 
-export default class PlayWrightFirefoxRoute extends BrowserWebsocketRoute {
+export default class FirefoxPlayWrightRoute extends BrowserWebsocketRoute {
   auth = true;
-  browser = PlaywrightFirefox;
+  browser = FirefoxPlaywright;
   concurrency = true;
   description = `Connect to Firefox with any playwright-compliant library.`;
-  path = WebsocketRoutes.playwrightFirefox;
+  path = [WebsocketRoutes.playwrightFirefox, WebsocketRoutes.firefoxPlaywright];
   tags = [APITags.browserWS];
   handler = async (
     req: Request,
     socket: Duplex,
     head: Buffer,
-    browser: PlaywrightFirefox,
+    browser: FirefoxPlaywright,
   ): Promise<void> => {
     const isPlaywright = req.headers['user-agent']
       ?.toLowerCase()

package/src/routes/management/http/{static-get.ts → static.get.ts}

@@ -38,7 +38,7 @@ const streamFile = (res: ServerResponse, file: string, contentType?: string) =>
           debug(`Error finding file ${file}, sending 404`);
           pathMap.delete(file);
           return reject(
-            new NotFound(`No handler or file found for resource ${file}`),
+            new NotFound(`Request for file "${file}" was not found`),
           );
         }
       })
@@ -78,7 +78,7 @@ export default class StaticGetRoute extends HTTPRoute {
     ).find((_) => !!_);
 
     if (!filePath) {
-      throw new NotFound(`No handler or file found for resource ${pathname}`);
+      throw new NotFound(`No route or file found for resource ${req.method}: ${pathname}`);
     }
 
     verbose(`Found new file "${filePath}", caching path and serving`);

package/src/routes/webkit/ws/{playwright-webkit.ts → playwright.ts}

@@ -3,9 +3,9 @@ import {
   BadRequest,
   BrowserServerOptions,
   BrowserWebsocketRoute,
-  PlaywrightWebkit,
   Request,
   SystemQueryParameters,
+  WebkitPlaywright,
   WebsocketRoutes,
 } from '@browserless.io/browserless';
 import { Duplex } from 'stream';
@@ -14,18 +14,18 @@ export interface QuerySchema extends SystemQueryParameters {
   launch?: BrowserServerOptions | string;
 }
 
-export default class PlaywrightWebkitRoute extends BrowserWebsocketRoute {
+export default class WebkitPlaywrightRoute extends BrowserWebsocketRoute {
   auth = true;
-  browser = PlaywrightWebkit;
+  browser = WebkitPlaywright;
   concurrency = true;
   description = `Connect to Webkit with any playwright-compliant library.`;
-  path = WebsocketRoutes.playwrightWebkit;
+  path = [WebsocketRoutes.playwrightWebkit, WebsocketRoutes.webkitPlaywright];
   tags = [APITags.browserWS];
   handler = async (
     req: Request,
     socket: Duplex,
     head: Buffer,
-    browser: PlaywrightWebkit,
+    browser: WebkitPlaywright,
   ): Promise<void> => {
     const isPlaywright = req.headers['user-agent']
       ?.toLowerCase()

package/src/shared/browser.ws.ts

@@ -0,0 +1,34 @@
+import {
+  APITags,
+  BrowserWebsocketRoute,
+  CDPLaunchOptions,
+  ChromiumCDP,
+  Request,
+  SystemQueryParameters,
+  WebsocketRoutes,
+  dedent,
+} from '@browserless.io/browserless';
+import { Duplex } from 'stream';
+
+export interface QuerySchema extends SystemQueryParameters {
+  launch?: CDPLaunchOptions | string;
+}
+
+export default class CDPExistingBrowser extends BrowserWebsocketRoute {
+  auth = true;
+  browser = ChromiumCDP;
+  concurrency = true;
+  description = dedent(
+    `Connect to an already-running Chromium process with a library like
+    puppeteer, or others, that work over chrome-devtools-protocol. Chromium
+    must already be launched in order to not return a 404.`,
+  );
+  path = WebsocketRoutes.browser;
+  tags = [APITags.browserWS];
+  handler = async (
+    req: Request,
+    socket: Duplex,
+    head: Buffer,
+    browser: ChromiumCDP,
+  ): Promise<void> => browser.proxyWebSocket(req, socket, head);
+}

package/src/{routes/chromium/ws/playwright-chromium.ts → shared/chromium.playwright.ws.ts}

@@ -3,7 +3,7 @@ import {
   BadRequest,
   BrowserServerOptions,
   BrowserWebsocketRoute,
-  PlaywrightChromium,
+  ChromiumPlaywright,
   Request,
   SystemQueryParameters,
   WebsocketRoutes,
@@ -16,16 +16,19 @@ export interface QuerySchema extends SystemQueryParameters {
 
 export default class PlaywrightChromiumRoute extends BrowserWebsocketRoute {
   auth = true;
-  browser = PlaywrightChromium;
+  browser = ChromiumPlaywright;
   concurrency = true;
   description = `Connect to Chromium with any playwright style library.`;
-  path = WebsocketRoutes.playwrightChromium;
+  path = [
+    WebsocketRoutes.playwrightChromium,
+    WebsocketRoutes.chromiumPlaywright,
+  ];
   tags = [APITags.browserWS];
   handler = async (
     req: Request,
     socket: Duplex,
     head: Buffer,
-    browser: PlaywrightChromium,
+    browser: ChromiumPlaywright,
   ): Promise<void> => {
     const isPlaywright = req.headers['user-agent']
       ?.toLowerCase()

package/src/{routes/chromium/ws/cdp-chromium.ts → shared/chromium.ws.ts}

@@ -1,8 +1,8 @@
 import {
   APITags,
   BrowserWebsocketRoute,
-  CDPChromium,
   CDPLaunchOptions,
+  ChromiumCDP,
   Request,
   SystemQueryParameters,
   WebsocketRoutes,
@@ -13,17 +13,17 @@ export interface QuerySchema extends SystemQueryParameters {
   launch?: CDPLaunchOptions | string;
 }
 
-export default class CDPChromiumRoute extends BrowserWebsocketRoute {
+export default class ChromiumCDPRoute extends BrowserWebsocketRoute {
   auth = true;
-  browser = CDPChromium;
+  browser = ChromiumCDP;
   concurrency = true;
   description = `Launch and connect to Chromium with a library like puppeteer or others that work over chrome-devtools-protocol.`;
-  path = WebsocketRoutes['/'];
+  path = [WebsocketRoutes['/'], WebsocketRoutes.chromium];
   tags = [APITags.browserWS];
   handler = async (
     req: Request,
     socket: Duplex,
     head: Buffer,
-    chrome: CDPChromium,
-  ): Promise<void> => chrome.proxyWebSocket(req, socket, head);
+    browser: ChromiumCDP,
+  ): Promise<void> => browser.proxyWebSocket(req, socket, head);
 }

package/src/{routes/chromium/http/content-post.ts → shared/content.http.ts}

@@ -3,8 +3,8 @@ import {
   BadRequest,
   BrowserHTTPRoute,
   BrowserInstance,
-  CDPChromium,
   CDPLaunchOptions,
+  ChromiumCDP,
   HTTPRoutes,
   Methods,
   Request,
@@ -65,12 +65,12 @@ export type QuerySchema = SystemQueryParameters & {
 export default class ContentPostRoute extends BrowserHTTPRoute {
   accepts = [contentTypes.json];
   auth = true;
-  browser = CDPChromium;
+  browser = ChromiumCDP;
   concurrency = true;
   contentTypes = [contentTypes.html];
   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.`;
   method = Methods.post;
-  path = HTTPRoutes.content;
+  path = [HTTPRoutes.content, HTTPRoutes.chromiumContent];
   tags = [APITags.browserAPI];
   handler = async (
     req: Request,
@@ -118,7 +118,7 @@ export default class ContentPostRoute extends BrowserHTTPRoute {
     }
 
     const page = (await browser.newPage()) as UnwrapPromise<
-      ReturnType<CDPChromium['newPage']>
+      ReturnType<ChromiumCDP['newPage']>
     >;
     const gotoCall = url ? page.goto.bind(page) : page.setContent.bind(page);
 

package/src/{routes/chromium/http/download-post.ts → shared/download.http.ts}

@@ -2,8 +2,8 @@ import {
   APITags,
   BrowserHTTPRoute,
   BrowserInstance,
-  CDPChromium,
   CDPLaunchOptions,
+  ChromiumCDP,
   HTTPRoutes,
   Methods,
   NotFound,
@@ -20,7 +20,7 @@ import { mkdir, readdir } from 'fs/promises';
 import { ServerResponse } from 'http';
 import { createReadStream } from 'fs';
 import { deleteAsync } from 'del';
-import functionHandler from '../utils/function/handler.js';
+import functionHandler from './utils/function/handler.js';
 import path from 'path';
 
 interface JSONSchema {
@@ -43,7 +43,7 @@ export type ResponseSchema = unknown;
 export default class DownloadPost extends BrowserHTTPRoute {
   accepts = [contentTypes.json, contentTypes.javascript];
   auth = true;
-  browser = CDPChromium;
+  browser = ChromiumCDP;
   concurrency = true;
   contentTypes = [contentTypes.any];
   description = dedent(`
@@ -54,7 +54,7 @@ export default class DownloadPost extends BrowserHTTPRoute {
   that are written for execution inside of the browser. Once your script is finished, any
   downloaded files from Chromium are returned back with the appropriate content-type header.`);
   method = Methods.post;
-  path = HTTPRoutes.download;
+  path = [HTTPRoutes.download, HTTPRoutes.chromiumDownload];
   tags = [APITags.browserAPI];
   handler = async (
     req: Request,

package/src/{routes/chromium/http/function-post.ts → shared/function.http.ts}

@@ -3,8 +3,8 @@ import {
   BadRequest,
   BrowserHTTPRoute,
   BrowserInstance,
-  CDPChromium,
   CDPLaunchOptions,
+  ChromiumCDP,
   HTTPRoutes,
   Methods,
   Request,
@@ -16,7 +16,7 @@ import {
 import { ServerResponse } from 'http';
 import Stream from 'stream';
 import { fileTypeFromBuffer } from 'file-type';
-import functionHandler from '../utils/function/handler.js';
+import functionHandler from './utils/function/handler.js';
 
 interface JSONSchema {
   code: string;
@@ -40,7 +40,7 @@ export type ResponseSchema = unknown;
 export default class FunctionPost extends BrowserHTTPRoute {
   accepts = [contentTypes.json, contentTypes.javascript];
   auth = true;
-  browser = CDPChromium;
+  browser = ChromiumCDP;
   concurrency = true;
   contentTypes = [contentTypes.any];
   description = dedent(`
@@ -50,7 +50,7 @@ export default class FunctionPost extends BrowserHTTPRoute {
   Values returned from the function are checked and an appropriate content-type and response is sent back
   to your HTTP call.`);
   method = Methods.post;
-  path = HTTPRoutes.function;
+  path = [HTTPRoutes.function, HTTPRoutes.chromiumFunction];
   tags = [APITags.browserAPI];
   handler = async (
     req: Request,

package/src/shared/json-list.http.ts

@@ -0,0 +1,35 @@
+import {
+  APITags,
+  CDPJSONPayload,
+  HTTPRoute,
+  HTTPRoutes,
+  Methods,
+  Request,
+  Response,
+  contentTypes,
+  dedent,
+  jsonResponse,
+} from '@browserless.io/browserless';
+
+export type ResponseSchema = Array<CDPJSONPayload>;
+
+export default class GetJSONList extends HTTPRoute {
+  accepts = [contentTypes.any];
+  auth = true;
+  browser = null;
+  concurrency = false;
+  contentTypes = [contentTypes.json];
+  description = dedent(`
+    Returns a JSON payload that acts as a pass-through to the DevTools /json/list HTTP API in Chromium and Chrome.
+    Browserless crafts this payload so that remote clients can connect to the underlying "webSocketDebuggerUrl"
+    properly, excluding any API tokens in that URL. If under authentication be sure to include your authorization.
+  `);
+  method = Methods.get;
+  path = HTTPRoutes.jsonList;
+  tags = [APITags.browserAPI];
+
+  handler = async (_req: Request, res: Response): Promise<void> => {
+    const browserManage = this.browserManager();
+    return jsonResponse(res, 200, await browserManage.getJSONList());
+  };
+}