files/en-us/web/javascript/reference/global_objects/arraybuffer/detached/index.md

metadata

title: ArrayBuffer.prototype.detached
short-title: detached
slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer/detached
page-type: javascript-instance-accessor-property
browser-compat: javascript.builtins.ArrayBuffer.detached
sidebar: jsref

The detached accessor property of {{jsxref("ArrayBuffer")}} instances returns a boolean indicating whether or not this buffer has been detached (transferred).

Description

The detached property is an accessor property whose set accessor function is undefined, meaning that you can only read this property. The value is false when the ArrayBuffer is first created. The value becomes true if the ArrayBuffer is transferred, which detaches the instance from its underlying memory. Once a buffer becomes detached, it is no longer usable.

Examples

Using 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

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• Polyfill of ArrayBuffer.prototype.detached in core-js
• es-shims polyfill of ArrayBuffer.prototype.detached
• {{jsxref("ArrayBuffer")}}
• {{jsxref("ArrayBuffer.prototype.transfer()")}}
• {{jsxref("ArrayBuffer.prototype.transferToFixedLength()")}}