From 0cc10b1f116e303695fdd1ac94b9298d4986e693 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Mon, 19 Jul 2021 00:34:26 +0900 Subject: Web/API/Crypto/getRandomValues を更新 (#1485) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - conflicting 版を削除 - 2021/07/10 時点の英語版に同期 --- files/ja/web/api/crypto/getrandomvalues/index.html | 78 +++++++++------------- 1 file changed, 32 insertions(+), 46 deletions(-) (limited to 'files/ja/web/api') diff --git a/files/ja/web/api/crypto/getrandomvalues/index.html b/files/ja/web/api/crypto/getrandomvalues/index.html index 8bf52ee04a..559bbe47e8 100644 --- a/files/ja/web/api/crypto/getrandomvalues/index.html +++ b/files/ja/web/api/crypto/getrandomvalues/index.html @@ -1,21 +1,21 @@ --- -title: RandomSource.getRandomValues() +title: Crypto.getRandomValues() slug: Web/API/Crypto/getRandomValues tags: - - API - - Crypto - - Cryptography - - Encryption - - Integers - - Method - - Numbes - - Pseudorandom - - Pseudorandom Numbers - - Random Numbers - - Reference - - Web Crypto API - - getRandomValues - - 擬似乱数 +- API +- Crypto +- Cryptography +- Encryption +- Integers +- Method +- Numbers +- Pseudorandom +- Pseudorandom Numbers +- Random Numbers +- Reference +- Web Crypto API +- getRandomValues +browser-compat: api.Crypto.getRandomValues translation_of: Web/API/Crypto/getRandomValues ---

{{APIRef("Web Crypto API")}}

@@ -26,39 +26,40 @@ translation_of: Web/API/Crypto/getRandomValues

getRandomValues()Crypto インターフェイスで安全なコンテキスト外から使用することができる唯一のメンバーです。

-

構文

+

構文

-
typedArray = cryptoObj.getRandomValues(typedArray);
+
typedArray = cryptoObj.getRandomValues(typedArray);
-

引数

+

引数

typedArray
整数値を基数とした {{jsxref("TypedArray")}}。{{jsxref("Int8Array")}} または {{jsxref("Uint8Array")}}, {{jsxref("Int16Array")}}, {{jsxref("Uint16Array")}}, {{jsxref("Int32Array")}}, {{jsxref("Uint32Array")}}。配列内のすべての要素は乱数で上書きされます。
-

返値

+

返値

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

-

例外

+

例外

このメソッドはエラーが発生すると例外を発行する可能性があります。

-
{{domxref("DOMException")}} (name: {{exception("QuotaExceededError")}})
-
リクエストした長さが 65536 バイトを超えた場合。
+
{{domxref("DOMException")}} (name: {{exception("QuotaExceededError")}})
+
リクエストした長さが 65,536 バイトを超えた場合。
-

使用上の注意

+

使用上の注意

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

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

-

+

-
/* window.crypto.getRandomValues が利用可能であると想定 */
+
/* window.crypto.getRandomValues が利用可能であると想定 */
 
 var array = new Uint32Array(10);
 window.crypto.getRandomValues(array);
@@ -69,33 +70,18 @@ for (var i = 0; i < array.length; i++) {
 }
 
-

仕様書

+

仕様書

- - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('Web Crypto API', '#RandomSource-method-getRandomValues')}}{{Spec2('Web Crypto API')}}初回定義
+{{Specifications}} -

ブラウザーの互換性

+

ブラウザーの互換性

-

{{Compat("api.Crypto.getRandomValues")}}

+

{{Compat}}

-

関連情報

+

関連情報

-- cgit v1.2.3-54-g00ecf