Skip to content

Tracking issue: Worker support #13143

Closed
Closed

Description

@addaleax

I’m opening this as a discussion issue, as proposed in #2133 (comment), to see whether and how we can get (Web)Worker support into Node core.

This feature would be comparatively large, there’s quite a bit of pre-existing work that we will want to look at, and I imagine we might want to do an enhancement proposal (EP) first to make sure we don’t engage in too much unnecessary work. I imagine the roadmap is something like this:

  1. Create a new repository in the org to work under, for code, working out the EP text, discussion issues, and so on. This is something I can just do unless anybody objects to that in the near future.
  2. Find volunteers who are willing to do parts of the work, maybe even set up somewhat regular meetings.
  3. See if there are any immediate objections to a feature of this kind becoming a part of Node core.
  4. Figure out what the API should look like; How close to the WebWorker standard could and should we get? How much of Node’s standard modules should be available to workers (e.g.: we’d probably want timers but no I/O modules? or maybe we would want those?)? SharedArrayBuffers? Other magic?
  5. Take a look at work that has been done elsewhere, e.g. workers: initial implementation #2133 or @audreyt’s https://github.com/audreyt/node-webworker-threads, and see how much can be used, what went well/not so well, etc.; Also, I know @bnoordhuis has looked into this a lot, so it would be really good to hear his thoughts.
  6. Write an EP based on discussion around those topics.
  7. Get the CTC to approve that EP.
  8. Work on the actual code, documentation, tests, etc. in that extra repository.
  9. Open a pull request against this repository (nodejs/node) with the new code.

I can probably lead a bit of the effort, and I’ve considered doing this work alone, but so far it always ended at “this would be too much work for me to do on my own”; so if you want to help, please do, but expect to spend some time on this. ❤️

/cc @nodejs/collaborators @petkaantonov @NawarA @pemrouz

