Crypto getRandomValues()

Example

const myArray = new Uint32Array(10);
crypto.getRandomValues(myArray);

Description

The crypto.getRandomValues() method returns an array of random numbes.

The crypto.getRandomValues() method returns cryptographically strong random values.

Note

crypto.getRandomValues() returns the same array that is passed, with the contents replaced with new random numbers. The contents of the original array is not saved.

The array must be a typedArray of integers:

Int8Array
Uint8Array
Uint8ClampedArray
Int16Array
Uint16Array
Int32Array
Uint32Array
BigInt64Array
BigUint64Array

Syntax

crypto.getRandomValues(array)

Parameters

Parameter	Description
array	Required. A typedArray of integers.

Return Value

Type	Description
typedArray	A typedArray of integers.

JavaScript Math

JavaScript Numbers

JavaScript Number Reference

Browser Support

crypto.getRandomValues() is an ECMAScript6 (ES6) feature.

ES6 (JavaScript 2015) is supported in all modern browsers since June 2017:


Chrome 51	Edge 15	Firefox 54	Safari 10	Opera 38
May 2016	Apr 2017	Jun 2017	Sep 2016	Jun 2016

crypto.getRandomValues() is not supported in Internet Explorer.

❮ Web API Reference