Guide
Config
Plugin
API
Blog
About
Contribute
Guide
Config
Plugin
API
Blog
About
Contribute
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

Added in v0.2.6

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

Usage

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:

INFO

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

WARNING

  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

worker-loader

Added in v0.7.4
WARNING

worker-loader is provided only as a temporary solution to facilitate project migration to Rspack. It is recommended to use the new Worker() syntax instead.

Rspack also supports worker-loader. However, since worker-loader is no longer maintained, please use worker-rspack-loader as a replacement.

Use resolveLoader to replace worker-loader with worker-rspack-loader:

module.exports = {
  resolveLoader: {
    alias: {
      'worker-loader': require.resolve('worker-rspack-loader'),
    },
  },
};
ON THIS PAGE