You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/workers/wrangler/migration/update-v3-to-v4.mdx
+5-15Lines changed: 5 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,47 +23,37 @@ Node.js v16, which reached End-of-Life in 2022, is no longer supported in Wrangl
23
23
24
24
### Updated Node.js Support Policy
25
25
26
-
#### What changed?
27
-
28
26
Wrangler now supports only Node.js versions that align with [Node.js's official lifecycle](https://nodejs.org/en/about/previous-releases):
29
27
***Supported**: Current, Active LTS, Maintenance LTS
30
28
***No longer supported:** Node.js v16 (EOL in 2022)
31
29
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.
36
31
37
32
### esbuild Version Upgrade
38
33
39
-
#### What changed?
40
-
41
34
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
+
43
37
44
-
#### Impact
45
38
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.
46
39
47
40
### Commands default to local mode
48
41
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.
51
44
52
45
For example:
53
46
54
47
***Previous Behavior (Wrangler v3):**`wrangler kv list` queried remotely by default.
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.
60
52
61
53
### Changes to KV command output formats
62
54
63
-
#### What changed?
64
55
The output format of `wrangler kv list` has been updateed to align with the input format for `wrangler kv bulk delete.`
65
56
66
-
#### Impact
67
57
Scripts or tools relying on the old `wrangler kv list` output format will need to be updated to handle the new format.
68
58
69
59
### Deprecated Commands and Configurations Removed
0 commit comments