---
title: Crypto.getRandomValues()
slug: Web/API/Crypto/getRandomValues
tags:
  - API
  - Cryptography
  - Method
  - Reference
translation_of: Web/API/Crypto/getRandomValues
---
<div>{{APIRef("Web Crypto API")}}</div>

<p><code><strong>Crypto.getRandomValues()</strong></code><strong> </strong>함수는 암호학적으로 강력한 수준의 임의의(random) 값을 생성합니다. 매개 변수로 제공된 배열은 임의의 숫자로 채워집니다 (암호화의 의미는 무작위입니다).</p>

<p>충분한 성능을 보장하기 위해 구현에서는 진정한 난수 생성기(pseudo-random number)를 사용하지 않지만 충분한 엔트로피가있는 값으로 시드 된 의사 난수 생성기를 사용하고 있습니다. 사용 된 유사난수 생성기(pseudorandom number generator, PRNG)는 구현마다 다르지만 암호화 용도에 적합합니다. 시스템 수준의 엔트로피 소스처럼 충분한 엔트로피가있는 시드를 사용하려면 구현이 필요합니다.</p>

<h2 id="구문">구문</h2>

<pre class="syntaxbox"><em>cryptoObj</em>.getRandomValues(<em>typedArray</em>);</pre>

<h3 id="매개변수">매개변수</h3>

<dl>
 <dt><code><em>typedArray</em></code></dt>
 <dd>Is an integer-based {{jsxref("TypedArray")}}, that is an {{jsxref("Int8Array")}}, a {{jsxref("Uint8Array")}}, an {{jsxref("Int16Array")}}, a {{jsxref("Uint16Array")}}, an {{jsxref("Int32Array")}}, or a {{jsxref("Uint32Array")}}. 배열의 모든 요소는 임의의 숫자로 재정의됩니다.</dd>
</dl>

<h3 id="예외">예외</h3>

<ul>
 <li>A {{exception("QuotaExceededError")}} {{domxref("DOMException")}} is thrown if the requested length is greater than 65536 bytes.</li>
</ul>

<h2 id="예제">예제</h2>

<pre class="brush: js">/* window.crypto.getRandomValues 를 사용가능하다고 가정한다. */

var array = new Uint32Array(10);
window.crypto.getRandomValues(array);

console.log("나의 행운의 숫자들:");
for (var i = 0; i &lt; array.length; i++) {
    console.log(array[i]);
}
</pre>

<h2 id="Specification" name="Specification">명세</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Crypto API', '#RandomSource-method-getRandomValues')}}</td>
   <td>{{Spec2('Web Crypto API')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="브라우저_호환성">브라우저 호환성</h2>

<p>{{Compat("api.Crypto.getRandomValues")}}</p>

<h2 id="같이_보기">같이 보기</h2>

<ul>
 <li>{{ domxref("Window.crypto") }} to get a {{domxref("Crypto")}} object.</li>
 <li>{{jsxref("Math.random")}}, a non-cryptographic source of random numbers.</li>
</ul>