Skip to content

Node.js 11.7+ supports Worker + related updates #25012

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

Merged
caugner merged 10 commits into from
Jan 28, 2025
Merged

Node.js 11.7+ supports Worker + related updates #25012

Changes from 5 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
babea79
Update nodejs data for `Worker`
skyclouds2001 Nov 9, 2024
d73a105
update notes
skyclouds2001 Nov 11, 2024
688846f
Merge branch 'main' into node-worker
caugner Nov 12, 2024
097a38b
Merge branch 'main' into node-worker
skyclouds2001 Nov 18, 2024
dd1dc21
Update api/Worker.json
skyclouds2001 Nov 23, 2024
3e2d0ab
Apply suggestions from code review
skyclouds2001 Dec 1, 2024
c01193a
Merge branch 'main' into node-worker
skyclouds2001 Dec 12, 2024
2712777
Apply suggestions from code review
skyclouds2001 Dec 17, 2024
5269ad9
Merge branch 'main' into node-worker
skyclouds2001 Jan 2, 2025
0c261d7
Update api/Worker.json
skyclouds2001 Jan 28, 2025
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
112 changes: 49 additions & 63 deletions api/Worker.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,26 +22,15 @@
"ie": {
"version_added": "10"
},
"nodejs": [
{
"version_added": "12.17.0",
"partial_implementation": true,
"notes": [
"Is a Node `EventEmitter` instead of DOM `EventTarget`.",
"Worker script environment expects CommonJS modules or ECMAScript modules.",
"Must be imported from the `worker_threads` module."
]
},
{
"version_added": "11.7.0",
"partial_implementation": true,
"notes": [
"Is a Node `EventEmitter` instead of DOM `EventTarget`.",
"Worker script environment expects CommonJS modules.",
"Must be imported from the `worker_threads` module."
]
}
],
"nodejs": {
"version_added": "11.7.0",
"partial_implementation": true,
"notes": [
"Inherit from a Node `EventEmitter` instead of DOM `EventTarget`.",
Comment thread
skyclouds2001 marked this conversation as resolved.
Outdated
"Also supports CommonJS modules, enabled for files ending with `.cjs` and for files ending with `.js` when the nearest parent `package.json` file contains a top-level field `\"type\"` with a value not of `\"commonjs\"`.",
"Available as a part of the `worker_threads` module."
]
},
Comment on lines +25 to +33
Copy link
Copy Markdown
Contributor

@caugner caugner Jan 27, 2025

Choose a reason for hiding this comment

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

✅ Verified that worker_threads.Worker exists in v12.0.0, which seems to be the gist of this change.

