CC 4.0 License

The content of this section is derived from the content of the following links and is subject to the CC BY 4.0 license.

The following contents can be assumed to be the result of modifications and deletions based on the original contents if not specifically stated.

Web Workers

Web Workers are first-class citizens of Rspack, which means you don't need any loader to use Web Workers directly.


new Worker(new URL('./worker.js', import.meta.url));
new Worker(new URL('./worker.js', import.meta.url), {
  name: 'my-worker', // <-- When the value of the name property can be statically analyzed, the worker's chunk name can be customized with this property to replace the [name] placeholder when the chunk file is generated

For examples:


The syntax was chosen to allow running code without bundler, it is also available in native ECMAScript modules in the browser.

  1. Note that new Worker can also accept a string representation of a URL, but only passing in URLs is supported in Rspack.

  2. Rspack does not support the use of variables in new Worker. For example, the following code will not work:

    const url = new URL('./path/to/worker.js', import.meta.url);
    const worker = new Worker(url);

    This is because Rspack cannot statically analyze the syntax. Please be sure to note this limitation when using the Worker syntax in Rspack.

  3. The current implementation supports most of the common usage scenarios, the following uncommon scenarios are still not supported

    • Customized worker syntax from module.parser.javascript.worker is not supported
    • Worker syntax for function calls such as navigator.serviceWorker.register() is not supported
    • Not supported /* webpackEntryOptions: { filename: "workers/[name].js" } */ magic comments