0
点赞
收藏
分享

微信扫一扫

TypeScript 里的 Reference Type 和 Triple-Slash Directives


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 Directives_javascript

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

TypeScript 里的 Reference Type 和 Triple-Slash Directives_typescript_02

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

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

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

/// 指令声明对包的依赖。

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

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

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

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

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

TypeScript 里的 Reference Type 和 Triple-Slash Directives_斜杠_03

TypeScript 里的 Reference Type 和 Triple-Slash Directives_bootstrap_04

从这三个 Observable 的 pipe 内的 Operator 能看出这些操作之间的逻辑顺序。

TypeScript 里的 Reference Type 和 Triple-Slash Directives_前端_05

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

TypeScript 里的 Reference Type 和 Triple-Slash Directives_前端_06

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

TypeScript 里的 Reference Type 和 Triple-Slash Directives_javascript_07

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

TypeScript 里的 Reference Type 和 Triple-Slash Directives_斜杠_08

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

TypeScript 里的 Reference Type 和 Triple-Slash Directives_前端_09

然后是 initializeUI5:

TypeScript 里的 Reference Type 和 Triple-Slash Directives_斜杠_10

最后是 addViewport:

TypeScript 里的 Reference Type 和 Triple-Slash Directives_前端_11



举报

相关推荐

0 条评论