TypeScript 编译器 API 的“模块解析缓存”应该如何使用？

Question

我注意到ts.resolveModuleName 有一个可选的cache 参数和一个随附的resolveModuleNameFromCache 函数。我认为它们与缓存已解析的模块名称以提高性能有关，但我不清楚应该如何（以及是否）使用它们。

我很想更好地了解这些缓存，但现在我有两个具体的问题：

1. createModuleResolutionCache 的 currentDirectory 参数应该传递什么？
2. resolveModuleNameFromCache 的字面意思是“仅从缓存中解析”，还是会在必要时退回到“艰苦的工作”？

再次，我很想对这些缓存有一个更好的总体了解，但这些问题的答案已经是朝着正确方向迈出的一大步。

Answer 1

模块解析缓存是一种缓存先前调用解析模块名称的结果的方法。

在内部这是一个标准：

let result = cache.get(key);
if (!result) {
    result = create();
    cache.set(key, result);
}
return result;

使用它的一个例子可以看到here in rollup。我会说它可能更适合使用，但我不知道性能影响是什么样的。

1. createModuleResolutionCache 的 currentDirectory 参数应该传递什么？

如果您有编译器主机或程序，则应提供CompilerHost#getCurrentDirectory() 或Program#getCurrentDirectory() 的结果。如果两者都没有，则使用ts.sys.getCurrentDirectory()，这是使用ts.createCompilerHost 时的默认设置。

1. resolveModuleNameFromCache 的字面意思是“仅从缓存中解析”，还是会在必要时退回到“艰苦的工作”？

它不会做任何艰苦的工作，只会尝试从缓存中获取名称。这是编译器中的当前代码（.get(moduleName) 是 Map#get）：

export function resolveModuleNameFromCache(
    moduleName: string,
    containingFile: string,
    cache: ModuleResolutionCache
): ResolvedModuleWithFailedLookupLocations | undefined {
    const containingDirectory = getDirectoryPath(containingFile);
    const perFolderCache = cache && cache.getOrCreateCacheForDirectory(containingDirectory);
    return perFolderCache && perFolderCache.get(moduleName);
}