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 delUint8Array
. - 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énArray.from()
. Uint8Array.of()
- Crea un
Uint8Array con un número variable de argumentos
. Véase tambiénArray.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 delUint8Array.
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 suArrayBuffer
. 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énArray.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
ofalse
según corresponda. Véase tambiénArray.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énArray.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énArray.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énArray.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
Especificación | Estatus | Comentario |
---|---|---|
Typed Array Specification | Obsolete | Sustituida por ECMAScript 6. |
ECMAScript 2015 (6th Edition, ECMA-262) La definición de 'TypedArray constructors' en esta especificación. |
Standard | Definición inicial en un ECMA standard. Se especificó que new es requirerido. |
ECMAScript Latest Draft (ECMA-262) La definición de 'TypedArray constructors' en esta especificación. |
Draft |
Compatibilidad del navegador
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Soporte básico | 7.0 | 4.0 (2) | 10 | 11.6 | 5.1 |
new es requerido |
? | 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 |
new es requerido |
? | ? | 44.0 (44) | ? | ? | ? |
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]);