Activity

  1. vkurchatkin commented on May 21, 2017

    @vkurchatkin
    Contributor

    Count me in. That's something that I've wanted for a long time to happen.

  2. cjihrig commented on May 21, 2017

    @cjihrig
    Contributor

    I'm interested.

  3. not-an-aardvark commented on May 21, 2017

    @not-an-aardvark
    Contributor

    I'm interested.

  4. aqrln commented on May 21, 2017

    @aqrln
    Contributor

    If there is anything I could be of help, I'll be glad to be involved.

  5. bnoordhuis commented on May 22, 2017

    @bnoordhuis
    Member

    How much of Node’s standard modules should be available to workers

    In a multi-process model it's easy and cheap to expose everything.

    In a multi-thread model a lot of work has to be done for seemingly trivial things. Example: the current working directory is a per-process property, not per-thread. Node needs to be taught to maintain a per-thread working directory and all file system operations must use it henceforth. That requires major surgery to the fs module, process.chdir(), the module loader, etc. Native add-ons probably cannot be made to work at all.

    Another problem with the multi-thread model that the multi-process model doesn't have is that the address space on 32 bits architectures is limited to ~2 GB. A V8 isolate needs a lot of virtual memory to do anything interesting. 10 or 20 threads tops will exhaust the address space and kill the process.

    I'd look into the multi-process model + shared memory. That lets you support SharedArrayBuffer without the headaches of the multi-thread model.

    Cross-platform shared memory has issues of its own but they are tractable: it's mostly working around platform quirks and limitations. Drudge work but nothing that is insurmountable.

  6. eljefedelrodeodeljefe commented on May 22, 2017

    @eljefedelrodeodeljefe
    Contributor

    I was also researching on it, basically concluding to wait for SharedArrayBuffer and then to do a multi-process model. What would help is having Node as shared library.

  7. pemrouz commented on May 22, 2017

    @pemrouz

    Thanks for taking a lead on this @addaleax! You can count on me too :)

  8. NawarA commented on May 22, 2017

    @NawarA

    +1

    I've produced a model of communication that I believe is simple enough, happy to share and help work on some architecture and code. Working together, I'm sure we can produce something simple and great

  9. refack commented on May 22, 2017

    @refack
    Contributor

    Sounds like a very interesting venture.
    Would love to help!

  10. refack commented on May 22, 2017

    @refack
    Contributor

    I'd look into the multi-process model + shared memory.

    That sound like a very JSy concept. I'm +10
    (Which makes this a little like turning cluster into standard complaint and implementing on Windows, for which I'm +100)

  11. zimbabao commented on May 23, 2017

    @zimbabao
    Contributor

    Very interested on working on this, count me in.

  12. bmeck commented on May 23, 2017

    @bmeck
    Member

    I'd be interested but only if we don't implement process level shared mutable state (like what @bnoordhuis was getting at). I'd also lean on not supporting any specific module system (CJS or ESM) in first implementation.

  13. refack commented on May 23, 2017

    @refack
    Contributor

    I'd be interested but only if we don't implement process level shared mutable state (like what @bnoordhuis was getting at). I'd also lean on not supporting any specific module system (CJS or ESM) in first implementation.

    @mbeck that interesting...
    I'm interested in your POV, could you elaborate on two points?

    1. Would you prefer threads with shared mutable state? Or multi-process but with serialized communication?
    2. If no modules, then code can only be passed from the master (a la new Worker(runFunc))?
  14. mhdawson commented on May 23, 2017

    @mhdawson
    Member

    @JiapengZhu this may line up with some of the performance investigation you are looking at.

  15. 8 remaining items

  16. benjamingr commented on Oct 9, 2017

    @benjamingr
    Member

    @jasnell (cc @bnoordhuis )

    Those of us who really want to see this land in core should take some time to articulate why. We will need to do so anyway in some form when we begin talking to end users and encouraging them to use it. What are the use cases we are solving for.

    What do you mean? There is currently no way to utilize all cores on the same memory in Node.js, workers let you do that - letting Node.js support a whole variety of use cases it has traditionally not been able to support.

    For me half of the point is SharedArrayBuffer, this means you can share memory between worker threads in Node.js. The API itself isn't the most critical part, but keep in mind:

    • As you know, you can't share objects between isolates since objects live in an isolate's heap.
    • You can however, share raw bytes.
    • The v8 mechanism already exists and works in browsers (SharedArrayBuffer).
    • Anna's PR uses that mechanism to enable parallelism.

    This is about adding a capability to Node.js. Now, it's certainly not the only API but given we're not going to implement locking throughout V8 and V8 won't implement threading with objects the way Nashhorn supports because it makes no sense for the DOM web platform - I think this is about the best we can do.

    Optimally, I'd like something like sharing objects (and closures) between threads, synchronization primitives like a Mutex and other concurrency primitives - but given how V8 is built that is likely to never happen. Given that - the worker model with shared memory through SharedArrayBuffer is the next best thing.

  17. jasnell commented on Oct 9, 2017

    @jasnell
    Member

    What do you mean....

    Yes, I know all of those reasons, and agree with them. I Was not asking what the use cases are, I was saying that we need to document them rather than assuming that everyone will consider it obvious. This is a significant new capability, code is fantastic, code with motivating and documented detail is even more so.

  18. bnoordhuis commented on Oct 9, 2017

    @bnoordhuis
    Member

    synchronization primitives like a Mutex and other concurrency primitives

    Minor tangent: mutexes, rwlocks, condition variables, barriers, etc. can be constructed out of Atomics.wait() and Atomics.wake().

  19. benjamingr commented on Oct 9, 2017

    @benjamingr
    Member

    Minor tangent: mutexes, rwlocks, condition variables, barriers, etc. can be constructed out of Atomics.wait() and Atomics.wake().

    First of all thanks, I didn't know that. Second of all - IIUC it would still only allow sharing memory in a SharedArrayBuffer (raw, binary(ish) data) - right?

    (At which point the API of Atomics.wait() and Atomics.wake() seems sufficient)

  20. bnoordhuis commented on Oct 9, 2017

    @bnoordhuis
    Member

    @benjamingr Yes, that's right.

  21. yorkie commented on Jan 9, 2018

    @yorkie
    Contributor

    Absolutely awesome that we've ended up with a couple of efforts looking at this. It will be great to see these coalesce into support in core. Definitely all for it! I'm wondering, @yorkie are you planning to be at the collaborator summit in Vancouver BC next week after the Node.js Interactive conference? If so, I'd love to schedule some time for those of us interested in this to meet up and talk through it face to face.

    Sorry about missing you message @jasnell, I'd glad to merge Rokid/node-webworker into core if possible, could we have a discussion about this? Do you have any suggestion?

    /cc @TimothyGu @addaleax

  22. devsnek commented on Jan 9, 2018

    @devsnek
    Member

    if we can make workers use esm imo it would be much nicer than monkey-patching in some require-like method. as to the stuff further up, letting these "workers" handle io, including sockets, would be a pretty cool feature, as annoying as it would be to implement.

    and as a side note, i think every thread implementation i've seen for v8/node has the same issues with v8's heap allocation (including mine and @yorkie's)

  23. yorkie commented on Jan 9, 2018

    @yorkie
    Contributor

    Handling I/O including sockets should be done at WebWorker and easy to implement, but that's just handling in worker, we have to listen connections on master.

    As for ESM in worker, that's good idea, and it could be separately implemented inside worker place :)

  24. TimothyGu commented on Jan 9, 2018

    @TimothyGu
    Member

    I believe ESM in workers are already supported in the https://github.com/ayojs/ayo implementation.

  25. devsnek commented on Jan 9, 2018

    @devsnek
    Member

    those look pretty nice, and they handle seem those heap allocation issues i mentioned earlier, perhaps @addaleax you can look into what needs to be done to get something similar in node core?

  26. added
    workerIssues and PRs related to the worker_threads module and Worker API.
    on Mar 15, 2018
  27. aaronleeatali commented on Mar 26, 2018

    @aaronleeatali

    I wish you can take a look at here. https://github.com/alibaba/AliOS-nodejs/wiki/Workers-in-Node.js-based-on-multithreaded-V8
    We propose a system for asynchronous multithreading with an API confirming to Web Worker standard in Node.js and maybe the performance improvements show that it's worth the effort.

  28. jasnell commented on Sep 21, 2018

    @jasnell
    Member

    @addaleax ... now that things are progressing along nicely with workers, does this issue need to remain open?

  29. apapirovski commented on Oct 26, 2018

    @apapirovski
    Contributor

    Sounds like we can close this? Everything mentioned here has been done. If another tracking issue needed, there should probably be a new one that's more current and isn't as much of a commitment to read through.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    feature requestIssues requesting new Node.js features.workerIssues and PRs related to the worker_threads module and Worker API.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions