For AI agents: a documentation index is available at /llms.txt
Skip to main content

Version Compatibility

Browserless workers are updated periodically with new browser and library versions. Matching your client library version to the versions running on our workers is important, especially for Playwright's connect method, which is tightly version-coupled. If your code is unexpectedly crashing, version mismatch is a common cause.

Prerequisites
  • A Browserless API token from your account dashboard
  • Puppeteer or Playwright installed locally

Current versions used in usage based workers

Last update: January 29, 2026.

  1. Puppeteer: 24.36.0
  2. Playwright: 1.57.0, 1.56.1, 1.55.1, 1.54.2, 1.53.2, 1.52.0
  3. Chromium: 143.0.7499.4
  4. Chrome: 143.0.7499.193
  5. Firefox: 144.0.2
  6. Webkit: 26.0
  7. Edge: 143.0.3650.139
info

If your code is mysteriously crashing, try using the exact version mentioned above, as some older but especially more recent versions than the above may cause conflicts.

Playwright's versioning

Playwright's connect method is tightly version-coupled. Your client version must be one of the versions listed above.

Playwright's connectOverCDP does not always need to match the same Playwright version on our workers. This method is generally backwards/forwards compatible since it communicates directly through CDP, with the caveat of being slightly slower due to more communication over the DevTools protocol.

FAQ & Troubleshooting

Why am I getting a 403 Forbidden error?

Your API token is missing or expired. Pass it as a ?token= query parameter in the WebSocket or HTTP URL. Verify the token in your account dashboard.

My script works locally but fails on Browserless

Local browser settings may differ from the Browserless environment. Use launch parameters to match your local setup (viewport, user agent, timezone). See launch parameters for the full list.

Next steps