Uint8Array

Los array 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.

Methods

Uint8Array.prototype.copyWithin()

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

Uint8Array.prototype.entries()

Retorna un nuevo objeto iterador de array 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()

Relena 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()

Calls a function for each element in the array. See also Array.prototype.forEach().

Uint8Array.prototype.includes()

Determines whether a typed array includes a certain element, returning true or false as appropriate. See also Array.prototype.includes().

Uint8Array.prototype.indexOf()

Returns the first (least) index of an element within the array equal to the specified value, or -1 if none is found. See also Array.prototype.indexOf().

Uint8Array.prototype.join()

Joins all elements of an array into a string. See also Array.prototype.join().

Uint8Array.prototype.keys()

Returns a new Array Iterator that contains the keys for each index in the array. See also Array.prototype.keys().

Uint8Array.prototype.lastIndexOf()

Returns the last (greatest) index of an element within the array equal to the specified value, or -1 if none is found. See also Array.prototype.lastIndexOf().

Uint8Array.prototype.map()

Creates a new array with the results of calling a provided function on every element in this array. See also Array.prototype.map().

Uint8Array.prototype.move() No implementado

Former non-standard version of Uint8Array.prototype.copyWithin().

Uint8Array.prototype.reduce()

Apply a function against an accumulator and each value of the array (from left-to-right) as to reduce it to a single value. See also Array.prototype.reduce().

Uint8Array.prototype.reduceRight()

Apply a function against an accumulator and each value of the array (from right-to-left) as to reduce it to a single value. See also Array.prototype.reduceRight().

Uint8Array.prototype.reverse()

Reverses the order of the elements of an array — the first becomes the last, and the last becomes the first. See also Array.prototype.reverse().

Uint8Array.prototype.set()

Stores multiple values in the typed array, reading input values from a specified array.

Uint8Array.prototype.slice()

Extracts a section of an array and returns a new array. See also Array.prototype.slice().

Uint8Array.prototype.some()

Returns true if at least one element in this array satisfies the provided testing function. See also Array.prototype.some().

Uint8Array.prototype.sort()

Sorts the elements of an array in place and returns the array. See also Array.prototype.sort().

Uint8Array.prototype.subarray()

Returns a new Uint8Array from the given start and end element index.

Uint8Array.prototype.values()

Returns a new Array Iterator object that contains the values for each index in the array. See also Array.prototype.values().

Uint8Array.prototype.toLocaleString()

Returns a localized string representing the array and its elements. See also Array.prototype.toLocaleString().

Uint8Array.prototype.toString()

Returns a string representing the array and its elements. See also Array.prototype.toString().

Uint8Array.prototype[@@iterator]()

Returns a new Array Iterator object that contains the values for each index in the array.

Examples

// From a length
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

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

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

// From an ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = new Uint8Array(buffer, 1, 4);

Specifications

Browser compatibility

Compatibility notes

Starting with ECMAScript 2015 (ES6), Uint8Array constructors require to be constructed with a new operator. Calling a Uint8Array constructor as a function without new, will throw a TypeError from now on.

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

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

See also

• JavaScript typed arrays
• ArrayBuffer
• DataView