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

View in English Always switch to English

TypedArray.prototype.byteLength

基线 广泛可用

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

byteLength 访问器属性表示类型化数组的长度(字节数)。

语法

typedarray.byteLength

描述

byteLength 是一个访问器属性,它的 set 访问器函数是 undefined,意思是你只能够读取这个属性。它的值在 TypedArray 构造时建立,不能被修改。如果 TypedArray 没有指定 byteOffset 或者 length,会返回所引用的 ArrayBufferlengthTypedArray 是这里的 TypedArray 对象之一。

示例

使用 byteLength 属性

js
var buffer = new ArrayBuffer(8);

var uint8 = new Uint8Array(buffer);
uint8.byteLength; // 8 (符合 buffer 的 byteLength)

var uint8 = new Uint8Array(buffer, 1, 5);
uint8.byteLength; // 5 (在 Uint8Array 构造时指定)

var uint8 = new Uint8Array(buffer, 2);
uint8.byteLength; // 6 (根据被构造的 Uint8Array 的 offset)

规范

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

浏览器兼容性

参见