blob: 57e9c02508247752c20e793af59deecc6a9d97a5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
|
---
title: RandomSource.getRandomValues()
slug: Web/API/Crypto/getRandomValues
tags:
- API
- Cryptographie
- Methode(2)
- Méthode
- Reference
- Référence(2)
translation_of: Web/API/Crypto/getRandomValues
original_slug: Web/API/RandomSource/getRandomValues
---
{{APIRef("Web Crypto API")}}
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'{{Glossary("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 {{jsxref("TypedArray")}} de nombres entiers, qui est un {{jsxref("Int8Array")}}, un {{jsxref("Uint8Array")}}, un {{jsxref("Uint16Array")}}, un {{jsxref("Int32Array")}}, ou encore un {{jsxref("Uint32Array")}}. Tous les éléments du tableau seront subsitués avec des nombres aléatoires.
### Exceptions
- Une {{exception("QuotaExceededError")}} {{domxref("DOMException")}} est levée si la taille de la requête est plus grand que 65 536 octets.
## Exemple
```js
/* 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]);
}
```
## Spécification
| Specification | Status | Comment |
| -------------------------------------------------------------------------------------------- | ------------------------------------ | ------------------ |
| {{SpecName('Web Crypto API', '#RandomSource-method-getRandomValues')}} | {{Spec2('Web Crypto API')}} | Initial definition |
## Compatibilité des navigateurs
{{Compat("api.Crypto.getRandomValues")}}
## Voir aussi
- {{ domxref("Window.crypto") }} pour obtenir un objet {{domxref("Crypto")}}.
- {{jsxref("Math.random")}}, une source non cryptographique de nombres aléatoires.
|
