RandomSource.getRandomValues()

La méthode RandomSource.getRandomValues() permet d’obtenir des valeurs pseudo-aléatoires cryptographiquement satisfaisantes. Le tableau donné en paramètre est rempli avec des nombres pseudo-aléatoires.

Pour garantir une performance suffisante, les implémentations n’utilisent pas un vrai générateur de nombres aléatoires, mais un générateur de nombres pseudo-aléatoires semé avec une valeur ayant suffisamment d'entropie. Les générateurs utilisés d’une implémentation à une autre seront différents mais toujours satisfaisants pour une utilisation en cryptographie. Les implémentations doivent également utiliser une graine ayant suffisamment d’entropie, comme une source d’entropie au niveau du système.

Syntaxe

cryptoObj.getRandomValues(typedArray);

Paramètres

typedArray

Un TypedArray de nombres entiers, qui est un Int8Array, un Uint8Array, un Uint16Array, un Int32Array, ou encore un Uint32Array. Tous les éléments du tableau seront subsitués avec des nombres aléatoires.

Exceptions

• Une QuotaExceededError DOMException est levée si la taille de la requête est plus grand que 65 536 octets.

Exemple

/* on part du principe ici que window.crypto.getRandomValues est disponible */

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

console.log("Your lucky numbers:");
for (var i = 0; i < array.length; i++) {
    console.log(array[i]);
}

Compatibilité des navigateurs

Spécification

Voir aussi

• Window.crypto pour obtenir un objet Crypto.
• Math.random, une source non cryptographique de nombres aléatoires.