重学js —— 结构化数据之ArrayBuffer对象

[lizhongzhen11]

ArrayBuffer 对象

• MDN
• 现代JavaScript教程——ArrayBuffer，二进制数组 讲的更易懂

AllocateArrayBuffer ( constructor, byteLength )

用于创建 ArrayBuffer 对象。

1. 定义 obj 为 ? OrdinaryCreateFromConstructor(constructor, "%ArrayBuffer.prototype%", « [[ArrayBufferData]], [[ArrayBufferByteLength]], [[ArrayBufferDetachKey]] »)
2. 断言：! IsNonNegativeInteger(byteLength) 为 true
3. 定义 block 为 ? CreateByteDataBlock(byteLength) （PS：该方法会将生成的 Data Block 所有字节设置为0）
4. 将 obj.[[ArrayBufferData]] 设置为 block
5. 将 obj.[[ArrayBufferByteLength]] 设置为 byteLength
6. 返回 obj

IsDetachedBuffer ( arrayBuffer )

1. 断言：arrayBuffer 是对象类型，它拥有 [[ArrayBufferData]] 内置插槽
2. 如果 arrayBuffer.[[ArrayBufferData]] 为 null，返回 true
3. 返回 false

还有很多抽象操作，感觉没必要全翻译

ArrayBuffer 构造器

• 即固有对象 %ArrayBuffer%
• 全局对象 "ArrayBuffer" 属性的初始值
• ...

ArrayBuffer ( length )

1. 如果 NewTarget 为 undefined，抛 TypeError 异常
2. 定义 byteLength 为 ? ToIndex(length)
3. 返回 ? AllocateArrayBuffer(NewTarget, byteLength)

构造器上的属性

• 有个 [[Prototype]] 内置插槽，其值为 %Function.prototype%
• 有以下属性：

ArrayBuffer.isView ( arg )

• MDN
• 判断传入的参数值是否是一种 ArrayBuffer 视图（view）！！！ PS：不是用来判断参数是不是 ArrayBuffer 对象的

ArrayBuffer.isView(new ArrayBuffer(10)); // false
ArrayBuffer.isView(new Uint8Array()); // true

1. 如果 arg 不是对象，返回 false
2. 如果 arg 有 [[ViewedArrayBuffer]] 内置插槽，返回 true
3. 返回 false

ArrayBuffer 原型对象属性

• 即固有对象 %ArrayBufferPrototype%
• 有 [[Prototype]] 内置插槽，其值为 %Object.prototype%
• 属于 普通对象
• 没有 [[ArrayBufferData]] 或 [[ArrayBufferByteLength]] 内置插槽

get ArrayBuffer.prototype.byteLength

1. 定义 O 为 this 值
2. 执行 ? RequireInternalSlot(O, [[ArrayBufferData]])
3. 如果 O 是 SharedArrayBuffer，抛 TypeError 异常
4. 如果 IsDetachedBuffer(O) 为 true，抛 TypeError 异常
5. 定义 length 为 O.[[ArrayBufferByteLength]]
6. 返回 length

ArrayBuffer.prototype.constructor

初始值为 %ArrayBuffer%

ArrayBuffer.prototype.slice ( start, end )

1. 定义 O 为 this 值
2. 执行 ? RequireInternalSlot(O, [[ArrayBufferData]])
3. 如果 O 是 SharedArrayBuffer，抛 TypeError 异常
4. 如果 IsDetachedBuffer(O) 为 true，抛 TypeError 异常
5. 定义 len 为 O.[[ArrayBufferByteLength]]
6. 定义 relativeStart 为 ? ToInteger(start)
7. 如果 relativeStart < 0，定义 first 为 max((len + relativeStart), 0)；否则，定义 first 为 min(relativeStart, len)
8. 如果 end 为 undefined，定义 relativeEnd 为 len；否则，定义 relativeEnd 为 ? ToInteger(end)
9. 如果 relativeEnd < 0，定义 final 为 max((len + relativeEnd), 0)；否则，定义 final 为 min(relativeEnd, len)
10. 定义 newLen 为 max(final - first, 0)
11. 定义 ctor 为 ? SpeciesConstructor(O, %ArrayBuffer%)
12. 定义 new 为 ? Construct(ctor, « newLen »)
13. 执行 ? RequireInternalSlot(new, [[ArrayBufferData]])
14. 如果 new 是 SharedArrayBuffer，抛 TypeError 异常
15. 如果 IsDetachedBuffer(new) 为 true，抛 TypeError 异常
16. 如果 SameValue(new, O) 为 true，抛 TypeError 异常
17. 如果 new.[[ArrayBufferByteLength]] < newLen，抛 TypeError 异常
18. 注意：上述步骤的副作用可能使 O 脱离。
19. 如果 IsDetachedBuffer(O) 为 true，抛 TypeError 异常
20. 定义 fromBuf 为 O.[[ArrayBufferData]]
21. 定义 toBuf 为 new.[[ArrayBufferData]]
22. 执行 CopyDataBlockBytes(toBuf, 0, fromBuf, first, newLen)
23. 返回 new

ArrayBuffer和Array

这俩不同。 Array 可以动态扩展；ArrayBuffer 表示固定长度的原始二进制数据缓冲区！

使用 new ArrayBuffer(length) 创建指定大小的 ArrayBuffer 对象，但是不能像操作数组一样直接对其操作，几乎任何对 ArrayBuffer 的操作，都需要一个 视图。视图可以是 TypedArray，也可以是 DataView。

也就是说想操作 ArrayBuffer，必须先用视图映射下，然后操作视图即可：

let buffer = new ArrayBuffer(16); // 创建一个字节长度为 16 的 buffer
let view = new Uint32Array(buffer); // 将 buffer 视为一个 32 位整数的序列
console.log(view)
// Uint32Array(4) [0, 0, 0, 0]
// 让我们写入一个值
view[0] = 123456;
// Uint32Array(4) [123456, 0, 0, 0]