本文共 1791 字，大约阅读时间需要 5 分钟。

我们知道Node.js框架下的Buffer对象能够对二进制数据提供很好的支持。获取一个Buffer对象的真实字节长度是开发过程中常见的需求。在Node.js中，Buffer对象提供了一个叫做Buffer.byteLength()的方法，用于计算字符串的真实字节长度。下面，我们通过实际代码案例来详细理解这一方法的使用方法及其工作原理。

本例ch04.buffer-byteLength.js的主要代码如下：

console.info("------Buffer.byteLength()------");console.info();str = '\u00bd + \u00bc = \u00be';// ½ + ¼ = ¾: 9 characters, 12 bytesconsole.log(str + ": " + str.length + "characters, " + Buffer.byteLength(str, 'utf8') + " bytes");console.info();console.info("------Buffer.byteLength()------");

代码分析

第6行代码定义并初始化了一个字符串变量str，其内容为\u00bd + \u00bc = \u00be。通过查阅相关编码表，我们可以知道：

• \u00bd 表示字符“½”，
• \u00bc 表示字符“¼”，
• \u00be 表示字符“¾”。

第8行代码通过console.log(str + ": " + str.length + "characters, " + Buffer.byteLength(str, 'utf8') + " bytes");实现了字符串长度和字节长度的显示。其中：

• str.length 表示字符串str的字符长度，值为9。
• Buffer.byteLength(str, 'utf8') 返回了字符串str在'utf8'编码下的实际字节长度，值为12。

通过以上输出可以看出，虽然字符串str包含了9个字符，但是由于其中的部分字符（如“½”、“¼”、“¾”）默认使用了2字节的UTF-8编码，因此总体占用了12个字节。

Buffer.byteLength()的语法说明

该方法的语法为：

Buffer.byteLength(string[, encoding])

buffer.byteLength 方法返回string参数的真实字节长度，encoding参数如果不提供则默认为“utf8”编码格式。

实际意义

在编程实践中，了解字符与字节的关系是一个非常重要的技能。一个字节占8 bit（1字节等于8位二进制数），而字符可能是一个单字节字符（1个字节）或者多字节字符（例如 UTF-8编码下的字符）。在Node.js中，字符串的length 属性返回的是字符数量，而不是字节数量，因此在需要获取实际字节长度的场景下，需要使用Buffer.byteLength()方法。

在网络开发中，Buffer.byteLength() 方法经常被用来处理HTTP响应头的内容长度。例如，当需要发送一个包含文字内容的HTTP响应时，正确的做法是通过Buffer.byteLength()方法计算文字内容的字节数量，而不是直接使用String.prototype.length 属性。如示例所示：

const contentLength = Buffer.byteLength(httpResponseBody, 'utf8');response.headers['Content-Length'] = contentLength;

这个方法的结果是准确的，可以确保客户端能够正确解析响应内容的大小。

关键点回顾

• 字符与字节的区别：一个字符可能对应一个或多个字节，这在不同编码方式下表现不同。
• 实际应用：在编写HTTP响应时，使用Buffer.byteLength()来计算内容长度，而不是直接使用字符串长度。
• 方法使用：Buffer.byteLength(string, encoding)中的encoding参数主要用于处理不同编码方式下的字符串转换。

通过本节的学习，我们可以更好地理解字符与字节的关系，并掌握在Node.js中正确计算字符串实际字节数量的技巧。

转载地址：http://qehqz.baihongyu.com/