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..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 @@ -1,36 +1,39 @@ --- -title: String length +title: String:length 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)的上限。但是,具有此长度的字符串需要 16384TiB 的存储空间,这远远超出了任何合理设备的内存限制,因此实现通常会降低这个阈值,从而允许字符串的长度方便地存储在一个 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。 静态属性 `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)