#output.module

• Type: boolean
• Default: true when output.target is node, otherwise false

Whether to output JavaScript files in ES modules format.

#Web applications

When building a web application, Rsbuild generates the output in the IIFE format by default.

If you want to output ES Modules instead, set output.module to true:

export default {
  output: {
    module: true,
  },
};

#Web Workers

When output.target is 'web-worker', set output.module to true to output an ES module worker bundle, for example for runtimes that load workers with type: 'module':

export default {
  output: {
    target: 'web-worker',
    module: true,
  },
};

#Node.js applications

When building Node.js applications, Rsbuild outputs ES modules format by default. You can set output.module to false to output CommonJS format instead:

export default {
  output: {
    target: 'node',
    module: false,
  },
};

#Running ESM bundles

Choose either of the following approaches to run ESM bundles in Node.js:

1. Set the type field in package.json to 'module':

{
  "type": "module"
}

2. Change the output JavaScript file extension to .mjs:

export default {
  output: {
    filename: {
      js: '[name].mjs',
    },
  },
};

#Version history