From 88ec1c1c2a916c83d5888dd929e588d52e0cf309 Mon Sep 17 00:00:00 2001 From: JasonLamv-t Date: Wed, 5 Jul 2023 09:43:05 +0800 Subject: [PATCH 1/4] [zh-cn]: Update translation of String.length --- .../global_objects/string/length/index.md | 40 +++++++++++-------- 1 file changed, 23 insertions(+), 17 deletions(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md index 3f5e8a42028888..2ccb6c032aa5cb 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md @@ -5,32 +5,35 @@ slug: Web/JavaScript/Reference/Global_Objects/String/length {{JSRef}} -字符串的 **`length`** 只读属性包含字符串的长度（以 UTF-16 代码单元表示）。 - -{{js_property_attributes(0, 0, 0)}} +{{jsxref("String")}} 类型的 **`length`** 数据属性表示字符串的 UTF-16 码元长度。 {{EmbedInteractiveExample("pages/js/string-length.html", "shorter")}} +## 值 + +一个非负整数。 + +{{js_property_attributes(0, 0, 0)}} + ## 描述 -该属性返回字符串中的代码单元数量。JavaScript 使用 [UTF-16](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇（grapheme_clusters）) 编码，其中每个 Unicode 字符可以编码为一个或两个代码单元，因此 `length` 返回的值可能与字符串中 Unicode 字符的实际数量不匹配。对于拉丁文、西里尔文、众所周知的 CJK 字符等常见脚本，这应该不是问题，但如果你正在使用某些脚本，例如表情符号、[数学符号](https://zh.wikipedia.org/wiki/数学字母数字符号)或晦涩的汉字，你可能需要考虑代码单元和字符之间的差异。 +该属性返回字符串中的码元数量。JavaScript 使用 [UTF-16](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇) 编码，其中每个 Unicode 字符可以编码为一个或两个码元，因此 `length` 返回的值可能与字符串中 Unicode 字符的实际数量不匹配。对于拉丁文、西里尔文、众所周知的 CJK 字符等常见脚本，这应该不是问题，但如果你正在处理某些脚本，例如表情符号、[数学符号](https://zh.wikipedia.org/wiki/数学字母数字符号)或生僻字，你可能需要考虑码元和字符之间的差异。 -语言规范要求字符串的最大长度为 253 - 1 个元素，这是[精确整数](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)的上限。但是，具有此长度的字符串需要 16384TB 的存储空间，这在任何合理的设备内存中都容纳不了，因此实现倾向于降低阈值，从而允许字符串的长度方便地存储在 32 位整数中。 +语言规范要求字符串的最大长度为 253 - 1 个元素，这是[精确整数](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)的上限。但是，具有此长度的字符串需要 16384TB 的存储空间，这远远超出了任何合理设备的内存限制，因此实现通常会降低这个阈值，从而允许字符串的长度方便地存储在一个 32 位整数中。 -- 在 V8（Chrome 和 Node 使用）中，最大长度为 229 - 24（\~1GB）。在 32 位系统上，最大长度为 228 - 16（\~512MB）。 -- 在 Firefox 中，最大长度为 230 - 2（\~2GB）。在 Firefox 65 之前，最大长度为 228 - 1（\~512MB）。 -- 在 Safari 中，最大长度为 231 - 1（\~4GB）。 +- 在 V8 引擎（Chrome 和 Node 使用）中，最大长度为 229 - 24（约为 1GB）。在 32 位系统上，最大长度为 228 - 16（约为 512MB）。 +- 在 Firefox 中，最大长度为 230 - 2（约为 2GB）。在 Firefox 65 之前，最大长度为 228 - 1（约为 512MB）。 +- 在 Safari 中，最大长度为 231 - 1（约为 4GB）。 对于空字符串，`length` 为 0。 静态属性 `String.length` 与字符串的长度无关。它是 `String` 函数的[参数数量](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Function/length)（简单地说，就是它有多少个形参），也就是 1。 -由于 `length` 统计的是代码单元而不是字符，如果你想得到字符的数量，你可以首先用它的[迭代器](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String/@@iterator)分割字符串，它按字符进行迭代： +由于 `length` 统计的是码元而不是字符，如果你想得到字符的数量，你可以首先用它的[迭代器](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String/@@iterator)分割字符串，它按字符进行迭代： ```js function getCharacterLength(str) { - // The string iterator that is used here iterates over characters, - // not mere code units + // 这里使用的字符串迭代器遍历的是字符，而不仅仅是码元 return [...str].length; } @@ -45,11 +48,11 @@ console.log(getCharacterLength("A\uD87E\uDC04Z")); // 3 const x = "Mozilla"; const empty = ""; -console.log(`${x} is ${x.length} code units long`); -// Mozilla is 7 code units long +console.log(`${x} 有 ${x.length} 个码元`); +// Mozilla 有 7 个码元 -console.log(`The empty string has a length of ${empty.length}`); -// The empty string has a length of 0 +console.log(`空字符串的 length 为 ${empty.length}`); +// 空字符串的 length 为 0 ``` ### 长度不等于字符数的字符串 @@ -57,15 +60,18 @@ console.log(`The empty string has a length of ${empty.length}`); ```js const emoji = "😄"; console.log(emoji.length); // 2 +console.log([...emoji].length); // 1 const adlam = "𞤲𞥋𞤣𞤫"; console.log(adlam.length); // 8 +console.log([...adlam].length); // 4 const formula = "∀𝑥∈ℝ,𝑥²≥0"; console.log(formula.length); // 11 +console.log([...formula].length); // 9 ``` ### 指定长度 -因为字符串是一个基本类型，所以尝试为字符串的 `length` 属性赋值没有可观察到的效果，并且在[严格模式](/zh-CN/docs/Web/JavaScript/Reference/Strict_mode)下会抛出。 +因为字符串是一个基本类型，所以尝试为字符串的 `length` 属性赋值没有可观察到的效果，并且在[严格模式](/zh-CN/docs/Web/JavaScript/Reference/Strict_mode)下会抛出错误。 ```js const myString = "bluebells"; @@ -85,4 +91,4 @@ console.log(myString.length); // 9 ## 参见 -- [JavaScript `String.length` and Internationalizing Web Applications](https://downloads.teradata.com/blog/jasonstrimpel/2011/11/javascript-string-length-and-internationalizing-web-applications) +- [JavaScript 的 `String.length` 属性和国际化 Web 应用](https://downloads.teradata.com/blog/jasonstrimpel/2011/11/javascript-string-length-and-internationalizing-web-applications) From b87f12d3cd2d8a6e48f0c2b813173dbf362de3cd Mon Sep 17 00:00:00 2001 From: Jason Lam Date: Wed, 5 Jul 2023 11:06:07 +0800 Subject: [PATCH 2/4] Update files/zh-cn/web/javascript/reference/global_objects/string/length/index.md --- .../reference/global_objects/string/length/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md index 2ccb6c032aa5cb..94681bdfe94ed3 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md @@ -21,9 +21,9 @@ slug: Web/JavaScript/Reference/Global_Objects/String/length 语言规范要求字符串的最大长度为 253 - 1 个元素，这是[精确整数](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)的上限。但是，具有此长度的字符串需要 16384TB 的存储空间，这远远超出了任何合理设备的内存限制，因此实现通常会降低这个阈值，从而允许字符串的长度方便地存储在一个 32 位整数中。 -- 在 V8 引擎（Chrome 和 Node 使用）中，最大长度为 229 - 24（约为 1GB）。在 32 位系统上，最大长度为 228 - 16（约为 512MB）。 -- 在 Firefox 中，最大长度为 230 - 2（约为 2GB）。在 Firefox 65 之前，最大长度为 228 - 1（约为 512MB）。 -- 在 Safari 中，最大长度为 231 - 1（约为 4GB）。 +- 在 V8 引擎（Chrome 和 Node 使用）中，最大长度为 229 - 24（约为 1GiB）。在 32 位系统上，最大长度为 228 - 16（约为 512MiB）。 +- 在 Firefox 中，最大长度为 230 - 2（约为 2GiB）。在 Firefox 65 之前，最大长度为 228 - 1（约为 512MiB）。 +- 在 Safari 中，最大长度为 231 - 1（约为 4GiB）。 对于空字符串，`length` 为 0。 From a337c30bc72002957138bbf3b331643551e086d8 Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Wed, 5 Jul 2023 22:17:18 +0800 Subject: [PATCH 3/4] minor fixes --- .../javascript/reference/global_objects/string/length/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md index 94681bdfe94ed3..7ac711cd79dbb5 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md @@ -1,5 +1,5 @@ --- -title: String length +title: String：length slug: Web/JavaScript/Reference/Global_Objects/String/length --- From 88900aa7c0be7cbf9604c53de44995fbd03001b7 Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Wed, 5 Jul 2023 22:17:36 +0800 Subject: [PATCH 4/4] Apply suggestions from code review --- .../javascript/reference/global_objects/string/length/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md b/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md index 7ac711cd79dbb5..14178cdd9f9a58 100644 --- a/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md +++ b/files/zh-cn/web/javascript/reference/global_objects/string/length/index.md @@ -19,7 +19,7 @@ slug: Web/JavaScript/Reference/Global_Objects/String/length 该属性返回字符串中的码元数量。JavaScript 使用 [UTF-16](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#utf-16_字符、unicode_码位和字素簇) 编码，其中每个 Unicode 字符可以编码为一个或两个码元，因此 `length` 返回的值可能与字符串中 Unicode 字符的实际数量不匹配。对于拉丁文、西里尔文、众所周知的 CJK 字符等常见脚本，这应该不是问题，但如果你正在处理某些脚本，例如表情符号、[数学符号](https://zh.wikipedia.org/wiki/数学字母数字符号)或生僻字，你可能需要考虑码元和字符之间的差异。 -语言规范要求字符串的最大长度为 253 - 1 个元素，这是[精确整数](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)的上限。但是，具有此长度的字符串需要 16384TB 的存储空间，这远远超出了任何合理设备的内存限制，因此实现通常会降低这个阈值，从而允许字符串的长度方便地存储在一个 32 位整数中。 +语言规范要求字符串的最大长度为 253 - 1 个元素，这是[精确整数](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)的上限。但是，具有此长度的字符串需要 16384TiB 的存储空间，这远远超出了任何合理设备的内存限制，因此实现通常会降低这个阈值，从而允许字符串的长度方便地存储在一个 32 位整数中。 - 在 V8 引擎（Chrome 和 Node 使用）中，最大长度为 229 - 24（约为 1GiB）。在 32 位系统上，最大长度为 228 - 16（约为 512MiB）。 - 在 Firefox 中，最大长度为 230 - 2（约为 2GiB）。在 Firefox 65 之前，最大长度为 228 - 1（约为 512MiB）。