Crypto: getRandomValues() メソッド

構文

getRandomValues(typedArray)

引数

typedArray

整数値ベースの TypedArray です。 Int8Array, Uint8Array, Uint8ClampedArray, Int16Array, Uint16Array, Int32Array, Uint32Array, BigInt64Array, BigUint64Array の何れかです（ただし Float32Array や Float64Array ではありません）。 配列内のすべての要素は乱数で上書きされます。

返値

typedArray と同じ配列が渡されますが、その内容は新しく生成された乱数で置き換えられます。 typedArray はその場で変更され、コピーは行われないことに注意してください。

例外

QuotaExceededError DOMException

typedArray の byteLength が 65,536 バイトを超えた場合に発生します。

使用上の注意

getRandomValues() を暗号鍵を生成するために使用しないでください。代わりに generateKey() メソッドを使用してください。 これにはいくつかの理由があります。例えば、 getRandomValues() が保護されたコンテキストで動作することが保証されていないことなどです。

ウェブ暗号仕様書では、エントロピーの最小値は規定されていません。 その代わり、ユーザーエージェントは乱数を生成する際に、ユーザーエージェント自身に組み込まれた、よく定義された効率的な擬似乱数発生器を用いて、可能な限り最高のエントロピーを提供することが求められています。例えば、プラットフォーム固有の乱数関数、 Unix の /dev/urandom デバイス、または他のランダムまたは擬似乱数データのソースなど、外部の擬似乱数ソースから取得したシード値が用いられます。

例

const array = new Uint32Array(10);
self.crypto.getRandomValues(array);

console.log("Your lucky numbers:");
for (const num of array) {
  console.log(num);
}

仕様書

ブラウザーの互換性

関連情報

• ウェブ暗号 API
• Crypto オブジェクトを取得する crypto。
• Math.random 暗号学的に安全ではない乱数値。