MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

El objeto ArrayBuffer se usa para representar un buffer genérico, de datos binarios crudos (raw) con una longitud específica. No se puede manipular directamente el contenido de un ArrayBuffer; sin embargo, puedes crear uno de los arrays tipados o un objeto DataView que representa el buffer en un formato especifico, y usarlo para leer y escribir el contenido del buffer.

Sintaxis

new ArrayBuffer(length)

Parámetros

length
El tamaño en bytes, del array buffer que quieres crear.

Valor de retorno

Un nuevo objeto ArrayBuffer de tamaño específico. Su contenido se inicializa a cero.

Descripción

El constructor de ArrayBuffer crea un nuevo ArrayBuffer del tamaño especificado en bytes.

Obtener un array buffer sobre datos existentes

Propiedades

ArrayBuffer.length
El tamaño de constructor de ArrayBuffer cuyo valor es 1.
ArrayBuffer.prototype
Permite añadir propiedades a todos los objetos ArrayBuffer.

Métodos

ArrayBuffer.isView(arg)
Devuelve true si arg es una de las vistas de ArrayBuffer, como pueden ser los arrays tipados o un DataView. Sino devuelve false.
ArrayBuffer.transfer(oldBuffer [, newByteLength])
Devuelve un nuevo ArrayBuffer cuyo contenido se extrae de los datos de oldBuffer y los datos se truncan o se rellenan de newByteLength ceros.

Instancias de ArrayBuffer

Todas las instancias de ArrayBuffer heredan de ArrayBuffer.prototype.

Propiedades

ArrayBuffer.prototype.constructor
Specifies the function that creates an object's prototype. The initial value is the standard built-in ArrayBuffer constructor.
ArrayBuffer.prototype.byteLength Read only
The size, in bytes, of the array. This is established when the array is constructed and cannot be changed. Read only.

Métodos

ArrayBuffer.prototype.slice()
Returns a new ArrayBuffer whose contents are a copy of this ArrayBuffer's bytes from begin, inclusive, up to end, exclusive. If either begin or end is negative, it refers to an index from the end of the array, as opposed to from the beginning.

Ejemplo

En este ejemplo creamos un buffer de 8-bytes con una vista del tipo Int32Array referenciando dicho buffer:

var buffer = new ArrayBuffer(8);
var view   = new Int32Array(buffer);

Especificaciones

Especificación Estado Comentario
Typed Array Specification Obsolete Sustituida por ECMAScript 6.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'ArrayBuffer' in that specification.
Standard Definición inicial en un estándar ECMA. Especifica que new es obligatorio.
ECMAScript Latest Draft (ECMA-262)
The definition of 'ArrayBuffer' in that specification.
Draft  

Compatibilidad de navegadores

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Soporte básico 7.0 4.0 (2) 10 11.6 5.1
ArrayBuffer() sin las nuevas excepciones ? 44 (44) ? ? ?
Característica Android Chrome para Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte básico 4.0 (Yes) 4.0 (2) 10 11.6 4.2
ArrayBuffer() sin las nuevas excepciones ? ? 44.0 (44) ? ? ?

Anotaciones sobre compatibilidad

Desde el ECMAScript 2015, los constructores de ArrayBuffer requieren ser instanciados usando el operador new. Ejecutar el constructor de un ArrayBuffer como una funciónsin el new, lanzará un TypeError de ahora en adelante.

var dv = ArrayBuffer(10);
// TypeError: llamar al constructor ArrayBuffer sin new está prohibido
var dv = new ArrayBuffer(10);

Mirar también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: joseluisq, mlealvillarreal, AzazelN28, tamat
 Última actualización por: joseluisq,