SubtleCrypto: метод digest()

Метод digest() интерфейса SubtleCrypto генерирует дайджест заданных данных. Дайджест — это короткое значение фиксированной длины, полученное из входных данных переменной длины. Криптографические дайджесты должны обладать свойством стойкости к коллизиям, что означает сложность получения двух различных входных данных с одинаковым значением дайджеста.

Он принимает в качестве аргументов идентификатор алгоритма дайджеста и данные для дайджестирования. Он возвращает Promise, который будет выполнен с дайджестом.

Обратите внимание, что этот API не поддерживает потоковый ввод: необходимо прочитать все входные данные в память перед передачей их в функцию дайджестирования.

algorithm

Это может быть строка или объект с единственным свойством name, которое является строкой. Строка указывает используемую функцию хеширования. Поддерживаемые значения:

• "SHA-1" (но не используйте это в криптографических приложениях)
• "SHA-256"
• "SHA-384"
• "SHA-512".

data

Объект ArrayBuffer, TypedArray или DataView содержащий данные для дайджестирования.

A Promise, который выполняется с ArrayBuffer, содержащим дайджест.

Алгоритмы дайджестирования, также известные как криптографические функции хеширования, преобразуют произвольный блок данных в выходные данные фиксированной длины, обычно гораздо короче, чем входные данные. Они имеют множество применений в криптографии.

Дополнительные примеры использования API digest() см. в Некриптографические использования SubtleCrypto.

В этом примере кодируется сообщение, вычисляется его дайджест SHA-256 и выводится длина дайджеста:

const text =
  "An obscure body in the S-K System, your majesty. The inhabitants refer to it as the planet Earth.";

async function digestMessage(message) {
  const encoder = new TextEncoder();
  const data = encoder.encode(message);
  const hash = await window.crypto.subtle.digest("SHA-256", data);
  return hash;
}

digestMessage(text).then((digestBuffer) =>
  console.log(digestBuffer.byteLength),
);

Дайджест возвращается как ArrayBuffer, но для сравнения и отображения дайджесты часто представляются шестнадцатеричными строками. В этом примере вычисляется дайджест, а затем преобразуется ArrayBuffer в шестнадцатеричную строку:

const text =
  "An obscure body in the S-K System, your majesty. The inhabitants refer to it as the planet Earth.";

async function digestMessage(message) {
  const msgUint8 = new TextEncoder().encode(message); // encode as (utf-8) Uint8Array
  const hashBuffer = await window.crypto.subtle.digest("SHA-256", msgUint8); // hash the message
  const hashArray = Array.from(new Uint8Array(hashBuffer)); // convert buffer to byte array
  const hashHex = hashArray
    .map((b) => b.toString(16).padStart(2, "0"))
    .join(""); // convert bytes to hex string
  return hashHex;
}

digestMessage(text).then((digestHex) => console.log(digestHex));

• Некриптографические использования SubtleCrypto
• Спецификация Chromium по безопасным origin
• FIPS 180-4 описывает семейство алгоритмов дайджестирования SHA.