Other Options#

These are the remaining configuration options supported by rspack.

bail#

• Type: boolean
• Default:false

Fail out on the first error instead of tolerating it. By default Rspack will log these errors in red in the terminal, as well as the browser console when using HMR, but continue bundling. To enable it:

module.exports = {
  bail: true,
};

This will force Rspack to exit its bundling process.

dependencies#

• Type: string[]
• Default:undefined

A list of name defining all sibling configurations it depends on. Dependent configurations need to be compiled first.

In watch mode dependencies will invalidate the compiler when:

1. the dependency has changed
2. a dependency is currently compiling or invalid

Remember that current configuration will not compile until its dependencies are done.

module.exports = [
  {
    name: 'client',
    target: 'web',
    // …
  },
  {
    name: 'server',
    target: 'node',
    dependencies: ['client'],
  },
];

ignoreWarnings#

• Type: (RegExp | ((warning: Error, Compilation: Compilation) => boolean))[]
• Default:undefined

Tells Rspack to ignore specific warnings.

module.exports = {
  //...
  ignoreWarnings: [/warning from compiler/, warning => true],
};

name#

• Type: string
• Default:undefined

Name of the configuration. Used when loading multiple configurations.

module.exports = {
  //...
  name: 'admin-app',
};

loader#

• Type: Record<string, any>
• Default:undefined

Expose custom values into the loader context.

For example, you can define a new variable in the loader context:

module.exports = {
  // ...
  loader: {
    answer: 42,
  },
};

Then use this.answer to get its value in the loader:

module.exports = function (source) {
  // ...
  console.log(this.answer); // will log `42` here
  return source;
};

profile#

• Type: boolean
• Default:undefined

Capture a "profile" of the application, including statistics and hints, which can then be dissected using the Analyze tool. It will also log out a summary of module timings.