no-invalid-triple-slash-reference
注意: 此规则是
recommended
规则集的一部分。在
deno.json
中启用完整规则集{ "lint": { "tags": ["recommended"] } }
使用 Deno CLI 启用完整规则集
deno lint --tags=recommended
警告三斜线引用指令的错误用法。
Deno 支持 types
、path
、lib
和 no-default-lib
的三斜线引用指令。此 lint 规则检查是否存在无效、格式错误的指令,因为这很可能是一个错误。
此外,请注意,只有 types
指令允许在 JavaScript 文件中使用。此指令对于告知 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" />
// ... the rest of the JavaScript ...
TypeScript
/// <reference foo="bar" />
// ... the rest of the TypeScript ...
有效
JavaScript
/// <reference types="./mod.d.ts" />
/// <reference lib="es2017.string" />
// ... the rest of the JavaScript ...
TypeScript
/// <reference types="./mod.d.ts" />
/// <reference path="./mod.d.ts" />
/// <reference lib="es2017.string" />
/// <reference no-default-lib="true" />
// ... the rest of the TypeScript ...