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.aliasField#

• Type: boolean
• Default: true

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

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", ".tsx", ".ts", ".jsx"]

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

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.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.