Rspack Resolver

[!注意]
这是一个 oxc-resolver 的分支，将在 Rspack 中使用，因为 oxc-resolver 本身的目标不是与 enhanced-resolve 完全兼容，我们可能会添加一些 enhanced-resolve 特定功能，例如在将来添加 pnp 支持 和 替代支持。

enhanced-resolve 的 Rust 版本。

• 内置 [tsconfig-paths-webpack-plugin]
  • 支持扩展 tsconfig.extends 中定义的 tsconfig
  • 支持在 tsconfig.compilerOptions.paths 中定义的路径别名
  • 支持在 tsconfig.references 中定义的项目引用
  • 支持 模板变量 ${configDir} 用于替换配置文件目录路径
• 通过 FileSystem 特性支持内存文件系统
• 包含 tracing 仪器

用法

以下用法适用于 Rust 和 Node.js；代码片段是用 JavaScript 编写的。

要处理 package.json 中的 exports 字段，ESM 和 CJS 需要区分。

ESM

根据 ESM 解析算法

defaultConditions 是条件环境名称数组，["node", "import"]。

这意味着当调用者是 ESM 导入（import "module"）时，解析选项应该是

{
  "conditionNames": ["node", "import"]
}

CJS

根据 CJS 解析算法

LOAD_PACKAGE_EXPORTS(X, DIR)

5. 让MATCH等于在ESM解析器中定义的PACKAGE_EXPORTS_RESOLVE(pathToFileURL(DIR/NAME), "." + SUBPATH, package.json "exports", ["node", "require"])，这是一个JSON文件。

这意味着当调用者是CJS require (require("module"))时，解析选项应该是

{
  "conditionNames": ["node", "require"]
}

缓存

支持CJS和ESM使用相同的缓存

const esmResolver = ResolverFactory({
  conditionNames: ["node", "import"]
});

const cjsResolver = esmResolver.cloneWithOptions({
  conditionNames: ["node", "require"]
});

浏览器字段

来自这个非标准规范

当将模块打包供客户端使用时，browser字段提供给JavaScript打包器或组件工具。

选项是

{
  "aliasFields": ["browser"]
}

主字段

{
  "mainFields": ["module", "main"]
}

引用esbuild的文档

• main - 这是标准字段，用于所有打算与Node一起使用的包。名称main是硬编码在Node的模块解析逻辑中的。因为它打算与Node一起使用，所以可以合理地期望该字段中的文件路径是CommonJS风格的模块。
• module - 这个字段来自一个提案，用于将ECMAScript模块集成到Node中。因此，可以合理地期望该字段中的文件路径是ECMAScript风格的模块。这个提案没有被Node采纳（Node使用"type": "module"），但它被主要的打包器采纳，因为ECMAScript风格的模块可以实现更好的tree shaking，即移除死代码。
• browser - 这个字段来自一个提案，允许打包器用其浏览器友好的版本替换特定于Node的文件或模块。它允许你指定一个替代的浏览器特定入口点。请注意，一个包可以使用browser和module字段同时指定（见下面的说明）。

错误

• Error: Package subpath '.' is not defined by "exports" in - 在没有conditionNames的情况下解析时发生。

选项

选项与[enhanced-resolve]对齐。

未实现选项