CryptoKey: algorithm プロパティ
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
algorithm は CryptoKey インターフェイスの読み取り専用プロパティで、このキーを使用できるアルゴリズムを記述したオブジェクトと、関連する追加の引数を返します。
返されるオブジェクトは、キーを生成する際に使用するアルゴリズムによって異なります。
値
以下のいずれかに一致するオブジェクトです。
AesKeyGenParams: AES 系のいずれかのアルゴリズムの場合RsaHashedKeyGenParams: RSA 系のいずれかのアルゴリズムの場合EcKeyGenParams: EC 系のいずれかのアルゴリズムの場合HmacKeyGenParams: HMAC アルゴリズムの場合
例
js
const rawKey = window.crypto.getRandomValues(new Uint8Array(16));
// 生のバイト列を格納する ArrayBuffer から AES 秘密鍵をインポートする
// バイト列を格納する ArrayBuffer 文字列を引数にとり、
// 秘密鍵を表す CryptoKey に解決するプロミスを返す
function importSecretKey(rawKey) {
return window.crypto.subtle.importKey("raw", rawKey, "AES-GCM", true, [
"encrypt",
"decrypt",
]);
}
const key = importSecretKey(rawKey);
console.log(`このキーは ${key.algorithm} アルゴリズムで使われるものです。`);
仕様書
| 仕様書 |
|---|
| Web Cryptography Level 2 # dom-cryptokey-algorithm |