Skip to content

Commit 3dba6c5

Browse files
authored
[Browser Run] Add local dev workaround for quickAction() binding (#31141)
* [Browser Run] Add local dev workaround for quickAction() binding * [Browser Run] Address review: merge duplicate cautions, clarify wrangler dev command * Update 2026-05-28-use-browser-run-quick-actions-directly-from-workers.mdx * Update 2026-05-28-use-browser-run-quick-actions-directly-from-workers.mdx
1 parent a68fc22 commit 3dba6c5

2 files changed

Lines changed: 25 additions & 4 deletions

File tree

src/content/docs/browser-run/quick-actions/index.mdx

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,15 +41,19 @@ To use Quick Actions from a [Worker](/workers/), configure a [browser binding](/
4141
}
4242
```
4343

44-
:::caution[Compatibility date requirement]
44+
:::caution
4545

46-
Using the `.quickAction()` method requires setting your Worker's compatibility date to `2026-03-24` or later in your `wrangler.json`:
46+
The `.quickAction()` method has two requirements:
47+
48+
- **Compatibility date:** Your Worker must use a compatibility date of `2026-03-24` or later.
49+
- **Remote mode for local development:** The `.quickAction()` method is not yet supported in local development mode. When developing locally with `wrangler dev`, you must use `npx wrangler dev --remote` or set `"remote": true` in your browser binding configuration. Without remote mode, you will receive the error: `The RPC receiver does not implement the method "quickAction"`.
4750

4851
```jsonc
4952
{
5053
"compatibility_date": "2026-03-24",
5154
"browser": {
52-
"binding": "BROWSER"
55+
"binding": "BROWSER",
56+
"remote": true
5357
}
5458
}
5559
```

src/content/docs/browser-run/reference/wrangler.mdx

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,24 @@ The browser binding's `.quickAction()` method requires a compatibility date of `
6262

6363
:::
6464

65-
Run `npx wrangler dev` to test your Worker locally.
65+
:::caution[Quick Actions require remote mode for local development]
66+
67+
The `.quickAction()` method is not yet supported in local development mode. When using `wrangler dev`, you must run with `--remote` or set `"remote": true` in your browser binding configuration:
68+
69+
```jsonc
70+
{
71+
"browser": {
72+
"binding": "MYBROWSER",
73+
"remote": true
74+
}
75+
}
76+
```
77+
78+
Without remote mode, calls to `.quickAction()` will fail with: `The RPC receiver does not implement the method "quickAction"`.
79+
80+
:::
81+
82+
For Puppeteer, Playwright, or CDP-based Workers, run `npx wrangler dev` to test locally. For Quick Actions via `.quickAction()`, use `npx wrangler dev --remote` as noted above.
6683

6784
### Headful mode (experimental)
6885

0 commit comments

Comments
 (0)