Crypto getRandomValues()

❮ Web API Reference

Example

const myArray = new Uint32Array(10);
crypto.getRandomValues(myArray);
Try it Yourself »

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

See Also:

The Math.random() Method

Syntax

crypto.getRandomValues(array)

Parameters

Parameter Description
array Required.
A typedArray of integers.

Return Value

Type Description
typedArrayA typedArray of integers.

Related Pages:

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
Copyright 1999-2023 by Refsnes Data. All Rights Reserved.