no-invalid-triple-slash-reference
注意: 此规则是
recommended
规则集的一部分。在
deno.json
中启用完整规则集:{ "lint": { "rules": { "tags": ["recommended"] } } }
使用 Deno CLI 启用完整规则集:
deno lint --rules-tags=recommended
警告三斜杠引用指令的错误用法。
Deno 支持 types
、path
、lib
和 no-default-lib
的三斜杠引用指令。此 lint
规则检查是否存在无效或格式错误的指令,因为这很可能是错误的。
此外,请注意,在 JavaScript 文件中只允许使用 types
指令。该指令用于告诉
TypeScript 编译器与某个 JavaScript 文件对应的类型定义文件的位置。然而,即使在
v1.10 之前的 Deno 手册中(例如 v1.9.2),也有错误的描述,建议在这种情况下使用
path
指令。实际上,应该使用 types
指令。有关更多详细信息,请参阅
最新手册。因此,此规则还会检测 JavaScript 文件中除 types
之外的指令的使用,并建议将其替换为 types
指令。
无效:
JavaScript
/// <reference path="./mod.d.ts" />
/// <reference no-default-lib="true" />
/// <reference foo="bar" />
// ... 其余的 JavaScript 代码 ...
TypeScript
/// <reference foo="bar" />
// ... 其余的 TypeScript 代码 ...
有效:
JavaScript
/// <reference types="./mod.d.ts" />
/// <reference lib="es2017.string" />
// ... 其余的 JavaScript 代码 ...
TypeScript
/// <reference types="./mod.d.ts" />
/// <reference path="./mod.d.ts" />
/// <reference lib="es2017.string" />
/// <reference no-default-lib="true" />
// ... 其余的 TypeScript 代码 ...