worker: add support for Web Workers

[avivkeller]

Fixes: #43583

Adds support for the Web Worker API as defined by the HTML Standard:
https://html.spec.whatwg.org/multipage/workers.html

The implementation trys to follow the specification as close as Node.js allows, so note the following differences:

• SharedWorker is not implemented. Its lifetime and sharing model depend on origins and browsing contexts, concepts that do not exist in Node.js.

• Worker scripts are loaded synchronously from the local filesystem rather than fetched over the network. As a result:

  • new Worker() and importScripts() accept only file:, data:, and blob: URLs.
  • Any other scheme throws a NotSupportedError.
  • An unreadable script throws a NetworkError (per the spec, this is emitted as an error event).
  • Redirects, nosniff, and HTTP MIME type validation are not applicable. MIME type validation is performed only for data: and blob: URLs.
  • WorkerOptions.credentials is validated for API compatibility but otherwise has no effect, since no network request is made.

• Node.js has no origin model. Consequently, concepts such as same-origin and cross-origin do not exist, and location.origin is null for file: workers.

• close() terminates the worker immediately instead of following the specification's "closing flag" algorithm. Code remaining in the current task after close() is therefore not executed.

• The worker global is the normal Node.js global object with DedicatedWorkerGlobalScope inserted into its prototype chain rather than the inverse (a fresh global created from the interface). Additionally, classic file: workers are executed through the CommonJS/ESM loaders rather than as classic scripts, so top-level declarations do not become global properties. Classic data: and blob: workers continue to execute as classic scripts.

• ErrorEvents dispatched to Worker instances include message and error, but not filename, lineno, or colno. Unhandled worker errors are also not propagated further. These are a result of the worker_threads implementation that is underneath the web workers implemantion.

• The following WorkerGlobalScope events are never dispatched:

  • languagechange, online, and offline, since these concepts do not exist in Node.js.
  • rejectionhandled and unhandledrejection, since Node.js exposes equivalent process-level events but does not implement the PromiseRejectionEvent interface or the per-rejection preventDefault() behavior required by the HTML Standard.

• On the main thread, relative worker script URLs are resolved against the current working directory because there is no document base URL. Within a worker, relative URLs resolve against the worker's own URL, matching the specification.

AI Disclaimer: I used slight AI help to resolve issues that came up during me validating the WPT tests.

TODO before merge:

• test WPT Report upload against staging.wpt.fyi with @panva

[nodejs-github-bot]

Review requested:

• @nodejs/loaders
• @nodejs/startup
• @nodejs/web-standards

[avivkeller]

I'm not sure if I should break the WPT additions into their own commit / PR for ease of reviewing?

You should be able to collapse the test folder to view the lib impl changes

Finally, I haven't added dedicated tests for this outside of the WPT, which should cover it.

[jasnell]

The web platform tests in this PR really ought to be separated out into a separate commit to make reviewing this easier. 1300+ files changes with 54k+ lines changed is very difficult to review in a single commit.

[avivkeller]

The web platform tests in this PR really ought to be separated out into a separate commit to make reviewing this easier. 1300+ files changes with 54k+ lines changed is very difficult to review in a single commit.

Broken up! c73f2fe has the actual changes

[codecov]

Codecov Report

❌ Patch coverage is 93.56568% with 72 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.29%. Comparing base (8a1ca0f) to head (ab76b13).
⚠️ Report is 36 commits behind head on main.

Files with missing lines	Patch %	Lines
lib/internal/webworker.js	92.63%	72 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #64894      +/-   ##
==========================================
+ Coverage   90.14%   90.29%   +0.14%     
==========================================
  Files         746      763      +17     
  Lines      242849   248612    +5763     
  Branches    45771    46800    +1029     
==========================================
+ Hits       218906   224473    +5567     
- Misses      15438    15569     +131     
- Partials     8505     8570      +65     

Files with missing lines	Coverage Δ
lib/internal/blob.js	89.40% <100.00%> (-0.46%)	⬇️
...internal/bootstrap/web/exposed-window-or-worker.js	93.89% <100.00%> (+0.09%)	⬆️
lib/internal/encoding.js	96.66% <100.00%> (+0.04%)	⬆️
lib/internal/event_target.js	98.78% <100.00%> (-0.40%)	⬇️
lib/internal/main/worker_thread.js	94.91% <100.00%> (+0.55%)	⬆️
lib/internal/modules/helpers.js	98.92% <100.00%> (-0.01%)	⬇️
lib/internal/navigator.js	98.78% <100.00%> (+<0.01%)	⬆️
lib/internal/process/pre_execution.js	97.26% <100.00%> (-0.70%)	⬇️
lib/internal/webidl.js	99.10% <100.00%> (-0.35%)	⬇️
lib/internal/worker.js	96.76% <100.00%> (+0.01%)	⬆️
... and 5 more

... and 93 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[mcollina]

This is gargantuan. Can you add a review guide and/or split into chunks?

[panva]

I have:

• added a commit to accomodate multi-global WPT tests in the runner and reporter
• added a TODO to the description when this stabilizes to test the daily WPT Report upload against staging.wpt.fyi

[avivkeller]

This is gargantuan. Can you add a review guide and/or split into chunks?

It's only extremely large due to the added WPT tests. You can make it easier to review by

1. Not reviewing the WPT test commit (the second commit in the PR), or
2. Collapsing the test/fixtures folder in the GitHub UI

[avivkeller]

Right now this implementation converts blob: URLs to data: URLs since the ESM loader doesn't support blob: URLs.

I can change the ESM loader for closer adherence to the spec, but iirc last time I suggested to do that we were concerned about how loader threads would handle blob URLs.

@nodejs/loaders opinions?

[avivkeller]

@panva I changed the web crypto add it to the protoype rather than the instance, can you TAL and make sure it's still what you want?

[panva]

@panva I changed the web crypto add it to the protoype rather than the instance, can you TAL and make sure it's still what you want?

LGTM