Boost Node.js Performance with Worker Threads: A Hands‑On Guide

Node.js runs JavaScript code in a single thread, meaning your code can only execute one task at a time. However, Node.js itself is multithreaded and uses the libuv library to provide hidden threads that handle I/O operations such as reading files from disk or network requests.

Even though Node.js has hidden threads, developers cannot use them for CPU‑intensive tasks like complex calculations, image resizing, or video encoding. Because JavaScript runs on a single thread for CPU‑intensive work, it blocks the main thread and no other code runs until the task finishes. Without additional threads, the only way to speed up such tasks is to increase processor speed.

In recent years CPUs have not become faster; instead computers are equipped with more cores, often eight or more. Despite this trend, your code does not take advantage of extra cores to accelerate CPU‑intensive tasks or avoid blocking the main thread, because JavaScript remains single‑threaded.

To address this, Node.js introduced the worker‑threads module, which allows developers to create threads and execute multiple JavaScript tasks in parallel. Once a thread finishes, it sends a message to the main thread containing the result, which can then be used by the rest of the code. The benefit of worker threads is that CPU‑intensive work no longer blocks the main thread; you can split a task and distribute it among multiple workers to optimize performance.

In the following example, a Node.js application that contains a CPU‑blocking task is created. The worker‑threads module is then used to move the CPU‑intensive work to another thread, preventing the main thread from being blocked. Finally, the CPU‑bound task is divided and processed in parallel by four threads to speed up execution.

Basic usage of the worker‑threads module:

const { Worker, isMainThread, parentPort, workerData } = require('node:worker_threads');

if (isMainThread) {
  module.exports = function parseJSAsync(script) {
    return new Promise((resolve, reject) => {
      const worker = new Worker(__filename, {
        workerData: script
      });
      worker.on('message', resolve);
      worker.on('error', reject);
      worker.on('exit', (code) => {
        if (code !== 0)
          reject(new Error(`Worker stopped with exit code ${code}`));
      });
    });
  };
} else {
  const { parse } = require('some-js-parsing-library');
  const script = workerData;
  parentPort.postMessage(parse(script));
}