@@ -9,23 +9,22 @@ translatable: true
9
9
在一般的代码中,TypeScript 中的类型系统的严格程度是不一样的:
10
10
11
11
- 只基于 JavaScript 代码推断
12
- - 增强的 JavaScript 类型推断([ 通过 JSDoc] ( /zh/docs/handbook/jsdoc-supported-types.html ) )
12
+ - 增强的 JavaScript 类型推断([ 通过 JSDoc] ( /zh/docs/handbook/jsdoc-supported-types.html ) )
13
13
- 在 JavaScript 文件里面使用 ` // @ts-check `
14
14
- TypeScript 代码
15
- - TypeScript 的 [ ` strict ` ] ( /tsconfig#strict ) 模式
15
+ - TypeScript 的 [ ` strict ` ] ( /zh/ tsconfig#strict ) 模式
16
16
17
17
每一步都代表着向更安全的类型系统迈进,但并不是每个项目都需要级别最高的验证。
18
18
19
19
## TypeScript 与 JavaScript
20
20
21
- 在使用某些编辑器时,它可以为使用 TypeScript 提供工具,如自动补全,跳转到特定位置。还有一些重构工具,如重命名。
22
- [ 主页] ( / ) 有一个包含 TypeScript 插件的编辑器列表。
21
+ 某些编辑器会使用 TypeScript 来提供帮助,如自动补全,跳转到特定位置。此外还可以帮助重构,如重命名。[ 主页] ( /zh ) 有一个编辑器列表,该列表中的编辑器包含 TypeScript 插件。
23
22
24
23
## 通过 JSDoc 在 JS 中提供类型提示
25
24
26
25
在 ` .js ` 文件里,类型通常可以被推断出来。当无法推断类型时,可以使用 JSDoc 语法来指定。
27
26
28
- 声明之前的 JSDoc 注释,将用于设置该声明的类型。例如:
27
+ 位于声明语句之前的 JSDoc 注释,将用于设置该声明的类型。例如:
29
28
30
29
``` js twoslash
31
30
/** @type {number} */
@@ -35,12 +34,11 @@ x = 0; // OK
35
34
x = false ; // OK?!
36
35
```
37
36
38
- 你可以 [ 在 JSDoc 支持的类型列表] ( /zh/docs/handbook/jsdoc-supported-types.html ) 找到支持的 JSDoc 模式的完整说明 。
37
+ 你可以在 [ JSDoc 支持的类型列表] ( /zh/docs/handbook/jsdoc-supported-types.html ) 找到受支持的 JSDoc 语法的完整说明 。
39
38
40
39
## ` @ts-check `
41
40
42
- 上述代码示例的最后一行会在 TypeScript 中引发错误,但在 JS 项目中,默认情况下不会引发错误。
43
- 要在 JavaScript 文件显示错误,请在 ` .js ` 文件的第一行中添加: ` // @ts-check ` 。
41
+ 上述代码示例的最后一行在 TypeScript 中会引发错误,但在 JS 项目中,默认情况下不会引发错误。要使 JavaScript 文件显示错误,请在 ` .js ` 文件的第一行中添加: ` // @ts-check ` 。
44
42
45
43
``` js twoslash
46
44
// @ts-check
@@ -52,10 +50,9 @@ x = 0; // OK
52
50
x = false ; // Not OK
53
51
```
54
52
55
- 如果你有许多 JavaScript 文件要显示错误,则可以使用 [ ` jsconfig.json ` ] ( /zh/docs/handbook/tsconfig-json.html ) 来代替注释。
56
- 你可以通过在文件中添加` // @ts-nocheck ` 注释来跳过检查某些文件。
53
+ 如果你有许多 JavaScript 文件要显示错误,则可以使用 [ ` jsconfig.json ` ] ( /zh/docs/handbook/tsconfig-json.html ) 来代替注释。你可以通过在文件中添加 ` // @ts-nocheck ` 注释来跳过检查某些文件。
57
54
58
- TypeScript 可能会提供你不想看到的错误 ,在这种情况下,你可以通过在前一行添加 ` // @ts-ignore ` 或 ` // @ts-expect-error ` 来忽略某一行上的错误 。
55
+ TypeScript 可能会提供一些你不想看到的错误 ,在这种情况下,你可以通过在某一行的前一行添加 ` // @ts-ignore ` 或 ` // @ts-expect-error ` 来忽略该行上的错误 。
59
56
60
57
``` js twoslash
61
58
// @ts-check
@@ -67,4 +64,4 @@ x = 0; // OK
67
64
x = false ; // Not OK
68
65
```
69
66
70
- 要了解有关 TypeScript 如何解释 JavaScript 的更多信息 ,请阅读 [ TS 是如何解释 JS 的] ( /zh/docs/handbook/type-checking-javascript-files.html ) 。
67
+ 要详细了解 TypeScript 如何解释 JavaScript,请阅读 [ TS 是如何检查 JS 的] ( /zh/docs/handbook/type-checking-javascript-files.html ) 。
0 commit comments