From e53e887fbbf0ef48926d6e1f725e3918f9793651 Mon Sep 17 00:00:00 2001 From: JasonLamv-t Date: Tue, 15 Aug 2023 10:44:53 +0800 Subject: [PATCH 1/3] [zh-cn]: Update translation of String.trimAll() --- .../global_objects/string/trim/index.md | 18 +++++++++--------- .../global_objects/string/trimend/index.md | 12 +++++++----- .../global_objects/string/trimstart/index.md | 12 ++++++------ 3 files changed, 22 insertions(+), 20 deletions(-) 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..878ca981fd4320 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 @@ -7,6 +7,8 @@ slug: Web/JavaScript/Reference/Global_Objects/String/trimEnd **`trimEnd()`** 方法会删除字符串末尾的空白字符。`trimRight()` 是这个方法的别名。 +{{jsxref("String")}} 的 **`trimEnd()`** 方法会从字符串的开头移除空白字符，并返回一个新的字符串，而不会修改原始字符串。`trimRight()` 是该方法的别名。 + {{EmbedInteractiveExample("pages/js/string-trimend.html")}} ## 语法 @@ -19,13 +21,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 +37,7 @@ String.prototype.trimRight.name === "trimEnd"; ### 使用 trimEnd() -下面的例子显示小写字符串 `'foo'`： +下面的示例从 `str` 的末尾去除空白字符，但不会去除开头的空白字符。 ```js let str = " foo "; @@ -57,6 +59,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..08f359dd1eb8a4 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/padEnd", "padEnd()")}} 保持一致，在该方法标准化时，选择了 `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()")}} From 003896bdeb7c91b6fe5e1f9c93b35e1ee4822b33 Mon Sep 17 00:00:00 2001 From: Jason Lam Date: Tue, 15 Aug 2023 14:01:55 +0800 Subject: [PATCH 2/3] Apply suggestions from code review --- .../reference/global_objects/string/trimstart/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 08f359dd1eb8a4..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 @@ -25,7 +25,7 @@ trimLeft() ### 别名 -在 {{jsxref("String/trim", "trim()")}} 标准化后，引擎也实现了非标准的 `trimLeft` 方法。然而，为了与 {{jsxref("String/padEnd", "padEnd()")}} 保持一致，在该方法标准化时，选择了 `trimStart` 作为其名称。出于 Web 兼容性的考虑，`trimLeft` 仍然作为 `trimStart` 的别名，它们引用的是完全相同的函数对象。在某些引擎中，这意味着： +在 {{jsxref("String/trim", "trim()")}} 标准化后，引擎也实现了非标准的 `trimLeft` 方法。然而，为了与 {{jsxref("String/padStart", "padStart()")}} 保持一致，在该方法标准化时，选择了 `trimStart` 作为其名称。出于 Web 兼容性的考虑，`trimLeft` 仍然作为 `trimStart` 的别名，它们引用的是完全相同的函数对象。在某些引擎中，这意味着： ```js String.prototype.trimLeft.name === "trimStart"; From 48d2cbcb0540f7df934f3aca1d4cd74ed2dd55cb Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Tue, 15 Aug 2023 23:28:24 +0800 Subject: [PATCH 3/3] Update files/zh-cn/web/javascript/reference/global_objects/string/trimend/index.md --- .../javascript/reference/global_objects/string/trimend/index.md | 2 -- 1 file changed, 2 deletions(-) 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 878ca981fd4320..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,8 +5,6 @@ slug: Web/JavaScript/Reference/Global_Objects/String/trimEnd {{JSRef}} -**`trimEnd()`** 方法会删除字符串末尾的空白字符。`trimRight()` 是这个方法的别名。 - {{jsxref("String")}} 的 **`trimEnd()`** 方法会从字符串的开头移除空白字符，并返回一个新的字符串，而不会修改原始字符串。`trimRight()` 是该方法的别名。 {{EmbedInteractiveExample("pages/js/string-trimend.html")}}