Skip to content

Commit d6e90e2

Browse files
committed
Fixes typos and reorders migration docs to start with v4
1 parent 63b6e93 commit d6e90e2

File tree

3 files changed

+7
-17
lines changed

3 files changed

+7
-17
lines changed

src/content/docs/workers/wrangler/migration/update-v2-to-v3 copy.mdx renamed to src/content/docs/workers/wrangler/migration/update-v2-to-v3.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Migrate from Wrangler v2 to v3
33
pcx_content_type: how-to
44
sidebar:
5-
order: 1
5+
order: 2
66

77
---
88

src/content/docs/workers/wrangler/migration/update-v3-to-v4.mdx

Lines changed: 5 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -23,47 +23,37 @@ Node.js v16, which reached End-of-Life in 2022, is no longer supported in Wrangl
2323

2424
### Updated Node.js Support Policy
2525

26-
#### What changed?
27-
2826
Wrangler now supports only Node.js versions that align with [Node.js's official lifecycle](https://nodejs.org/en/about/previous-releases):
2927
* **Supported**: Current, Active LTS, Maintenance LTS
3028
* **No longer supported:** Node.js v16 (EOL in 2022)
3129

32-
Wrangler tests no longer run on v16, and users still on this version may encounter unsupported behavior.
33-
34-
#### Impact
35-
Users still using Node.js v16 must upgrade to a supported version (v18 or higher) to continue receiving support and compatibility with Wrangler.
30+
Wrangler tests no longer run on v16, and users still on this version may encounter unsupported behavior. Users still using Node.js v16 must upgrade to a supported version (v18 or higher) to continue receiving support and compatibility with Wrangler.
3631

3732
### esbuild Version Upgrade
3833

39-
#### What changed?
40-
4134
Wrangler upgraded esbuild from **v0.17.19** to **v0.24**, bringing improvements (such as the ability to use the `using` keyword with RPC) and changes to bundling behavior:
42-
* **Dynamic imports:** Wildcard imports (e.g., `import('./data/' + kind + '.json') `) now automatically include all matching files in the bundle.
35+
* **Dynamic imports:** Wildcard imports (e.g., `import('./data/' + kind + '.json')`) now automatically include all matching files in the bundle.
36+
4337

44-
#### Impact
4538
Users relying on wildcard dynamic imports may see unwanted files bundled. Prior to esbuild v0.19, `import` statements with dynamic paths ( like `import('./data/' + kind + '.json')`) did not bundle all files matches the glob pattern (`*.json`) . Only files explicitly referenced or included using `find_additional_modules` were bundled. With esbuild v0.19, wildcard imports now automatically bundle all files matching the glob pattern. This could result in unwanted files being bundled, so users might want to avoid wildcard dynamic imports and use explicit imports instead.
4639

4740
### Commands default to local mode
4841

49-
#### What changed?
50-
All commands now run in **local mode by default.** Wrangler has many commands for accessing resources like KV and R2, but the commands were prviously inconsistent in whether they run in a local or remote environment. For example, D1 defaults to querying a local datastore, and requires the `--remote` flag to query via the API. KV, on the other hand, previously defaulted to querying via the API (implicitly using the `--remote` flag) and required a `--local` flag to query a local datastore. In order to make the behavior consistent across Wrangler, each command now uses the `--local` flag by default, and will require an explicit `--remote` flag to query via the API.
42+
43+
All commands now run in **local mode by default.** Wrangler has many commands for accessing resources like KV and R2, but the commands were previously inconsistent in whether they run in a local or remote environment. For example, D1 defaults to querying a local datastore, and requires the `--remote` flag to query via the API. KV, on the other hand, previously defaulted to querying via the API (implicitly using the `--remote` flag) and required a `--local` flag to query a local datastore. In order to make the behavior consistent across Wrangler, each command now uses the `--local` flag by default, and will require an explicit `--remote` flag to query via the API.
5144

5245
For example:
5346

5447
* **Previous Behavior (Wrangler v3):** `wrangler kv list` queried remotely by default.
5548
* **New Behavior (Wrangler v4):** `wrangler kv list` queries locally unless `--remote` is specified.
5649

5750

58-
#### Impact
5951
Those using `wrangler kv` and/or `wrangler r2` commands to query or write to their data store will need to add the `--remote` flag in order to replicate previous behavior.
6052

6153
### Changes to KV command output formats
6254

63-
#### What changed?
6455
The output format of `wrangler kv list` has been updateed to align with the input format for `wrangler kv bulk delete.`
6556

66-
#### Impact
6757
Scripts or tools relying on the old `wrangler kv list` output format will need to be updated to handle the new format.
6858

6959
### Deprecated Commands and Configurations Removed

src/content/docs/workers/wrangler/migration/v1-to-v2/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Migrate from Wrangler v1 to v2
33
pcx_content_type: how-to
44
sidebar:
5-
order: 1
5+
order: 3
66
group:
77
hideIndex: true
88
---

0 commit comments

Comments
 (0)