From 9b9fa1b0f14607b4db3a8a08414fc1068f2f1f67 Mon Sep 17 00:00:00 2001 From: Dario Piotrowicz Date: Fri, 19 Sep 2025 12:02:33 +0100 Subject: [PATCH 1/2] Directly recommend setting `remote: true` when mentioning remote bindings --- src/content/docs/browser-rendering/faq.mdx | 2 +- src/content/docs/browser-rendering/how-to/ai.mdx | 2 +- .../docs/browser-rendering/how-to/pdf-generation.mdx | 12 +++++++++--- .../docs/browser-rendering/platform/wrangler.mdx | 4 +++- .../workers-bindings/browser-rendering-with-DO.mdx | 4 +++- .../workers-bindings/reuse-sessions.mdx | 4 +++- .../docs/d1/best-practices/local-development.mdx | 2 +- .../d1/tutorials/build-an-api-to-access-d1/index.mdx | 2 +- .../using-read-replication-for-e-com/index.mdx | 2 +- src/content/docs/kv/concepts/kv-bindings.mdx | 2 +- src/content/docs/kv/get-started.mdx | 4 +++- .../docs/r2/api/workers/workers-api-usage.mdx | 3 ++- .../example-workers-binding-screenshots-from-web.mdx | 4 +++- .../partials/workers/wrangler-commands/d1.mdx | 2 +- 14 files changed, 33 insertions(+), 16 deletions(-) diff --git a/src/content/docs/browser-rendering/faq.mdx b/src/content/docs/browser-rendering/faq.mdx index f4509edd9301987..d47b88eec988c16 100644 --- a/src/content/docs/browser-rendering/faq.mdx +++ b/src/content/docs/browser-rendering/faq.mdx @@ -25,7 +25,7 @@ If you cannot find the answer you are looking for, join us on [Discord](https:// Not yet. Local development currently has the following limitation(s): - Requests larger than 1 MB are not supported. -For full feature access, set the browser rendering as a [remote binding](/workers/development-testing/#remote-bindings). +To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). ### Will Browser Rendering bypass Cloudflare's Bot Protection? diff --git a/src/content/docs/browser-rendering/how-to/ai.mdx b/src/content/docs/browser-rendering/how-to/ai.mdx index 212a6a83e5e0819..fd8f14cecd902ea 100644 --- a/src/content/docs/browser-rendering/how-to/ai.mdx +++ b/src/content/docs/browser-rendering/how-to/ai.mdx @@ -259,7 +259,7 @@ async function getLLMResult(env, prompt: string, schema?: any) { } ``` -You can run this script to test it using [remote bindings](/workers/development-testing/#remote-bindings): +You can run this script to test it via: ```sh npx wrangler dev diff --git a/src/content/docs/browser-rendering/how-to/pdf-generation.mdx b/src/content/docs/browser-rendering/how-to/pdf-generation.mdx index cca973439871ebd..d6b85b246304922 100644 --- a/src/content/docs/browser-rendering/how-to/pdf-generation.mdx +++ b/src/content/docs/browser-rendering/how-to/pdf-generation.mdx @@ -11,8 +11,8 @@ As seen in [this Workers bindings guide](/browser-rendering/workers-bindings/scr You can generate PDFs with Browser Rendering in two ways: -- **[REST API](/browser-rendering/rest-api/)**: Use the the [/pdf endpoint](/browser-rendering/rest-api/pdf-endpoint/). This is ideal if you don't need to customize rendering behavior. -- **[Workers Bindings](/browser-rendering/workers-bindings/)**: Use [Puppeteer](/browser-rendering/platform/puppeteer/) or [Playwright](/browser-rendering/platform/playwright/) with Workers Bindings for additional control and customization. +- **[REST API](/browser-rendering/rest-api/)**: Use the the [/pdf endpoint](/browser-rendering/rest-api/pdf-endpoint/). This is ideal if you don't need to customize rendering behavior. +- **[Workers Bindings](/browser-rendering/workers-bindings/)**: Use [Puppeteer](/browser-rendering/platform/puppeteer/) or [Playwright](/browser-rendering/platform/playwright/) with Workers Bindings for additional control and customization. Choose the method that best fits your use case. @@ -36,6 +36,12 @@ The following example shows you how to generate a PDF using [Puppeteer](/browser browser = { binding = "BROWSER" } ``` +:::note + +During local development the configuration above will use a local browser simulation, to instead interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). + +::: + 4. Replace the contents of `src/index.ts` (or `src/index.js` for JavaScript projects) with the following skeleton script: @@ -257,7 +263,7 @@ export default { }; ``` -You can run this script to test it using [remote bindings](/workers/development-testing/#remote-bindings): +You can run this script to test it via: diff --git a/src/content/docs/browser-rendering/platform/wrangler.mdx b/src/content/docs/browser-rendering/platform/wrangler.mdx index fa952ceb7aaaf10..bd80c04c4a72c4c 100644 --- a/src/content/docs/browser-rendering/platform/wrangler.mdx +++ b/src/content/docs/browser-rendering/platform/wrangler.mdx @@ -44,4 +44,6 @@ After the binding is declared, access the DevTools endpoint using `env.MYBROWSER const browser = await puppeteer.launch(env.MYBROWSER); ``` -Run `npx wrangler dev` to test your Worker locally. You can also set the browser binding as a [remote binding](/workers/development-testing/#remote-bindings) to test against a remote browser. +Run `npx wrangler dev` to test your Worker locally. + +To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). diff --git a/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx b/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx index 8f77e3c322371de..fe1b6caf86d43ab 100644 --- a/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx +++ b/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx @@ -210,7 +210,9 @@ export class Browser { ## 6. Test -Run `npx wrangler dev` to test your Worker locally. You can also set the browser binding as a [remote binding](/workers/development-testing/#remote-bindings) to test against a remote browser. +Run `npx wrangler dev` to test your Worker locally. + +To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). ## 7. Deploy diff --git a/src/content/docs/browser-rendering/workers-bindings/reuse-sessions.mdx b/src/content/docs/browser-rendering/workers-bindings/reuse-sessions.mdx index ae2fe477a85b10f..aeb25f32ab71f11 100644 --- a/src/content/docs/browser-rendering/workers-bindings/reuse-sessions.mdx +++ b/src/content/docs/browser-rendering/workers-bindings/reuse-sessions.mdx @@ -144,7 +144,9 @@ Besides `puppeteer.sessions()`, we have added other methods to facilitate [Sessi ## 5. Test -Run `npx wrangler dev` to test your Worker locally. You can also set the browser binding as a [remote binding](/workers/development-testing/#remote-bindings) to test against a remote browser. +Run `npx wrangler dev` to test your Worker locally. + +To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). To test go to the following URL: diff --git a/src/content/docs/d1/best-practices/local-development.mdx b/src/content/docs/d1/best-practices/local-development.mdx index 13c796ff7650b98..3f4ea81f6d12bfb 100644 --- a/src/content/docs/d1/best-practices/local-development.mdx +++ b/src/content/docs/d1/best-practices/local-development.mdx @@ -67,7 +67,7 @@ database_id = "c020574a-5623-407b-be0c-cd192bab9545" -Note that `wrangler dev` separates local and production (remote) data. A local session does not have access to your production data by default. To access your production (remote) database, set your D1 as a [remote binding](/workers/development-testing/#remote-bindings). Any changes you make when running against a remote database cannot be undone. +Note that `wrangler dev` separates local and production (remote) data. A local session does not have access to your production data by default. To access your production (remote) database, set `"remote" : true` in the D1 binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). Any changes you make when running against a remote database cannot be undone. Refer to the [`wrangler dev` documentation](/workers/wrangler/commands/#dev) to learn more about how to configure a local development session. diff --git a/src/content/docs/d1/tutorials/build-an-api-to-access-d1/index.mdx b/src/content/docs/d1/tutorials/build-an-api-to-access-d1/index.mdx index 19546bf5c10d97b..2b00c561cf9a71b 100644 --- a/src/content/docs/d1/tutorials/build-an-api-to-access-d1/index.mdx +++ b/src/content/docs/d1/tutorials/build-an-api-to-access-d1/index.mdx @@ -280,7 +280,7 @@ Upon successful execution, a new table will be added to your database. :::note -The table will be created in the local instance of the database. If you want to add this table to your production database, set your database as a [remote binding](/workers/development-testing/#remote-bindings). +The table will be created in the local instance of the database. If you want to add this table to your production database set `"remote" : true` in the D1 binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). ::: diff --git a/src/content/docs/d1/tutorials/using-read-replication-for-e-com/index.mdx b/src/content/docs/d1/tutorials/using-read-replication-for-e-com/index.mdx index 5dab537c1a64d1f..fb6d041a4d43102 100644 --- a/src/content/docs/d1/tutorials/using-read-replication-for-e-com/index.mdx +++ b/src/content/docs/d1/tutorials/using-read-replication-for-e-com/index.mdx @@ -857,7 +857,7 @@ curl -X POST http://localhost:8787/api/product \ :::note -Read replication is only used when the application has been [deployed](/d1/tutorials/using-read-replication-for-e-com/#step-9-deploy-the-application). D1 does not create read replicas when you develop locally. To test it locally, you can set your database as a [remote binding](/workers/development-testing/#remote-bindings). +Read replication is only used when the application has been [deployed](/d1/tutorials/using-read-replication-for-e-com/#step-9-deploy-the-application). D1 does not create read replicas when you develop locally. To test it locally, you can set `"remote" : true` in the D1 binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). ::: diff --git a/src/content/docs/kv/concepts/kv-bindings.mdx b/src/content/docs/kv/concepts/kv-bindings.mdx index 11b076f17e77010..4b307d5c052b748 100644 --- a/src/content/docs/kv/concepts/kv-bindings.mdx +++ b/src/content/docs/kv/concepts/kv-bindings.mdx @@ -60,7 +60,7 @@ export default { When you use Wrangler to develop locally with the `wrangler dev` command, Wrangler will default to using a local version of KV to avoid interfering with any of your live production data in KV. This means that reading keys that you have not written locally will return `null`. -To have `wrangler dev` connect to your Workers KV namespace running on Cloudflare's global network, set your KV as a [remote binding](/workers/development-testing/#remote-bindings). +To have `wrangler dev` connect to your Workers KV namespace running on Cloudflare's global network, set `"remote" : true` in the KV binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). diff --git a/src/content/docs/kv/get-started.mdx b/src/content/docs/kv/get-started.mdx index a59fb9748051292..26792b57e413552 100644 --- a/src/content/docs/kv/get-started.mdx +++ b/src/content/docs/kv/get-started.mdx @@ -336,7 +336,9 @@ You can view key-value pairs directly from the dashboard. When using [`wrangler dev`](/workers/wrangler/commands/#dev) to develop locally, Wrangler defaults to using a local version of KV to avoid interfering with any of your live production data in KV. This means that reading keys that you have not written locally returns null. -To have `wrangler dev` connect to your Workers KV namespace running on Cloudflare's global network, you can set the KV as a [remote binding](/workers/development-testing/#remote-bindings) instead. This uses the `preview_id` of the KV binding configuration in the Wrangler file. Refer to the [KV binding docs](/kv/concepts/kv-bindings/#use-kv-bindings-when-developing-locally) for more information. +To have `wrangler dev` connect to your Workers KV namespace running on Cloudflare's global network, you can set `"remote" : true` in the KV binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). + +Refer to the [KV binding docs](/kv/concepts/kv-bindings/#use-kv-bindings-when-developing-locally) for more information. ::: diff --git a/src/content/docs/r2/api/workers/workers-api-usage.mdx b/src/content/docs/r2/api/workers/workers-api-usage.mdx index c9b71a90e83aa08..524202b3dc8c53d 100644 --- a/src/content/docs/r2/api/workers/workers-api-usage.mdx +++ b/src/content/docs/r2/api/workers/workers-api-usage.mdx @@ -83,7 +83,8 @@ Within your Worker code, your bucket is now available under the `MY_BUCKET` vari :::caution[Local Development mode in Wrangler] By default `wrangler dev` runs in local development mode. In this mode, all operations performed by your local worker will operate against local storage on your machine. -You can set an R2 as a [remote binding](/workers/development-testing/#remote-bindings) if you want R2 operations made during development to be performed against a real R2 bucket. + +If you want R2 operations made during development to be performed against a real R2 bucket you can set `"remote" : true` in the R2 binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). ::: diff --git a/src/content/partials/browser-rendering/example-workers-binding-screenshots-from-web.mdx b/src/content/partials/browser-rendering/example-workers-binding-screenshots-from-web.mdx index f1e16db47da6655..6722ec6955694fc 100644 --- a/src/content/partials/browser-rendering/example-workers-binding-screenshots-from-web.mdx +++ b/src/content/partials/browser-rendering/example-workers-binding-screenshots-from-web.mdx @@ -154,7 +154,9 @@ If the same `url` is requested again, it will use the cached version in KV inste #### 6. Test -Run `npx wrangler dev` to test your Worker locally or run [`npx wrangler dev --remote`](/workers/wrangler/commands/#dev) to test your Worker remotely before deploying to Cloudflare's global network. +Run `npx wrangler dev` to test your Worker locally. + +To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). To test taking your first screenshot, go to the following URL: diff --git a/src/content/partials/workers/wrangler-commands/d1.mdx b/src/content/partials/workers/wrangler-commands/d1.mdx index c919ca5271b53b7..312d0fcc495f93d 100644 --- a/src/content/partials/workers/wrangler-commands/d1.mdx +++ b/src/content/partials/workers/wrangler-commands/d1.mdx @@ -80,7 +80,7 @@ You must provide either `--command` or `--file` for this command to run successf - `--local` - Execute commands/files against a local database for use with [wrangler dev](/workers/wrangler/commands/#dev). - `--remote` - - Execute commands/files against a remote D1 database for use with [remote binding](/workers/development-testing/#remote-bindings) or your deployed Worker. + - Execute commands/files against a remote D1 database for use with [remote bindings](/workers/development-testing/#remote-bindings) or your deployed Worker. - `--persist-to` - Specify directory to use for local persistence (for use in combination with `--local`). - `--json` From 7254c4d04017b6d7f24484820bf7e5de3c42d1f6 Mon Sep 17 00:00:00 2001 From: Jun Lee Date: Tue, 30 Sep 2025 17:22:33 +0100 Subject: [PATCH 2/2] PCX Review --- src/content/docs/browser-rendering/faq.mdx | 2 +- .../docs/browser-rendering/how-to/pdf-generation.mdx | 10 +++------- .../docs/browser-rendering/platform/wrangler.mdx | 2 +- .../workers-bindings/browser-rendering-with-DO.mdx | 2 +- .../workers-bindings/reuse-sessions.mdx | 2 +- .../docs/d1/best-practices/local-development.mdx | 4 ++-- .../d1/tutorials/build-an-api-to-access-d1/index.mdx | 2 +- .../using-read-replication-for-e-com/index.mdx | 4 +++- src/content/docs/kv/concepts/kv-bindings.mdx | 2 +- src/content/docs/kv/get-started.mdx | 4 ++-- src/content/docs/r2/api/workers/workers-api-usage.mdx | 2 +- .../example-workers-binding-screenshots-from-web.mdx | 2 +- src/content/partials/workers/remote-binding-note.mdx | 9 +++++++++ 13 files changed, 27 insertions(+), 20 deletions(-) create mode 100644 src/content/partials/workers/remote-binding-note.mdx diff --git a/src/content/docs/browser-rendering/faq.mdx b/src/content/docs/browser-rendering/faq.mdx index d47b88eec988c16..4129c3c102cf28f 100644 --- a/src/content/docs/browser-rendering/faq.mdx +++ b/src/content/docs/browser-rendering/faq.mdx @@ -25,7 +25,7 @@ If you cannot find the answer you are looking for, join us on [Discord](https:// Not yet. Local development currently has the following limitation(s): - Requests larger than 1 MB are not supported. -To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). + ### Will Browser Rendering bypass Cloudflare's Bot Protection? diff --git a/src/content/docs/browser-rendering/how-to/pdf-generation.mdx b/src/content/docs/browser-rendering/how-to/pdf-generation.mdx index d6b85b246304922..ace49e44e73c7af 100644 --- a/src/content/docs/browser-rendering/how-to/pdf-generation.mdx +++ b/src/content/docs/browser-rendering/how-to/pdf-generation.mdx @@ -5,7 +5,7 @@ sidebar: order: 1 --- -import { Aside, WranglerConfig, PackageManagers } from "~/components"; +import { Aside, WranglerConfig, PackageManagers, Render } from "~/components"; As seen in [this Workers bindings guide](/browser-rendering/workers-bindings/screenshots/), Browser Rendering can be used to generate screenshots for any given URL. Alongside screenshots, you can also generate full PDF documents for a given webpage, and can also provide the webpage markup and style ourselves. @@ -36,14 +36,10 @@ The following example shows you how to generate a PDF using [Puppeteer](/browser browser = { binding = "BROWSER" } ``` -:::note - -During local development the configuration above will use a local browser simulation, to instead interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). - -::: - + + 4. Replace the contents of `src/index.ts` (or `src/index.js` for JavaScript projects) with the following skeleton script: ```ts diff --git a/src/content/docs/browser-rendering/platform/wrangler.mdx b/src/content/docs/browser-rendering/platform/wrangler.mdx index bd80c04c4a72c4c..37f79902c3346a0 100644 --- a/src/content/docs/browser-rendering/platform/wrangler.mdx +++ b/src/content/docs/browser-rendering/platform/wrangler.mdx @@ -46,4 +46,4 @@ const browser = await puppeteer.launch(env.MYBROWSER); Run `npx wrangler dev` to test your Worker locally. -To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). + \ No newline at end of file diff --git a/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx b/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx index fe1b6caf86d43ab..118e030873a3333 100644 --- a/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx +++ b/src/content/docs/browser-rendering/workers-bindings/browser-rendering-with-DO.mdx @@ -212,7 +212,7 @@ export class Browser { Run `npx wrangler dev` to test your Worker locally. -To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). + ## 7. Deploy diff --git a/src/content/docs/browser-rendering/workers-bindings/reuse-sessions.mdx b/src/content/docs/browser-rendering/workers-bindings/reuse-sessions.mdx index aeb25f32ab71f11..084386f8c5917d7 100644 --- a/src/content/docs/browser-rendering/workers-bindings/reuse-sessions.mdx +++ b/src/content/docs/browser-rendering/workers-bindings/reuse-sessions.mdx @@ -146,7 +146,7 @@ Besides `puppeteer.sessions()`, we have added other methods to facilitate [Sessi Run `npx wrangler dev` to test your Worker locally. -To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). + To test go to the following URL: diff --git a/src/content/docs/d1/best-practices/local-development.mdx b/src/content/docs/d1/best-practices/local-development.mdx index 3f4ea81f6d12bfb..71b7f3fc2d08c10 100644 --- a/src/content/docs/d1/best-practices/local-development.mdx +++ b/src/content/docs/d1/best-practices/local-development.mdx @@ -5,7 +5,7 @@ sidebar: order: 8 --- -import { WranglerConfig } from "~/components"; +import { WranglerConfig, Render } from "~/components"; D1 has fully-featured support for local development, running the same version of D1 as Cloudflare runs globally. Local development uses [Wrangler](/workers/wrangler/install-and-update/), the command-line interface for Workers, to manage local development sessions and state. @@ -67,7 +67,7 @@ database_id = "c020574a-5623-407b-be0c-cd192bab9545" -Note that `wrangler dev` separates local and production (remote) data. A local session does not have access to your production data by default. To access your production (remote) database, set `"remote" : true` in the D1 binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). Any changes you make when running against a remote database cannot be undone. +Note that `wrangler dev` separates local and production (remote) data. A local session does not have access to your production data by default. To access your production (remote) database, set `"remote" : true` in the D1 binding configuration. Refer to the [remote bindings documentation](/workers/development-testing/#remote-bindings) for more information. Any changes you make when running against a remote database cannot be undone. Refer to the [`wrangler dev` documentation](/workers/wrangler/commands/#dev) to learn more about how to configure a local development session. diff --git a/src/content/docs/d1/tutorials/build-an-api-to-access-d1/index.mdx b/src/content/docs/d1/tutorials/build-an-api-to-access-d1/index.mdx index 2b00c561cf9a71b..cd2a24db2ea552a 100644 --- a/src/content/docs/d1/tutorials/build-an-api-to-access-d1/index.mdx +++ b/src/content/docs/d1/tutorials/build-an-api-to-access-d1/index.mdx @@ -280,7 +280,7 @@ Upon successful execution, a new table will be added to your database. :::note -The table will be created in the local instance of the database. If you want to add this table to your production database set `"remote" : true` in the D1 binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). +The table will be created in the local instance of the database. If you want to add this table to your production database set `"remote" : true` in the D1 binding configuration. Refer to the [remote bindings documentation](/workers/development-testing/#remote-bindings) for more information. ::: diff --git a/src/content/docs/d1/tutorials/using-read-replication-for-e-com/index.mdx b/src/content/docs/d1/tutorials/using-read-replication-for-e-com/index.mdx index fb6d041a4d43102..625d3aec30ba2a2 100644 --- a/src/content/docs/d1/tutorials/using-read-replication-for-e-com/index.mdx +++ b/src/content/docs/d1/tutorials/using-read-replication-for-e-com/index.mdx @@ -857,7 +857,9 @@ curl -X POST http://localhost:8787/api/product \ :::note -Read replication is only used when the application has been [deployed](/d1/tutorials/using-read-replication-for-e-com/#step-9-deploy-the-application). D1 does not create read replicas when you develop locally. To test it locally, you can set `"remote" : true` in the D1 binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). +Read replication is only used when the application has been [deployed](/d1/tutorials/using-read-replication-for-e-com/#step-9-deploy-the-application). D1 does not create read replicas when you develop locally. + +To test it locally, you can set `"remote" : true` in the D1 binding configuration. Refer to the [remote bindings documentation](/workers/development-testing/#remote-bindings) for more information. ::: diff --git a/src/content/docs/kv/concepts/kv-bindings.mdx b/src/content/docs/kv/concepts/kv-bindings.mdx index 4b307d5c052b748..5662ae598f7416a 100644 --- a/src/content/docs/kv/concepts/kv-bindings.mdx +++ b/src/content/docs/kv/concepts/kv-bindings.mdx @@ -60,7 +60,7 @@ export default { When you use Wrangler to develop locally with the `wrangler dev` command, Wrangler will default to using a local version of KV to avoid interfering with any of your live production data in KV. This means that reading keys that you have not written locally will return `null`. -To have `wrangler dev` connect to your Workers KV namespace running on Cloudflare's global network, set `"remote" : true` in the KV binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). +To have `wrangler dev` connect to your Workers KV namespace running on Cloudflare's global network, set `"remote" : true` in the KV binding configuration. Refer to the [remote bindings documentation](/workers/development-testing/#remote-bindings) for more information. diff --git a/src/content/docs/kv/get-started.mdx b/src/content/docs/kv/get-started.mdx index 26792b57e413552..cda5f0c67265d87 100644 --- a/src/content/docs/kv/get-started.mdx +++ b/src/content/docs/kv/get-started.mdx @@ -336,9 +336,9 @@ You can view key-value pairs directly from the dashboard. When using [`wrangler dev`](/workers/wrangler/commands/#dev) to develop locally, Wrangler defaults to using a local version of KV to avoid interfering with any of your live production data in KV. This means that reading keys that you have not written locally returns null. -To have `wrangler dev` connect to your Workers KV namespace running on Cloudflare's global network, you can set `"remote" : true` in the KV binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). +To have `wrangler dev` connect to your Workers KV namespace running on Cloudflare's global network, you can set `"remote" : true` in the KV binding configuration. Refer to the [remote bindings documentation](/workers/development-testing/#remote-bindings) for more information. -Refer to the [KV binding docs](/kv/concepts/kv-bindings/#use-kv-bindings-when-developing-locally) for more information. +Also refer to [KV binding docs](/kv/concepts/kv-bindings/#use-kv-bindings-when-developing-locally). ::: diff --git a/src/content/docs/r2/api/workers/workers-api-usage.mdx b/src/content/docs/r2/api/workers/workers-api-usage.mdx index 524202b3dc8c53d..e1fd2ac0744daae 100644 --- a/src/content/docs/r2/api/workers/workers-api-usage.mdx +++ b/src/content/docs/r2/api/workers/workers-api-usage.mdx @@ -84,7 +84,7 @@ Within your Worker code, your bucket is now available under the `MY_BUCKET` vari By default `wrangler dev` runs in local development mode. In this mode, all operations performed by your local worker will operate against local storage on your machine. -If you want R2 operations made during development to be performed against a real R2 bucket you can set `"remote" : true` in the R2 binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). +If you want the R2 operations that are performed during development to be performed against a real R2 bucket, you can set `"remote" : true` in the R2 binding configuration. Refer to [remote bindings documentation](/workers/development-testing/#remote-bindings) for more information. ::: diff --git a/src/content/partials/browser-rendering/example-workers-binding-screenshots-from-web.mdx b/src/content/partials/browser-rendering/example-workers-binding-screenshots-from-web.mdx index 6722ec6955694fc..f615716183b53fd 100644 --- a/src/content/partials/browser-rendering/example-workers-binding-screenshots-from-web.mdx +++ b/src/content/partials/browser-rendering/example-workers-binding-screenshots-from-web.mdx @@ -156,7 +156,7 @@ If the same `url` is requested again, it will use the cached version in KV inste Run `npx wrangler dev` to test your Worker locally. -To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. You can learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). + To test taking your first screenshot, go to the following URL: diff --git a/src/content/partials/workers/remote-binding-note.mdx b/src/content/partials/workers/remote-binding-note.mdx new file mode 100644 index 000000000000000..f05321bd7cd36e3 --- /dev/null +++ b/src/content/partials/workers/remote-binding-note.mdx @@ -0,0 +1,9 @@ +--- +{} +--- + +:::note[Use real headless browser during local development] + +To interact with a real headless browser during local development, set `"remote" : true` in the Browser binding configuration. Learn more in our [remote bindings documentation](/workers/development-testing/#remote-bindings). + +::: \ No newline at end of file