RandomSource.getRandomValues()

El método RandomSource.getRandomValues() permite obtener valores aleatorios criptográficamente fuertes. La matriz asignada como parámetro se llena con números aleatorios (aleatorios en su significado criptográfico).

Con el fin de garantizar un rendimiento razonable, las distintas implementaciones no utilizan un generador de numeros aleatorios puro, sino que utilizan un generador numérico pseudo-aleatorio, sembrado con un valor que posee suficiente entropía. Los generadores numéricos pseudo-aleatorios utilizados difieren de una implementación a otra, pero son adecuados para usos criptográficos. Se require también que las distintas implementaciones usen una semilla con suficiente entropía, como una fuente de entropía a nivel de sistema.

Sintaxis

cryptoObj.getRandomValues(typedArray);

Parámetros

typedArray

Es un entero TypedArray, que puede ser un Int8Array, un Uint8Array, un Int16Array, un Uint16Array, un Int32Array, o un Uint32Array. Todos los elementos dentro del array seran sobreescritos con números aleatorios.

Excepciones

• Una QuotaExceededError DOMException es lanzada si la longitud solicitada es mayor a 65536 bytes.

Ejemplo

/* Asumiendo que window.crypto.getRandomValues esta disponible */

var array = new Uint32Array(10);
window.crypto.getRandomValues(array);

console.log("Tus numeros de la suerte:");
for (var i = 0; i < array.length; i++) {
    console.log(array[i]);
}

Especificación

Compatibilidad del navegador

La tabla de compatibilidad de esta página se genera a partir de datos estructurados. Si desea contribuir a los datos, por favor, compruebe https://github.com/mdn/browser-compat-data y envianos un pull request.

Ver también

• Window.crypto para obtener un objeto tipo Crypto.
• Math.random, una fuente no criptográfica de números aleatorios.