编译器配置项-compilerOptions
模块相关(一)
允许任意文件扩展名-allowArbitraryExtensions
在 TypeScript 5.0 中,当导入的文件以非已知 JavaScript 或 TypeScript 文件扩展名结尾时,TypeScript编译器将查找该文件的声明文件({file basename}.d.{extension}.ts )。 例如,如果在需要打包器打包的程序项目中使用CSS loader
,那么需要为这些样式表编写(或生成)声明文件:
/* app.css */
.cookie-banner {
display: none;
}
// app.d.css.ts
declare const css: {
cookieBanner: string;
};
export default css;
// App.tsx
import styles from "./app.css";
styles.cookieBanner; // string
默认情况下,导入css
文件将报告错误:TypeScript无法理解文件类型并且运行时可能不支持。但是,如果已经在运行时或者打包时配置了支持css
文件导入,那么可以通过配置allowArbitraryExtensions
来避免该错误。
注意:
历史上实现类似效果,是通过添加类型声明文件app.css.d.ts
,而不是app.d.css.ts
,但是这只在Node的CommonJS中的require
中生效。严格说来app.css.d.ts
才可以解释为app.css.js
文件的TypeScript的声明文件。由于Node支持的ESM在导入相对文件时需要包含文件扩展名,在我们的ESM类型的文件示例中TypeScript将报错。
允许导入TS文件扩展名-allowImportingTsExtensions
allowImportingTsExtensions
允许TypeScript文件互相导入通过TypeScript特定文件扩展名.ts
、.mts
或者.tsx
。
这个配置项仅当noEmit
或者emitDeclarationOnly
仅当启用 --noEmit
或 --emitDeclarationOnly
时才允许使用此配置项,因为这些导入的文件在JavaScript运行时将无法被解析。这个配置项的目的是使解析器(例如您的捆绑器、运行时或其他一些工具)在.ts
文件互相导入时正常工作。如果没有此标志,使用 UMD 模块的exports
需要导入声明文件。
允许 Umd 全局访问-allowUmdGlobalAccess
当allowUmdGlobalAccess
设置为 true 时,导入UMD的exports
将在当前文件内部作为全局变量。具有import
或者exports
语句的文件时一个模块。如果未配置allowUmdGlobalAccess
,使用 UMD 模块的exports
需要先导入它的声明。
该选项可以在这个典型的示例中使用,一个指定库(如 jQuery 或 Lodash)在Web 项目运行时始终可用,但是却无法通过import
导入。