Uint8Array

Los Uint8Array representan un array de enteros sin signo de 8 bits. El contenido se inicializa a 0. Una vez establecido, puedes hacer referencia a un elemento usando los métodos del objeto o usando la sintaxis de array estándar (esto es, usando la notación de corchetes).

Sintaxis

new Uint8Array(tamaño);
new Uint8Array(typedArray);
new Uint8Array(objeto);
new Uint8Array(buffer [, byteOffset [, tamaño]]);

Para más información acerca de la sintaxis del constructor y sus parámetros, mire TypedArray.

Propiedades

Uint8Array.BYTES_PER_ELEMENT

Retorna un número con el valor del tamaño del elemento. 1 en el caso del Uint8Array.

Uint8Array.length

Propiedad estática de tamaño cuyo valor es 3. Para el tamaño actual (número d elementos), mire Uint8Array.prototype.length.

Uint8Array.name

Devuelve el nombre del constructor en un string. En el caso de Uint8Array devuelve: "Uint8Array".

Uint8Array.prototype

Prototipo para los objetos TypedArray .

Métodos

Uint8Array.from()

Crea un nuevo Uint8Array desde un array o un objeto iterable. Véase también Array.from().

Uint8Array.of()

Crea un  Uint8Array con un número variable de argumentos. Véase también Array.of().

Uint8Array prototype

Todos los objetos Uint8Array son heredados de %TypedArray%.prototype.

Propiedades

Uint8Array.prototype.constructor

Retorna la función que crea una instancia del prototype. Éste es el constructor por defecto de Uint8Array.

Uint8Array.prototype.buffer Read only

Retorna el ArrayBuffer con la referencia del Uint8Array. Fijado en el tiempo de construcción y es de sólo lectura.

Uint8Array.prototype.byteLength Read only

Retorna el tamaño (en bytes) del array Uint8Array. Fijado en el tiempo de construcción y es de sólo lectura.

Uint8Array.prototype.byteOffset Read only

Retorna el offset (en bytes) del Uint8Array desde el inicio de su  ArrayBuffer. Fijado en el tiempo de construcción y es de sólo lectura.

Uint8Array.prototype.length Read only

Retorna el número de elementos contenidos en el Uint8Array. Fijado en el tiempo de construcción y es de sólo lectura.

Métodos

Uint8Array.prototype.copyWithin()

Copia una secuencia de elementos del array dentro del array. Véase también Array.prototype.copyWithin().

Uint8Array.prototype.entries()

Retorna un nuevo objeto Array Iterator que contiene los pares de valores para cada índice del array. Véase también Array.prototype.entries().

Uint8Array.prototype.every()

Prueba si todos los elementos del array cumplen las condiciones de una función. Véase también Array.prototype.every().

Uint8Array.prototype.fill()

Llena todos los elementos del array desde el principio hasta el final con un valor dado. Véase también Array.prototype.fill().

Uint8Array.prototype.filter()

Crea un nuevo array con todos los elementos del array que satisfacen las condiciones de una función que devuelve verdadero. Véase también Array.prototype.filter().

Uint8Array.prototype.find()

Devuelve el valor encontrado en el array, si un elemento del array satisface una función dada de prueba o undefined si no es encontrada. Véase también Array.prototype.find().

Uint8Array.prototype.findIndex()

Devuelve el índice encontrado en el array, si un elemento del array satisface una función dada de prueba o -1 si no es encontrada. Véase también Array.prototype.findIndex().

Uint8Array.prototype.forEach()

Llama a una función para cada elemento del array. Véase también Array.prototype.forEach().

Uint8Array.prototype.includes()

Determina si un array incluye un cierto elemento, retornando true o false según corresponda. Véase también Array.prototype.includes().

Uint8Array.prototype.indexOf()

Devuelve el primer (menor) índice de un elemento dentro del array igual al valor especificado, o -1 si no es encontrado. Véase también Array.prototype.indexOf().

Uint8Array.prototype.join()

Une todos los elementos de un array a una cadena.  Véase también Array.prototype.join().

Uint8Array.prototype.keys()

Retorna un nuevo Array Iterator que contiene las claves para cada índice en el array. Véase también Array.prototype.keys().

Uint8Array.prototype.lastIndexOf()

Devuelve el último (mayor) índice de un elemento dentro del array igual al valor especificado, o -1 si no fue encontrado. Véase también Array.prototype.lastIndexOf().

Uint8Array.prototype.map()

Crea un nuevo array con los resultados de la llamada a la función indicada aplicados a cada uno de sus elementos. Véase también Array.prototype.map().

Uint8Array.prototype.move() No implementado

Primera versión no-estandar de Uint8Array.prototype.copyWithin().

Uint8Array.prototype.reduce()

Aplica una función a un acumulador y a cada valor de un array (de izquierda a derecha) para reducirlo a un único valor. Véase también Array.prototype.reduce().

Uint8Array.prototype.reduceRight()

Aplica una función a un acumulador y a cada valor de un array (de derecha a izquierda) para reducirlo a un único valor. Véase también Array.prototype.reduceRight().

Uint8Array.prototype.reverse()

Inverte el orden de los elementos de un array, el primero se convierte en el último y el último en el primero. See also Array.prototype.reverse().

Uint8Array.prototype.set()

Almacena múltiples valores en el array, leyendo los valores de entrada de un array específico.

Uint8Array.prototype.slice()

Extrae una porción de un array y devuelve uno nuevo. Véase también Array.prototype.slice().

Uint8Array.prototype.some()

Devuelve true si al menos un elemento de este array satisface la función de prueba proporcionada. Véase también Array.prototype.some().

Uint8Array.prototype.sort()

Ordena los elementos de un array localmente y devuelve el array. Véase también Array.prototype.sort().

Uint8Array.prototype.subarray()

Retorna un nuevo Uint8Array desde el índice de elementos iniciales y finales proporcionados.

Uint8Array.prototype.values()

Retorna un nuevo objeto Array Iterator que contiene los valores para cada índice en el array. Véase también Array.prototype.values().

Uint8Array.prototype.toLocaleString()

Devuelve una cadena localizada que representa el array y sus elementos. Véase también Array.prototype.toLocaleString().

Uint8Array.prototype.toString()

Retorna una cadena representando el array sus elementos. Véase también Array.prototype.toString().

Uint8Array.prototype[@@iterator]()

Retorna un nuevo objeto Array Iterator que contiene los valores para cada índice en el array.

Ejemplos

// Desde una longitud
var uint8 = new Uint8Array(2);
uint8[0] = 42;
console.log(uint8[0]); // 42
console.log(uint8.length); // 2
console.log(uint8.BYTES_PER_ELEMENT); // 1

// Desde un array
var arr = new Uint8Array([21,31]);
console.log(arr[1]); // 31

// Desde otro TypedArray
var x = new Uint8Array([21, 31]);
var y = new Uint8Array(x);
console.log(y[0]); // 21

// Desde un ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = new Uint8Array(buffer, 1, 4);

Especificaciones

Compatibilidad del navegador

Notas de compatibilidad

A partir de ECMAScript 2015 (ES6), los constructors de Uint8Array requiren ser construidos con un operador new. Llamar a un contructor de Uint8Array como una función sin new, lanzará un TypeError de ahora en adelante.

var dv = Uint8Array([1, 2, 3]);
// TypeError: calling a builtin Uint8Array constructor
// without new is forbidden

var dv = new Uint8Array([1, 2, 3]);

Véase también

• JavaScript typed arrays
• ArrayBuffer
• DataView