Skip to content

lib: enable web worker api by default #65323

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
avivkeller wants to merge 1 commit into
base: main
Choose a base branch
from
Open

lib: enable web worker api by default #65323

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 15 additions & 9 deletions doc/api/cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1563,14 +1563,6 @@ changes:

Enable experimental WebAssembly System Interface (WASI) support.

### `--experimental-web-worker`

<!-- YAML
added: REPLACEME
-->

Enable experimental support for the Web Worker API.

### `--experimental-worker-inspection`

<!-- YAML
Expand Down Expand Up @@ -2147,6 +2139,20 @@ changes:

Disable the experimental [`node:sqlite`][] module.

### `--no-experimental-web-worker`

<!-- YAML
added: REPLACEME
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/65323
description: This feature is now enabled by default.
-->

> Stability: 1.1 - Active Development

Disable support for the Web Worker API.

### `--no-experimental-webstorage`

<!-- YAML
Expand Down Expand Up @@ -3914,7 +3920,6 @@ one is included in the list below.
* `--experimental-vfs`
* `--experimental-vm-modules`
* `--experimental-wasi-unstable-preview1`
* `--experimental-web-worker`
* `--experimental-websocket`
* `--force-context-aware`
* `--force-fips`
Expand Down Expand Up @@ -3946,6 +3951,7 @@ one is included in the list below.
* `--no-experimental-global-navigator`
* `--no-experimental-sqlite`
* `--no-experimental-strip-types`
* `--no-experimental-web-worker`
* `--no-experimental-webstorage`
* `--no-extra-info-on-fatal-exception`
* `--no-force-async-hooks-checks`
Expand Down
4 changes: 4 additions & 0 deletions doc/api/globals.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1319,6 +1319,10 @@ A browser-compatible implementation of {WebSocket}.

<!-- YAML
added: REPLACEME
changes:
- version: REPLACEME
pr-url: https://github.com/nodejs/node/pull/65323
description: This feature is now enabled by default.
-->

> Stability: 1 - Experimental. Enable this API with the

@aduh95 aduh95 Aug 25, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
> Stability: 1 - Experimental. Enable this API with the
> Stability: 1 - Experimental. Disable this API with the

As mentioned in #65323 (review), you also need to update the link (we need to get back some kind of automation to detect broken links)

@avivkeller avivkeller Aug 25, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

(we need to get back some kind of automation to detect broken links)

We have one in @node-core/remark-lint, but I've put integrating it into core on hold, I can revisit

Expand Down
10 changes: 5 additions & 5 deletions doc/node.1
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -836,9 +836,6 @@ Enable experimental ES Module support in the \fBnode:vm\fR module.
.It Fl -experimental-wasi-unstable-preview1
Enable experimental WebAssembly System Interface (WASI) support.
.
.It Fl -experimental-web-worker
Enable experimental support for the Web Worker API.
.
.It Fl -experimental-worker-inspection
Enable experimental support for the worker inspection with Chrome DevTools.
.
Expand Down Expand Up @@ -1110,6 +1107,9 @@ Legacy alias for \fB--no-require-module\fR.
.It Fl -no-experimental-sqlite
Disable the experimental \fBnode:sqlite\fR module.
.
.It Fl -no-experimental-web-worker
Disable support for the Web Worker API.
.
.It Fl -no-experimental-webstorage
Disable \fBWeb Storage\fR support.
.
Expand Down Expand Up @@ -2034,8 +2034,6 @@ one is included in the list below.
.It
\fB--experimental-wasi-unstable-preview1\fR
.It
\fB--experimental-web-worker\fR
.It
\fB--experimental-websocket\fR
.It
\fB--force-context-aware\fR
Expand Down Expand Up @@ -2098,6 +2096,8 @@ one is included in the list below.
.It
\fB--no-experimental-strip-types\fR
.It
\fB--no-experimental-web-worker\fR
.It
\fB--no-experimental-webstorage\fR
.It
\fB--no-extra-info-on-fatal-exception\fR
Expand Down
2 changes: 1 addition & 1 deletion src/node_options.cc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -599,7 +599,7 @@ EnvironmentOptionsParser::EnvironmentOptionsParser() {
"experimental Web Worker API",
BOOL_FIELD(experimental_web_worker),
kAllowedInEnvvar,
false);
true);
AddOption("--experimental-websocket", "", NoOp{}, kAllowedInEnvvar);
AddOption("--experimental-global-customevent", "", NoOp{}, kAllowedInEnvvar);
AddOption("--experimental-sqlite",
Expand Down
2 changes: 1 addition & 1 deletion src/node_options.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -202,7 +202,7 @@ class EnvironmentOptions : public Options {
DEFINE_BOOL_FIELD(experimental_addon_modules) = true;
DEFINE_BOOL_FIELD(experimental_eventsource) = EXPERIMENTALS_DEFAULT_VALUE;
DEFINE_BOOL_FIELD(experimental_ffi) = EXPERIMENTALS_DEFAULT_VALUE;
DEFINE_BOOL_FIELD(experimental_web_worker) = EXPERIMENTALS_DEFAULT_VALUE;
DEFINE_BOOL_FIELD(experimental_web_worker) = true;
DEFINE_BOOL_FIELD(experimental_websocket) = true;
DEFINE_BOOL_FIELD(experimental_sqlite) = HAVE_SQLITE;
DEFINE_BOOL_FIELD(experimental_stream_iter) = EXPERIMENTALS_DEFAULT_VALUE;
Expand Down
6 changes: 1 addition & 5 deletions test/common/wpt.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -836,11 +836,7 @@ class WPTRunner {
this.resource = new ResourceLoader(path);
this.concurrency = concurrency;

// Since we need to prepare the Web Worker APIs
// in the harness that runs on all WPT workers,
// we enable the API globally. This has no practical
// effect on the non-web-worker tests, however.
this.flags = ['--experimental-web-worker'];
this.flags = [];
this.globalThisInitScripts = [];
this.initScript = null;

Expand Down
2 changes: 1 addition & 1 deletion test/parallel/test-common-wpt-backends.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ const queueProbe = process.env.NODE_TEST_WPT_QUEUE_PROBE === '1';

const harnessPath = fixtures.path('wpt', 'resources', 'testharness.js');
const specPath = fixtures.path('wpt-backends-spec.js');
const execArgv = ['--experimental-web-worker'];
const execArgv = [];

function payload(throws) {
return {
Expand Down
2 changes: 1 addition & 1 deletion test/parallel/test-common-wpt-webworker-error.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ const { Worker } = require('worker_threads');

const workerPath = path.join(__dirname, '../common/wpt/worker.js');
const harnessPath = fixtures.path('wpt', 'resources', 'testharness.js');
const execArgv = ['--experimental-web-worker'];
const execArgv = [];
const workerData = {
testRelativePath: 'workers/error-after-result.any.js',
wptRunner: path.join(__dirname, '../common/wpt.js'),
Expand Down
1 change: 0 additions & 1 deletion test/parallel/test-worker-spec-differences.js
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
// Flags: --experimental-web-worker
'use strict';

const common = require('../common');
Expand Down
Loading