此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

ArrayBuffer.prototype.byteLength

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

ArrayBuffer 实例的 byteLength 访问器属性返回该数组缓冲区的长度(以字节为单位)。

尝试一下

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);

// Use byteLength to check the size
const bytes = buffer.byteLength;

console.log(bytes);
// Expected output: 8

描述

byteLength 属性是一个访问器属性,它的 set 访问器函数是 undefined,这意味着你只能读取这个属性。该值在数组创建时确定,并且无法修改。如果这个 ArrayBuffer 被分离,则此属性返回 0。

示例

使用 byteLength

js
const buffer = new ArrayBuffer(8);
buffer.byteLength; // 8

规范

规范
ECMAScript® 2027 Language Specification
# sec-get-arraybuffer.prototype.bytelength

浏览器兼容性

参见