# Browser diagnostics

<!-- Generated by docs/modules/diagnostics from the package catalogs. Write a guide in docs/diagnostics/<CODE>.md instead of editing this file. -->

Each Browser error has a stable `code`. Its `docs` link opens the page of that code. This page lists all 15 codes, and [All diagnostics](https://vitehub.dev/docs/reference/diagnostics) lists every primitive.

## Runtime errors

| Code | What happened |
| --- | --- |
| [`BROWSER_R0001`](https://vitehub.dev/docs/browser/diagnostics/browser_r0001) | Browser handoff audience must be a non-empty string. |
| [`BROWSER_R0002`](https://vitehub.dev/docs/browser/diagnostics/browser_r0002) | handoff({ mode }) currently requires "live". |
| [`BROWSER_R0003`](https://vitehub.dev/docs/browser/diagnostics/browser_r0003) | Browser handoff ttl must be a positive number of milliseconds no greater than 2147483647. |
| [`BROWSER_R0004`](https://vitehub.dev/docs/browser/diagnostics/browser_r0004) | createBrowser() requires a driver. |
| [`BROWSER_R0005`](https://vitehub.dev/docs/browser/diagnostics/browser_r0005) | Failed to reserve a local browser port. |
| [`BROWSER_R0006`](https://vitehub.dev/docs/browser/diagnostics/browser_r0006) | Chromium exited before its CDP endpoint was ready (\<value\>). |
| [`BROWSER_R0007`](https://vitehub.dev/docs/browser/diagnostics/browser_r0007) | localBrowser() requires an executablePath. |
| [`BROWSER_R0008`](https://vitehub.dev/docs/browser/diagnostics/browser_r0008) | localBrowser() startupTimeout must be greater than zero and no greater than 2147483647ms. |
| [`BROWSER_R0009`](https://vitehub.dev/docs/browser/diagnostics/browser_r0009) | Browser Definition \<name\> must default-export defineBrowser(). |
| [`BROWSER_R0010`](https://vitehub.dev/docs/browser/diagnostics/browser_r0010) | defineBrowser() requires a Browser Definition handler. |
| [`BROWSER_R0011`](https://vitehub.dev/docs/browser/diagnostics/browser_r0011) | The built-in Playwright CDP adapter requires Node.js. Use a Cloudflare Browser binding in Workers. |

## Build errors

| Code | What happened |
| --- | --- |
| [`BROWSER_B0001`](https://vitehub.dev/docs/browser/diagnostics/browser_b0001) | Browser binding must be a valid Cloudflare binding name. |
| [`BROWSER_B0002`](https://vitehub.dev/docs/browser/diagnostics/browser_b0002) | Browser engine must be "chromium" or "kitesurf". |

## Named errors

| Code | What happened |
| --- | --- |
| [`BROWSER_CONTENT_FAILED`](https://vitehub.dev/docs/browser/diagnostics/browser_content_failed) | Browser content request failed with status \<status\> |
| [`BROWSER_RENAMED_PROVIDER_KEY`](https://vitehub.dev/docs/browser/diagnostics/browser_renamed_provider_key) | `createBrowser()` got a `provider` option. ViteHub renamed this option to `driver`, and it does not read `provider`. |

<!-- vitehub-docs:section-links -->
## In this section

- [Overview](https://vitehub.dev/raw/docs/browser.md)
- [Get started](https://vitehub.dev/raw/docs/browser/get-started.md)
- [Configure](https://vitehub.dev/raw/docs/browser/configure.md)
- [Server API](https://vitehub.dev/raw/docs/browser/server-api.md)
- [Agent capability](https://vitehub.dev/raw/docs/browser/agent-capability.md)
- [Hosts](https://vitehub.dev/raw/docs/browser/hosts.md)
- [Limits and errors](https://vitehub.dev/raw/docs/browser/limits-and-errors.md)

All pages: [llms.txt](https://vitehub.dev/llms.txt)
