Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[zh-cn]: Update translation of String.trim* #15119

Merged
merged 3 commits into from
Aug 15, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,9 @@ slug: Web/JavaScript/Reference/Global_Objects/String/trim

{{JSRef}}

**`trim()`** 方法从字符串的两端清除空格,返回一个新的字符串,而不修改原始字符串。此上下文中的空格是指所有的空白字符(空格、tab、不换行空格等)以及所有行终止符字符(如 LF、CR 等)。
{{jsxref("String")}} 的 **`trim()`** 方法会从字符串的两端移除空白字符,并返回一个新的字符串,而不会修改原始字符串。

要返回一个仅从一端修剪空白字符的新字符串,请使用 {{jsxref("String.prototype.trimStart()", "trimStart()")}} 或 {{jsxref("String.prototype.trimEnd()", "trimEnd()")}}。

{{EmbedInteractiveExample("pages/js/string-trim.html")}}

Expand All @@ -17,21 +19,19 @@ trim()

### 返回值

一个表示 `str` 去掉了开头和结尾的空白字符后的新字符串。

如果 `str` 的开头和结尾都没有空白字符,仍然会返回一个新字符串(本质上是 `str` 的副本),而不会抛出异常。
一个新的字符串,表示从 `str` 的开头和结尾去除空白字符后的结果。空白字符定义为[空白符](/zh-CN/docs/Web/JavaScript/Reference/Lexical_grammar#空白符)加上[行终止符](/zh-CN/docs/Web/JavaScript/Reference/Lexical_grammar#行终止符)。

要返回一个只从一端删除空白字符的新字符串,可以使用 {{jsxref("String.prototype.trimStart()", "trimStart()")}} 或 {{jsxref("String.prototype.trimEnd()", "trimEnd()")}}
如果 `str` 的开头和结尾都没有空白字符,仍然会返回一个新的字符串(实际上是 `str` 的副本)

## 示例

### 使用 `trim()`
### 使用 trim()

下面的例子显示小写字符串 `'foo'`
下面的示例从 `str` 的两端去除空白字符

```js
const orig = " foo ";
console.log(orig.trim()); // 'foo'
const str = " foo ";
console.log(str.trim()); // 'foo'
```

## 规范
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Web/JavaScript/Reference/Global_Objects/String/trimEnd

{{JSRef}}

**`trimEnd()`** 方法会删除字符串末尾的空白字符。`trimRight()` 是这个方法的别名
{{jsxref("String")}} 的 **`trimEnd()`** 方法会从字符串的开头移除空白字符,并返回一个新的字符串,而不会修改原始字符串。`trimRight()` 是该方法的别名

{{EmbedInteractiveExample("pages/js/string-trimend.html")}}

Expand All @@ -19,13 +19,13 @@ trimRight()

### 返回值

一个表示 `str` 去掉了末尾(右侧)的空白字符后的新字符串
一个新的字符串,表示从 `str` 的末尾(右侧)去除空白字符后的结果。空白字符定义为[空白符](/zh-CN/docs/Web/JavaScript/Reference/Lexical_grammar#空白符)加上[行终止符](/zh-CN/docs/Web/JavaScript/Reference/Lexical_grammar#行终止符)

如果 `str` 的末尾没有空白字符,仍然会返回一个新字符串(本质上是 `str` 的副本),不会抛出异常
如果 `str` 的末尾没有空白字符,仍然会返回一个新的字符串(实际上是 `str` 的副本)。

### 别名

为了与 {{jsxref("String.prototype.padEnd")}} 等函数保持一致,标准方法名称为 `trimEnd`。但是,出于 Web 兼容性原因,`trimRight` 仍然是 `trimEnd` 的别名。在某些引擎中,这意味着:
在 {{jsxref("String/trim", "trim()")}} 标准化后,引擎也实现了非标准的 `trimRight` 方法。然而,为了与 {{jsxref("String/padEnd", "padEnd()")}} 保持一致,在该方法标准化时,选择了 `trimEnd` 作为其名称。出于 Web 兼容性的考虑,`trimRight` 仍然作为 `trimEnd` 的别名,它们引用的是完全相同的函数对象。在某些引擎中,这意味着:

```js
String.prototype.trimRight.name === "trimEnd";
Expand All @@ -35,7 +35,7 @@ String.prototype.trimRight.name === "trimEnd";

### 使用 trimEnd()

下面的例子显示小写字符串 `'foo'`:
下面的示例从 `str` 的末尾去除空白字符,但不会去除开头的空白字符。

```js
let str = " foo ";
Expand All @@ -57,6 +57,6 @@ console.log(str); // ' foo'

## 参见

- [Polyfill of `String.prototype.trimEnd` in `core-js`](https://github.com/zloirock/core-js#ecmascript-string-and-regexp)
- [`core-js` 中 `String.prototype.trimEnd` 的 polyfill](https://github.com/zloirock/core-js#ecmascript-string-and-regexp)
- {{jsxref("String.prototype.trim()")}}
- {{jsxref("String.prototype.trimStart()")}}
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Web/JavaScript/Reference/Global_Objects/String/trimStart

{{JSRef}}

**`trimStart()`** 方法会删除字符串开头的空白字符。`trimLeft()` 是此方法的别名
{{jsxref("String")}} 的 **`trimStart()`** 方法会从字符串的开头移除空白字符,并返回一个新的字符串,而不会修改原始字符串。`trimLeft()` 是该方法的别名

{{EmbedInteractiveExample("pages/js/string-trimstart.html")}}

Expand All @@ -19,13 +19,13 @@ trimLeft()

### 返回值

一个表示 `str` 去掉了开头(左侧)的空白字符后的新字符串
一个新的字符串,表示从 `str` 的开头(左侧)去除空白字符后的结果。空白字符定义为[空白符](/zh-CN/docs/Web/JavaScript/Reference/Lexical_grammar#空白符)加上[行终止符](/zh-CN/docs/Web/JavaScript/Reference/Lexical_grammar#行终止符)

如果 `str` 的开头没有空白字符,仍然会返回一个新字符串(本质上是 `str` 的副本),不会抛出异常
如果 `str` 的开头没有空白字符,仍然会返回一个新的字符串(实际上是 `str` 的副本)。

### 别名

为了与 {{jsxref("String.prototype.padStart")}} 等函数保持一致,标准方法名称为 `trimStart`。但是,出于 Web 兼容性原因,`trimLeft` 仍然是 `trimStart` 的别名。在某些引擎中,这意味着:
在 {{jsxref("String/trim", "trim()")}} 标准化后,引擎也实现了非标准的 `trimLeft` 方法。然而,为了与 {{jsxref("String/padStart", "padStart()")}} 保持一致,在该方法标准化时,选择了 `trimStart` 作为其名称。出于 Web 兼容性的考虑,`trimLeft` 仍然作为 `trimStart` 的别名,它们引用的是完全相同的函数对象。在某些引擎中,这意味着:

```js
String.prototype.trimLeft.name === "trimStart";
Expand All @@ -35,7 +35,7 @@ String.prototype.trimLeft.name === "trimStart";

### 使用 trimStart()

下面的例子显示小写字符串 `'foo'`:
下面的示例从 `str` 的开头去除空白字符,但不会去除结尾的空白字符。

```js
let str = " foo ";
Expand All @@ -57,6 +57,6 @@ console.log(str); // 'foo '

## 参见

- [Polyfill of `String.prototype.trimStart` in `core-js`](https://github.com/zloirock/core-js#ecmascript-string-and-regexp)
- [`core-js` 中 `String.prototype.trimStart` 的 polyfill](https://github.com/zloirock/core-js#ecmascript-string-and-regexp)
- {{jsxref("String.prototype.trim()")}}
- {{jsxref("String.prototype.trimEnd()")}}