【Node.js24.x】Object::getRandomValues()メソッドの使い方
getRandomValuesメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
getRandomValuesメソッドは、暗号学的に安全な乱数を生成する処理を実行するメソッドです。これはNode.jsのcryptoモジュールを通じて提供され、セキュリティが要求される場面で利用される高品質な乱数を効率的に生成します。
具体的には、このメソッドは引数として渡されたTypedArray（型付き配列）をランダムな値で埋め尽くします。例えば、Uint8Arrayなどのバイト配列を渡すことで、指定された長さのバイトシーケンスを予測困難な値で満たすことができます。生成される乱数は、オペレーティングシステムが提供する強力な乱数源に基づいているため、高いエントロピー（不規則性）を持ち、予測が非常に困難です。この特性により、セッションIDの生成、トークンの作成、暗号鍵の材料など、機密性の高いデータの生成に適しています。
getRandomValuesメソッドを利用することで、一般的なMath.random()関数では不十分なセキュリティレベルが求められるアプリケーションにおいて、信頼性の高い乱数生成を実現できます。このメソッドは、乱数で埋められた引数のTypedArrayそのものを戻り値として返します。
構文(syntax)
1const typedArray = new Uint8Array(16); 2globalThis.crypto.getRandomValues(typedArray);
引数(parameters)
array
- array: number[] | Uint8Array | Uint16Array | Uint32Array | Int8Array | Int16Array | Int32Array | Float32Array | Float64Array: 乱数を格納する配列またはTypedArray
戻り値(return)
TypedArray
Object.getRandomValues() メソッドは、指定された TypedArray の要素をランダムな値で埋め込み、その TypedArray を返します。