大网数据广告活动
Web 标准与前端开发

String:length

· 52CE 我爱测

String 类型的 **`length`** 数据属性表示字符串的 UTF-16 码元长度。

String 类型的 length 数据属性表示字符串的 UTF-16 码元长度。

JavaScript Demo: String.length

const str = "Life, the universe and everything. Answer:";

console.log(`${str} ${str.length}`);
// Expected output: "Life, the universe and everything. Answer: 42"

值

一个非负整数。

描述

该属性返回字符串中的码元数量。JavaScript 使用 UTF-16 编码,其中每个 Unicode 字符可以编码为一个或两个码元,因此 length 返回的值可能与字符串中 Unicode 字符的实际数量不匹配。对于拉丁文、西里尔文、众所周知的 CJK 字符等常见脚本,这应该不是问题,但如果你正在处理某些脚本,例如表情符号、数学符号或生僻字,你可能需要考虑码元和字符之间的差异。

语言规范要求字符串的最大长度为 2<sup>53</sup> - 1 个元素,这是精确整数的上限。但是,具有此长度的字符串需要 16384TiB 的存储空间,这远远超出了任何合理设备的内存限制,因此实现通常会降低这个阈值,从而允许字符串的长度方便地存储在一个 32 位整数中。

  • 在 V8 引擎(Chrome 和 Node 使用)中,最大长度为 2<sup>29</sup> - 24(约为 1GiB)。在 32 位系统上,最大长度为 2<sup>28</sup> - 16(约为 512MiB)。
  • 在 Firefox 中,最大长度为 2<sup>30</sup> - 2(约为 2GiB)。在 Firefox 65 之前,最大长度为 2<sup>28</sup> - 1(约为 512MiB)。
  • 在 Safari 中,最大长度为 2<sup>31</sup> - 1(约为 4GiB)。

对于空字符串,length 为 0。

静态属性 String.length 与字符串的长度无关。它是 String 函数的参数数量(简单地说,就是它有多少个形参),也就是 1。

由于 length 统计的是码元而不是字符,如果你想得到字符的数量,你可以首先用它的迭代器分割字符串,它按字符进行迭代:

function getCharacterLength(str) {
  // 这里使用的字符串迭代器遍历的是字符,而不仅仅是码元
  return [...str].length;
}

console.log(getCharacterLength("A\uD87E\uDC04Z")); // 3

示例

基本用法

const x = "Mozilla";
const empty = "";

console.log(`${x} 有 ${x.length} 个码元`);
// Mozilla 有 7 个码元

console.log(`空字符串的 length 为 ${empty.length}`);
// 空字符串的 length 为 0

长度不等于字符数的字符串

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 属性赋值没有可观察到的效果,并且在严格模式下会抛出错误。

const myString = "bluebells";

myString.length = 4;
console.log(myString); // "bluebells"
console.log(myString.length); // 9

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。