Node.js Buffer.readBigUInt64BE() 方法介绍

简介

Node.js 中的 Buffer.readBigUInt64BE() 方法用于从 Buffer 对象中提取一个以大端字节序编码的 64 位无符号整数。该方法返回一个 BigInt 类型的值。

语法

buffer.readBigUInt64BE([offset])

• buffer: 必填，一个 Buffer 实例。
• offset: 可选，一个 Number 类型的值，表示开始读取的位置。默认为 0。

示例

const buffer = Buffer.from('00010002000300040005000600070008', 'hex');
const bigIntNum = buffer.readBigUInt64BE();
console.log(bigIntNum); // 42949672970n

错误类型

如果 offset 参数不在有效范围内，该方法会抛出一个 RangeError 错误。有效范围为 [0, buffer.length - 8]。

备注

由于 JavaScript 的 Number 类型无法准确表示大于 2^53 - 1 的整数，因此若需要处理大于此范围的整数，应当使用 BigInt 类型来进行计算。Buffer.readBigUInt64BE() 方法返回的结果即为一个 BigInt 类型的值。

参考资料

• Node.js Buffer.readBigUInt64BE() 方法文档
• JavaScript 中 BigInt 类型官方文档