Skip to content

Turbopack: Add a check for node version before allowing workerThreads#91614

Open
bgw wants to merge 1 commit intocanaryfrom
bgw/worker-threads-version-check
Open

Turbopack: Add a check for node version before allowing workerThreads#91614
bgw wants to merge 1 commit intocanaryfrom
bgw/worker-threads-version-check

Conversation

@bgw
Copy link
Member

@bgw bgw commented Mar 18, 2026

We want to start dogfooding workerThreads, but we can only safely do it if you have a new enough node version.

We don't have any sort of strong enforcement around node.js version in front (e.g. you could have a misconfigured nvm or fnm), so we need to check the node version first.

Looks like this:

Screenshot 2026-03-18 at 1.04.10 PM.png

Related Node.js version bump for front: https://github.com/vercel/front/pull/65059

Copy link
Member Author

bgw commented Mar 18, 2026

This stack of pull requests is managed by Graphite. Learn more about stacking.

@bgw bgw requested a review from a team March 18, 2026 22:33
@bgw bgw marked this pull request as ready for review March 18, 2026 22:33
@vercel
Copy link
Contributor

vercel bot commented Mar 18, 2026

Notifying the following users due to files changed in this PR based on this repo's notify modifiers:

@timneutkens, @ijjk, @shuding, @huozhi:

packages/next/src/server/config.ts

@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Mar 18, 2026

Failing test suites

Commit: 4954704 | About building and testing Next.js

pnpm test-start-turbo test/production/turbopack-node-backend/turbopack-node-backend.test.ts (turbopack) (job)

  • turbopack-node-backend (workerThreads) > should match expected loader pid behavior (DD)
Expand output

● turbopack-node-backend (workerThreads) › should match expected loader pid behavior

expect(received).toBe(expected) // Object.is equality

Expected: "2596961"
Received: "2597033"

  25 |
  26 |       if (expectSamePid) {
> 27 |         expect(data.loaderPid).toBe(data.buildPid)
     |                                ^
  28 |       } else {
  29 |         expect(data.loaderPid).not.toBe(data.buildPid)
  30 |       }

  at Object.toBe (production/turbopack-node-backend/turbopack-node-backend.test.ts:27:32)

import { basename, extname, join, relative, isAbsolute, resolve } from 'path'
import { pathToFileURL } from 'url'
import findUp from 'next/dist/compiled/find-up'
import semver from 'next/dist/compiled/semver'
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We already always pull in this dependency in the CLI to check your node.js version and exit the CLI with an error if you're on an unsupported version.

@nextjs-bot
Copy link
Collaborator

Stats from current PR

✅ No significant changes detected

📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 608ms 609ms ▁▁▇▁▁
Cold (Ready in log) 565ms 570ms ▃▃▇▁▁
Cold (First Request) 1.151s 1.163s ▁▃▆▃▁
Warm (Listen) 611ms 610ms ▁▁▆▁▁
Warm (Ready in log) 568ms 572ms ▂▂▇▁▁
Warm (First Request) 437ms 442ms ▁▁▆▁▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 456ms 455ms ▁▁▁▁▁
Cold (Ready in log) 438ms 437ms ▆▇▇▁▁
Cold (First Request) 1.937s 1.961s ▂▁▂▃▃
Warm (Listen) 456ms 456ms ▁▁▁▁▁
Warm (Ready in log) 437ms 438ms ▆▇▇▁▁
Warm (First Request) 1.965s 1.947s ▂▁▂▃▃

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 5.092s 5.104s ▂▁▆▁▁
Cached Build 5.193s 5.190s ▂▁▆▁▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 14.399s 14.555s ▂▁▁▂▂
Cached Build 14.504s 14.611s ▂▁▁▂▂
node_modules Size 484 MB 484 MB ▁▁▁██
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
0.5exbwucs-yd.js gzip 160 B N/A -
0~lwfcrlb4v_9.css gzip 115 B 115 B
00h0nz7r436~l.js gzip 13.3 kB N/A -
00ivb_iunbucu.js gzip 13 kB N/A -
02ku7edzc_wf7.js gzip 450 B N/A -
03~yq9q893hmn.js gzip 39.4 kB 39.4 kB
04r1qwr.rw5-9.js gzip 159 B N/A -
08wow2p6zxy.b.js gzip 7.61 kB N/A -
092lcb3fqrrf9.js gzip 8.52 kB N/A -
0aj~xs1l1g8tg.js gzip 8.53 kB N/A -
0bxw9sz.l.isi.js gzip 155 B N/A -
0gcap5mgchcmw.js gzip 162 B N/A -
0h35gmp9u328z.js gzip 8.54 kB N/A -
0h6fkavebp.iz.js gzip 8.47 kB N/A -
0ino_yf1k3h6k.js gzip 10.4 kB N/A -
0kf9xhz8_dktb.js gzip 157 B N/A -
0kye_l1ux9cel.js gzip 169 B N/A -
0m7oae-057qnc.js gzip 155 B N/A -
0mc16gv2x1bet.js gzip 13.7 kB N/A -
0md_-tflrd2du.js gzip 70.8 kB N/A -
0ml26~el19op0.js gzip 65.7 kB N/A -
0moy~uao4dl.m.js gzip 9.19 kB N/A -
0q50rtpusjy90.js gzip 2.28 kB N/A -
0r37_q55bz0u6.js gzip 153 B N/A -
0sc1pinx6.1zt.js gzip 156 B N/A -
0smgy2grrrlka.js gzip 8.58 kB N/A -
0t1dzhdfh0txh.js gzip 215 B 215 B
0t6~hc9gnk57s.js gzip 157 B N/A -
0vt7pofxnk8in.js gzip 10.1 kB N/A -
0wx9mk-9gpzgj.js gzip 157 B N/A -
0z7fcm2gc73j7.js gzip 162 B N/A -
0zid7o0-vupvp.js gzip 225 B N/A -
11yo3xfd6b147.js gzip 12.9 kB N/A -
13.84hqxl_1p7.js gzip 9.76 kB N/A -
133sqyw.dsbn4.js gzip 158 B N/A -
14_hwphcs58-s.js gzip 48.6 kB N/A -
1554wr-t7p6z-.js gzip 8.55 kB N/A -
15tjst79~qy3_.js gzip 1.46 kB N/A -
15z_v00ne4ud0.js gzip 8.47 kB N/A -
17d_m3p4j9w6r.js gzip 5.62 kB N/A -
17yu~3yiu7d2m.js gzip 8.52 kB N/A -
turbopack-0-..ype..js gzip 4.16 kB N/A -
turbopack-00...tyu.js gzip 4.16 kB N/A -
turbopack-02..j77y.js gzip 4.16 kB N/A -
turbopack-04..0t2o.js gzip 4.16 kB N/A -
turbopack-05..wzle.js gzip 4.16 kB N/A -
turbopack-0a..uf03.js gzip 4.16 kB N/A -
turbopack-0i..387d.js gzip 4.16 kB N/A -
turbopack-0k..pn1x.js gzip 4.16 kB N/A -
turbopack-0n..wt4j.js gzip 4.17 kB N/A -
turbopack-0q..4br3.js gzip 4.16 kB N/A -
turbopack-0q..up8q.js gzip 4.14 kB N/A -
turbopack-0t..350p.js gzip 4.16 kB N/A -
turbopack-14..sn2n.js gzip 4.16 kB N/A -
turbopack-16..-~bi.js gzip 4.16 kB N/A -
0_.49f9yku.5j.js gzip N/A 48.6 kB -
0-fin7baiae8b.js gzip N/A 161 B -
012d8jsvdyajm.js gzip N/A 155 B -
03t__~.5lvgeu.js gzip N/A 5.62 kB -
04d6ll75jqx3r.js gzip N/A 9.19 kB -
0583exyh-yhc7.js gzip N/A 9.76 kB -
070gquxjf2~n7.js gzip N/A 155 B -
072lv63r8dcz~.js gzip N/A 8.58 kB -
075t9dxgbf0m8.js gzip N/A 13.7 kB -
0ar1~bwpezfgw.js gzip N/A 13.3 kB -
0c99mq1ez2bke.js gzip N/A 450 B -
0cq-cmde_ws6u.js gzip N/A 8.47 kB -
0fwf102w10o9~.js gzip N/A 8.52 kB -
0gp6xg755-zov.js gzip N/A 156 B -
0gtmn.q_j1v5r.js gzip N/A 10.4 kB -
0h5~v-tahitcf.js gzip N/A 10.1 kB -
0l9pi6keekq0k.js gzip N/A 70.8 kB -
0luyfww_qqjt_.js gzip N/A 151 B -
0nbdhy_v_iovn.js gzip N/A 155 B -
0nclq9z6yzzm5.js gzip N/A 1.46 kB -
0nzumcogektg7.js gzip N/A 8.55 kB -
0p5sjual.nuis.js gzip N/A 13 kB -
0p88ggrxiy7bp.js gzip N/A 7.6 kB -
0rnkwyy_nau6z.js gzip N/A 156 B -
0s.c-cn5eebrx.js gzip N/A 8.47 kB -
0s.x6d1ytiyj5.js gzip N/A 65.7 kB -
0tna7lg6q4zne.js gzip N/A 12.9 kB -
0votdfxr5fb5u.js gzip N/A 2.28 kB -
0vsucvyy.cn~f.js gzip N/A 155 B -
0x_at-_8t2d_o.js gzip N/A 169 B -
0y0_e3eu9~mys.js gzip N/A 153 B -
0yalannhbcmel.js gzip N/A 154 B -
0ykl9bs_qj.5..js gzip N/A 8.52 kB -
0zfen0tnxp4gh.js gzip N/A 8.55 kB -
10wkq1h9jzkg..js gzip N/A 225 B -
11g-hgkizz-l0.js gzip N/A 157 B -
149ndfh8zfcaz.js gzip N/A 8.53 kB -
181wj36ek838a.js gzip N/A 155 B -
turbopack-00..s~f8.js gzip N/A 4.16 kB -
turbopack-05..g.pj.js gzip N/A 4.17 kB -
turbopack-06..pwhd.js gzip N/A 4.16 kB -
turbopack-0d..~gz1.js gzip N/A 4.15 kB -
turbopack-0f..cti5.js gzip N/A 4.16 kB -
turbopack-0h..bbzr.js gzip N/A 4.14 kB -
turbopack-0j..j81g.js gzip N/A 4.16 kB -
turbopack-0m..ybpa.js gzip N/A 4.15 kB -
turbopack-0t..-z50.js gzip N/A 4.16 kB -
turbopack-0w..bf-e.js gzip N/A 4.16 kB -
turbopack-0x..4.7..js gzip N/A 4.16 kB -
turbopack-10..w~4h.js gzip N/A 4.16 kB -
turbopack-14..z65h.js gzip N/A 4.15 kB -
turbopack-15..ba8m.js gzip N/A 4.15 kB -
Total 463 kB 463 kB ✅ -59 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 712 B 711 B
Total 712 B 711 B ✅ -1 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 429 B 430 B
Total 429 B 430 B ⚠️ +1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
5528-HASH.js gzip 5.54 kB N/A -
6280-HASH.js gzip 60.4 kB N/A -
6335.HASH.js gzip 169 B N/A -
912-HASH.js gzip 4.59 kB N/A -
e8aec2e4-HASH.js gzip 62.7 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 256 B 253 B 🟢 3 B (-1%)
main-HASH.js gzip 39.3 kB 39.2 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
262-HASH.js gzip N/A 4.59 kB -
2889.HASH.js gzip N/A 169 B -
5602-HASH.js gzip N/A 5.55 kB -
6948ada0-HASH.js gzip N/A 62.7 kB -
9544-HASH.js gzip N/A 61.1 kB -
Total 234 kB 235 kB ⚠️ +672 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 194 B 194 B
_error-HASH.js gzip 183 B 180 B 🟢 3 B (-2%)
css-HASH.js gzip 331 B 330 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 256 B 256 B
head-HASH.js gzip 351 B 352 B
hooks-HASH.js gzip 384 B 383 B
image-HASH.js gzip 580 B 581 B
index-HASH.js gzip 260 B 260 B
link-HASH.js gzip 2.51 kB 2.51 kB
routerDirect..HASH.js gzip 320 B 319 B
script-HASH.js gzip 386 B 386 B
withRouter-HASH.js gzip 315 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.98 kB 7.98 kB ✅ -1 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 125 kB 125 kB
page.js gzip 269 kB 268 kB
Total 394 kB 394 kB ✅ -348 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 618 B 614 B
middleware-r..fest.js gzip 156 B 155 B
middleware.js gzip 43.9 kB 43.8 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 45.5 kB 45.4 kB ✅ -111 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 715 B 718 B
Total 715 B 718 B ⚠️ +3 B
Build Cache
Canary PR Change
0.pack gzip 4.28 MB 4.27 MB 🟢 8.64 kB (0%)
index.pack gzip 111 kB 111 kB
index.pack.old gzip 110 kB 111 kB
Total 4.5 MB 4.49 MB ✅ -7.96 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 333 kB 333 kB
app-page-exp..prod.js gzip 181 kB 181 kB
app-page-tur...dev.js gzip 333 kB 333 kB
app-page-tur..prod.js gzip 181 kB 181 kB
app-page-tur...dev.js gzip 329 kB 329 kB
app-page-tur..prod.js gzip 179 kB 179 kB
app-page.run...dev.js gzip 330 kB 330 kB
app-page.run..prod.js gzip 179 kB 179 kB
app-route-ex...dev.js gzip 76 kB 76 kB
app-route-ex..prod.js gzip 51.7 kB 51.7 kB
app-route-tu...dev.js gzip 76 kB 76 kB
app-route-tu..prod.js gzip 51.7 kB 51.7 kB
app-route-tu...dev.js gzip 75.6 kB 75.6 kB
app-route-tu..prod.js gzip 51.5 kB 51.5 kB
app-route.ru...dev.js gzip 75.6 kB 75.6 kB
app-route.ru..prod.js gzip 51.5 kB 51.5 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 43.4 kB 43.4 kB
pages-api-tu..prod.js gzip 33 kB 33 kB
pages-api.ru...dev.js gzip 43.3 kB 43.3 kB
pages-api.ru..prod.js gzip 33 kB 33 kB
pages-turbo....dev.js gzip 52.7 kB 52.7 kB
pages-turbo...prod.js gzip 38.6 kB 38.6 kB
pages.runtim...dev.js gzip 52.7 kB 52.7 kB
pages.runtim..prod.js gzip 38.6 kB 38.6 kB
server.runti..prod.js gzip 62.4 kB 62.4 kB
Total 2.95 MB 2.95 MB ✅ -1 B
📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/1bb8cedd6ab47f1a0c33545b597fb46ce18b1250/next


const isBun = !!process.versions.bun
const isDeno = !!process.versions.deno
if (!isBun && !isDeno) {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can we use a positive test instead? isNode?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can't check for process.versions.node because bun (and probably deno too, I didn't check) puts fake values there for compatibility reasons.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

😢

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants