diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/trim/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/trim/index.md index 492e5aca58b1ef..246fdeaf3ea9f9 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/trim/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/trim/index.md @@ -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")}} @@ -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' ``` ## 规范 diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/trimend/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/trimend/index.md index 9527ae11923dd1..fdc166e866d8a5 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/trimend/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/trimend/index.md @@ -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")}} @@ -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"; @@ -35,7 +35,7 @@ String.prototype.trimRight.name === "trimEnd"; ### 使用 trimEnd() -下面的例子显示小写字符串 `'foo'`: +下面的示例从 `str` 的末尾去除空白字符,但不会去除开头的空白字符。 ```js let str = " foo "; @@ -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()")}} diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/trimstart/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/trimstart/index.md index 65a78a37f9b2c1..f95f23a16a26c6 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/trimstart/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/trimstart/index.md @@ -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")}} @@ -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"; @@ -35,7 +35,7 @@ String.prototype.trimLeft.name === "trimStart"; ### 使用 trimStart() -下面的例子显示小写字符串 `'foo'`: +下面的示例从 `str` 的开头去除空白字符,但不会去除结尾的空白字符。 ```js let str = " foo "; @@ -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()")}}