ArrayBuffer.prototype.detached

Baseline 2024

Newly available

Since ⁨March 2024⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

detached は ArrayBuffer インスタンスのアクセサープロパティで、このバッファーが分離（移譲）されたかどうかを示す論理値を返します。

解説

detached プロパティはアクセサープロパティであり、その設定アクセサー関数は undefined です。つまり、このプロパティは読み取り専用です。ArrayBuffer が最初に作成された時点では値は false です。ArrayBuffer が移譲されると値は true になり、これによりインスタンスが基盤となるメモリーから切り離されます。バッファーが切り離されると、それ以降は使用できなくなります。

例

detached の使用

const buffer = new ArrayBuffer(8);
console.log(buffer.detached); // false
const newBuffer = buffer.transfer();
console.log(buffer.detached); // true
console.log(newBuffer.detached); // false