codeSplitting

• Type: boolean | object with the properties below
• Optional

Defined in: options/output-options.ts:582

Controls how code splitting is performed.

• true: Default behavior, automatic code splitting. (default)
• false: Inline all dynamic imports into a single bundle (equivalent to deprecated inlineDynamicImports: true).
• object: Advanced manual code splitting configuration.

For deeper understanding, please refer to the in-depth documentation.

WARNING

Be aware that manual code splitting can change the behavior of the application if side effects are triggered before the corresponding modules are actually used. You can change the chunking configuration to group some modules so that the modules are reordered, or you can use the output.strictExecutionOrder option to ensure that modules are executed in the order they are imported with the cost of a slight increase in bundle size.

Example

Basic vendor chunk

export default defineConfig({
  output: {
    codeSplitting: {
      minSize: 20000,
      groups: [
        {
          name: 'vendor',
          test: /node_modules/,
        },
      ],
    },
  },
});

Multiple chunk groups with priorities

export default defineConfig({
  output: {
    codeSplitting: {
      groups: [
        {
          name: 'react-vendor',
          test: /node_modules[\\/]react/,
          priority: 20,
        },
        {
          name: 'ui-vendor',
          test: /node_modules[\\/]antd/,
          priority: 15,
        },
        {
          name: 'vendor',
          test: /node_modules/,
          priority: 10,
        },
        {
          name: 'common',
          minShareCount: 2,
          minSize: 10000,
          priority: 5,
        },
      ],
    },
  },
});

Size-based splitting

export default defineConfig({
  output: {
    codeSplitting: {
      groups: [
        {
          name: 'large-libs',
          test: /node_modules/,
          minSize: 100000, // 100KB
          maxSize: 250000, // 250KB
          priority: 10,
        },
      ],
    },
  },
});

Default

true

groups?

• Type: CodeSplittingGroup[]
• Optional

Defined in: options/output-options.ts:940

Groups to be used for code splitting.

includeDependenciesRecursively?

• Type: boolean
• Optional

Defined in: options/output-options.ts:916

By default, each group will also include captured modules' dependencies. This reduces the chance of generating circular chunks.

If you want to disable this behavior, it's recommended to both set

• preserveEntrySignatures: false | 'allow-extension'
• strictExecutionOrder: true

to avoid generating invalid chunks.

Default

true

maxModuleSize?

• Type: number
• Optional

Defined in: options/output-options.ts:928

Global fallback of group.maxModuleSize, if it's not specified in the group.

maxSize?

• Type: number
• Optional

Defined in: options/output-options.ts:924

Global fallback of group.maxSize, if it's not specified in the group.

minModuleSize?

• Type: number
• Optional

Defined in: options/output-options.ts:932

Global fallback of group.minModuleSize, if it's not specified in the group.

minShareCount?

• Type: number
• Optional

Defined in: options/output-options.ts:936

Global fallback of group.minShareCount, if it's not specified in the group.

minSize?

• Type: number
• Optional

Defined in: options/output-options.ts:920

Global fallback of group.minSize, if it's not specified in the group.