"oculus": "mirror",
"opera": {
"version_added": "10.6"
Expand Down Expand Up @@ -88,18 +77,11 @@
"ie": {
"version_added": "10"
},
"nodejs": [
{
"version_added": "12.17.0",
"partial_implementation": true,
"notes": "Takes entirely different options."
},
{
"version_added": "11.7.0",
"partial_implementation": true,
"notes": "Takes entirely different options."
}
],
"nodejs": {
"version_added": "11.7.0",
"partial_implementation": true,
"notes": "Takes entirely different options parameters."
},
Comment on lines +80 to +84
Copy link
Copy Markdown
Contributor

@caugner caugner Jan 27, 2025

Choose a reason for hiding this comment

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

✅ Makes sense based on parent change.

"oculus": "mirror",
"opera": {
"version_added": "10.6"
Expand Down Expand Up @@ -318,6 +300,9 @@
"ie": {
"version_added": false
},
"nodejs": {
"version_added": "11.7.0"
},
Comment on lines +303 to +305
Copy link
Copy Markdown
Contributor

@caugner caugner Jan 27, 2025

Choose a reason for hiding this comment

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

✅ Verified locally with this worker.js, created via new worker_threads.Worker('./worker.js'):

const { Worker } = require('worker_threads');
const { writeFileSync } = require('fs');

writeFileSync('./worker.log', Worker, 'utf-8');

"oculus": "mirror",
"opera": "mirror",
"opera_android": "mirror",
Expand Down Expand Up @@ -359,7 +344,9 @@
"version_added": "10"
},
"nodejs": {
"version_added": false
"version_added": "11.7.0",
"partial_implementation": true,
"notes": "Supports the event, but only via Node <code>EventEmitter</code>."
Comment thread
skyclouds2001 marked this conversation as resolved.
Outdated
},
"oculus": "mirror",
"opera": {
Expand Down Expand Up @@ -408,18 +395,11 @@
"ie": {
"version_added": "10"
},
"nodejs": [
{
"version_added": "12.17.0",
"partial_implementation": true,
"notes": "Supports the event, but only via Node `EventEmitter`."
},
{
"version_added": "11.7.0",
"partial_implementation": true,
"notes": "Supports the event, but only via Node `EventEmitter`."
}
],
"nodejs": {
"version_added": "11.7.0",
"partial_implementation": true,
"notes": "Supports the event, but only via Node `EventEmitter`."
},
Comment on lines +401 to +405
Copy link
Copy Markdown
Contributor

@caugner caugner Jan 27, 2025

Choose a reason for hiding this comment

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

✅ Makes sense based on parent change.

"oculus": "mirror",
"opera": {
"version_added": "10.6"
Expand Down Expand Up @@ -468,9 +448,19 @@
"ie": {
"version_added": false
},
"nodejs": {
"version_added": false
},
"nodejs": [
{
"version_added": "14.5.0",
"partial_implementation": true,
"notes": "Supports the event, but only via Node <code>EventEmitter</code>."
Comment thread
skyclouds2001 marked this conversation as resolved.
Outdated
},
{
"version_added": "12.19.0",
"version_removed": "13.0.0",
"partial_implementation": true,
"notes": "Supports the event, but only via Node <code>EventEmitter</code>."
Comment thread
skyclouds2001 marked this conversation as resolved.
Outdated
}
],
Comment on lines +454 to +466
Copy link
Copy Markdown
Contributor

@caugner caugner Jan 27, 2025

Choose a reason for hiding this comment

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

✅ Verified via the referenced PR.

"oculus": "mirror",
"opera": "mirror",
"opera_android": "mirror",
Expand Down Expand Up @@ -542,18 +532,14 @@
"version_added": "10",
"notes": "Internet Explorer does not support `Transferable` objects."
},
"nodejs": [
{
"version_added": "12.17.0",
"partial_implementation": true,
"notes": "Supports `transferList` argument for transferring `ArrayBuffer` and `MessagePort` objects"
},
{
"version_added": "11.7.0",
"partial_implementation": true,
"notes": "Supports `transferList` argument for transferring `ArrayBuffer` and `MessagePort` objects"
}
],
"nodejs": {
"version_added": "11.7.0",
"partial_implementation": true,
"notes": [
"Only support passing the second parameter as an optional array of objects, not support passing the second parameter as an options object.",
Comment thread
skyclouds2001 marked this conversation as resolved.
Outdated
"Only support transferring `ArrayBuffer` and `MessagePort` objects."
Comment thread
skyclouds2001 marked this conversation as resolved.
Outdated
]
},
Comment on lines +541 to +548
Copy link
Copy Markdown
Contributor

@caugner caugner Jan 27, 2025

Choose a reason for hiding this comment

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

✅ Makes sense based on parent change.

New note:

The options parameter is not supported; the second parameter may only be an array of objects to transfer.

"oculus": "mirror",
"opera": {
"version_added": "10.6"
Expand Down Expand Up @@ -602,14 +588,14 @@
},
"nodejs": [
{
"version_added": "12.17.0",
"version_added": "12.5.0",
"partial_implementation": true,
"notes": "Also takes an optional callback to be executed when the worker has terminated."
"notes": "Returns a <code>Promise</code> instead. Taking an optional callback parameter is deprecated."
Comment thread
skyclouds2001 marked this conversation as resolved.
Outdated
},
{
"version_added": "11.7.0",
"partial_implementation": true,
"notes": "Also takes an optional callback to be executed when the worker has terminated."
"notes": "Support taking an optional callback parameter to be executed when the worker has terminated."
Comment thread
skyclouds2001 marked this conversation as resolved.
Outdated
}
],
"oculus": "mirror",
Expand Down
⚡