likes
comments
collection

TypeScript 里的 Reference Type 和 Triple-Slash Direct

作者站长头像
站长
· 阅读数 16

SAP Spartacus 是一个 TypeScript 应用,在有些文件开头,发现了这样的定义:

// '@sapui5/ts-types-esm' package contains types for sap modules, e.g. 'sap/ui/core/Core'
/// <reference types="@sapui5/ts-types-esm" />

对第 31 行的代码按住 Ctrl 再单击鼠标左键:

TypeScript 里的 Reference Type 和 Triple-Slash Direct

直接跳转到了 sap.ui.core.d.ts 文件内部:

TypeScript 里的 Reference Type 和 Triple-Slash Direct

/// 的正式名称叫 Triple-Slash Directives.

三斜杠指令是包含单个 XML 标记的单行注释。 注释的内容用作编译器指令。

三斜杠指令仅在其包含文件的顶部有效。 三斜杠指令前只能有单行或多行注释,包括其他三斜杠指令。 如果在语句或声明之后遇到它们,它们将被视为常规的单行注释,并且没有特殊含义。

/// <reference types="..." /> 指令声明对包的依赖。

解析这些包名的过程类似于在 import 语句中解析模块名的过程。将三斜杠引用类型指令视为声明包的导入的一种简单方法。

例如,在声明文件中包含 /// <reference types="node" /> 声明该文件使用在 @types/node/index.d.ts 中声明的名称;因此,这个包需要与声明文件一起包含在编译中。

仅当手动创作 d.ts 文件时才使用这些指令。

对于编译时产生的声明文件,编译器会自动添加 /// <reference types="..." />;当且仅当生成的文件使用来自引用包的任何声明时,才会在生成的声明文件中添加 /// <reference types="..." />。

要在 .ts 文件中声明对 @types 包的依赖,请在命令行或 tsconfig.json 中使用类型。

TypeScript 里的 Reference Type 和 Triple-Slash Direct

TypeScript 里的 Reference Type 和 Triple-Slash Direct

从这三个 Observable 的 pipe 内的 Operator 能看出这些操作之间的逻辑顺序。TypeScript 里的 Reference Type 和 Triple-Slash Direct

这个 ui5bootstrapped 返回的 Observable,什么时候被 subscribe 呢?

TypeScript 里的 Reference Type 和 Triple-Slash Direct

为什么触发点是 loadVisualization 的 subscribe 调用呢?loadVisualization 和 bootstrapUi5 的关联在哪里?

TypeScript 里的 Reference Type 和 Triple-Slash Direct

答案:loadVisualization 返回的是 this.viewportAdded$, 而 this.viewportAdded$ui5Initialized$ mergedMap 之后的产物,ui5Initialized$ 又是 ui5BootStrapped$ 的产物,因此 this.viewportAdded$ 被 subscribe,一定是 ui5BootStrapped$ 的 subscribe 逻辑最先被执行,然后是 ui5Initialized$,最后才是 this.viewportAdded$.

TypeScript 里的 Reference Type 和 Triple-Slash Direct

运行时调试:ui5BootStrapped$ 最先被调用:

TypeScript 里的 Reference Type 和 Triple-Slash Direct

然后是 initializeUI5:TypeScript 里的 Reference Type 和 Triple-Slash Direct

最后是 addViewport:TypeScript 里的 Reference Type 和 Triple-Slash Direct