Resolve#

Used to configure the Rspack module resolution logic.

• Type: Object

resolve.alias#

• Type: Record<string, false | string | (string | false)[]>
• Default: {}

Path alias, e.g.

At this point:

• require("@/a") will attempt to resolve <root>/src/a.
• require("abc") will attempt to resolve <root>/src/abc.
• require("abc/file.js") will not match, and it will attempt to resolve node_modules/abc/file.js.

resolve.browserField#

• Type: boolean
• Default: true

Whether to resolve according to the package-browser-filed-spec rule.

Works the same with enhanced-resolve's resolve.aliasFields = ["browser"].

resolve.conditionNames#

• Type: string[]
• Default: []

Same as node's conditionNames for the exports and imports fields in package.json.

resolve.extensions#

• Type: string[]
• Default: [".js", ".json", ".wasm"]

Parse modules in order, e.g. require('. /index'), will try to parse '. /index.js', '. /index.json'...

resolve.extensionAlias#

• Type: Record<string, string[] | string>
• Default: {}

Define alias for the extension. e.g.

// rspack.config.js
module.exports = {
  resolve: {
    extensionAlias: {
      '.js': ['.ts', '.js'],
    },
  },
};

require('./index.js') will try to parse './index.ts', ./index.js.

resolve.fallback#

• Type: Record<string, false | string>
• Default: {}

Redirect in case of failed parsing.

resolve.mainFields#

• Type: string[]
• Default:
  • target is ["browser", "module", "main"] when it is web
  • ["module", "main"] for others

Try to parse the fields in package.json, e.g.

// package.json
{
  "name": "lib",
  "module": "es/index.js"
}

then import value from 'lib' results in lib/es/index.js.

resolve.mainFiles#

• Type: string[]
• default: ["index"]

The filename suffix when resolving directories, e.g. require('. /dir/') will try to resolve '. /dir/index'.

resolve.exportsFields#

• Type: string[]
• Default: ["exports"]

Customize the exports field in package.json. e.g.

// lib/package.json
{
  "name": "lib",
  "testExports": {
    ".": "./test.js"
  },
  "exports": {
    ".": "./index.js"
  }
}

When this configuration is ["testExports", "exports"], the result of import value from 'lib' is lib/test.js.

resolve.modules#

• Type: string[]
• Default: ["node_modules"]

The name of the directory to use when resolving dependencies.

resolve.preferRelative#

• Type: boolean
• Default: false

When enabled, require('file') will first look for the . /file file in the current directory, not <modules>/file.

resolve.tsConfigPath#

• Type: string | undefined
• Default: undefined

If you pass the path of tsconfig.json via the option, Rspack will try to resolve modules based on the paths and baseUrl of tsconfig.json, functionally equivalent to tsconfig-paths-webpack-plugin.

const path = require('path');

/** @type {import('@rspack/cli').Configuration} */
const config = {
  // ...
  resolve: {
    tsConfigPath: path.resolve(__dirname, 'tsconfig.json'),
  },
  // ...
};
module.exports = config;

Click to see the example.

resolve.tsConfig#

• Type: object
• Default: undefined

module.exports = {
  resolve: {
    tsconfig: {
      configFile: path.resolve(__dirname, './tsconfig.json'),
      references: 'auto',
    },
  },
};

resolve.tsConfig.configFile#

• Type: string

Same as resolve.tsConfigPath.

If you pass the path of tsconfig.json via the option, Rspack will try to resolve modules based on the paths and baseUrl of tsconfig.json, functionally equivalent to tsconfig-paths-webpack-plugin.

resolve.tsConfig.references#

• Type: string[] | "auto" | undefined
• Default: undefined

Supports tsconfig project references defined in tsconfig-paths-webpack-plugin.

The list of tsconfig paths can be provided manually, or you may specify auto to read the paths list from tsconfig.references automatically.

This feature is disabled when the value is undefined.

resolve.fullySpecified#

• Type: boolean
• Default: false

No longer resolve extensions, no longer resolve mainFiles in package.json (but does not affect requests from mainFiles, browser, alias).

resolve.byDependency#

• Type: Record<string, Resolve>.

Customize the Resolve configuration based on the module type.