Skip to content

Commit 539346d

Browse files
authored
Revise translation of js-with-ts (#92)
1 parent 77c9ba3 commit 539346d

File tree

1 file changed

+9
-12
lines changed

1 file changed

+9
-12
lines changed

docs/documentation/zh/javascript/Intro to JS with TS.md

+9-12
Original file line numberDiff line numberDiff line change
@@ -9,23 +9,22 @@ translatable: true
99
在一般的代码中,TypeScript 中的类型系统的严格程度是不一样的:
1010

1111
- 只基于 JavaScript 代码推断
12-
- 增强的 JavaScript 类型推断([通过 JSDoc](/zh/docs/handbook/jsdoc-supported-types.html)
12+
- 增强的 JavaScript 类型推断([通过 JSDoc](/zh/docs/handbook/jsdoc-supported-types.html)
1313
- 在 JavaScript 文件里面使用 `// @ts-check`
1414
- TypeScript 代码
15-
- TypeScript 的 [`strict`](/tsconfig#strict) 模式
15+
- TypeScript 的 [`strict`](/zh/tsconfig#strict) 模式
1616

1717
每一步都代表着向更安全的类型系统迈进,但并不是每个项目都需要级别最高的验证。
1818

1919
## TypeScript 与 JavaScript
2020

21-
在使用某些编辑器时,它可以为使用 TypeScript 提供工具,如自动补全,跳转到特定位置。还有一些重构工具,如重命名。
22-
[主页](/) 有一个包含 TypeScript 插件的编辑器列表。
21+
某些编辑器会使用 TypeScript 来提供帮助,如自动补全,跳转到特定位置。此外还可以帮助重构,如重命名。[主页](/zh)有一个编辑器列表,该列表中的编辑器包含 TypeScript 插件。
2322

2423
## 通过 JSDoc 在 JS 中提供类型提示
2524

2625
`.js` 文件里,类型通常可以被推断出来。当无法推断类型时,可以使用 JSDoc 语法来指定。
2726

28-
声明之前的 JSDoc 注释,将用于设置该声明的类型。例如:
27+
位于声明语句之前的 JSDoc 注释,将用于设置该声明的类型。例如:
2928

3029
```js twoslash
3130
/** @type {number} */
@@ -35,12 +34,11 @@ x = 0; // OK
3534
x = false; // OK?!
3635
```
3736

38-
你可以[JSDoc 支持的类型列表](/zh/docs/handbook/jsdoc-supported-types.html)找到支持的 JSDoc 模式的完整说明
37+
你可以在 [JSDoc 支持的类型列表](/zh/docs/handbook/jsdoc-supported-types.html)找到受支持的 JSDoc 语法的完整说明
3938

4039
## `@ts-check`
4140

42-
上述代码示例的最后一行会在 TypeScript 中引发错误,但在 JS 项目中,默认情况下不会引发错误。
43-
要在 JavaScript 文件显示错误,请在 `.js` 文件的第一行中添加: `// @ts-check`
41+
上述代码示例的最后一行在 TypeScript 中会引发错误,但在 JS 项目中,默认情况下不会引发错误。要使 JavaScript 文件显示错误,请在 `.js` 文件的第一行中添加: `// @ts-check`
4442

4543
```js twoslash
4644
// @ts-check
@@ -52,10 +50,9 @@ x = 0; // OK
5250
x = false; // Not OK
5351
```
5452

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` 注释来跳过检查某些文件。
5754

58-
TypeScript 可能会提供你不想看到的错误,在这种情况下,你可以通过在前一行添加 `// @ts-ignore``// @ts-expect-error` 来忽略某一行上的错误
55+
TypeScript 可能会提供一些你不想看到的错误,在这种情况下,你可以通过在某一行的前一行添加 `// @ts-ignore``// @ts-expect-error` 来忽略该行上的错误
5956

6057
```js twoslash
6158
// @ts-check
@@ -67,4 +64,4 @@ x = 0; // OK
6764
x = false; // Not OK
6865
```
6966

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

Comments
 (0)