getRandomValues
Documentationbreadcrumb arrow Grafana k6breadcrumb arrow JavaScript APIbreadcrumb arrow k6/experimentalbreadcrumb arrow webcryptobreadcrumb arrow Cryptobreadcrumb arrow getRandomValues
Open source

getRandomValues

Caution

The experimental module k6/experimental/webcrypto has graduated, and its functionality is now available globally through the crypto object. The k6/experimental/webcrypto is deprecated and will be removed in the near future.

To migrate your scripts, remove the k6/experimental/webcrypto imports and use the crypto object instead.

The getRandomValues() method fills the passed TypedArray with cryptographically sound random values.

Usage

getRandomValues(typedArray)

Parameters

NameTypeDescription
typedArrayTypedArrayAn integer-based TypedArray to fill with random values. Accepted TypedArray specific types are: Int8Array, Uint8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array, or Uint32Array.

Return Value

The same array is passed as the typedArray parameter with its contents replaced with the newly generated random numbers. The typedArray parameter is modified in place, and no copy is made.

Throws

TypeDescription
QuotaExceededErrorThrown when typedArray is too large and its byteLength exceeds 65536.

Example

JavaScript 
import { crypto } from 'k6/experimental/webcrypto';

export default function () {
  const array = new Uint32Array(10);
  crypto.getRandomValues(array);

  for (const num of array) {
    console.log(num);
  }
}