nginstack

Class: SHA256

@nginstack/engine/lib/crypto/SHA256~ SHA256

new SHA256()

Implementação do algoritmo de hash SHA256.

Esta classe trata as strings como se fossem uma sequência de bytes no formato conhecido por "Binary String", onde cada caractere da string representa um byte do conteúdo binário. É importante observar que a codificação adotada pode ser diferente em outras plataformas, como o Node.js. Para garantir compatibilidade com o hash calculado em outras plataformas, prefira sempre informar valores do tipo Uint8Array ou ArrayBuffer, evitando a codificação implícita das strings.

Examples
var SHA256 = require('@nginstack/engine/lib/crypto/SHA256');
SHA256.hexDigest(new Uint8Array([0, 1, 2, 3, 4])); // => '08bb5e5d6eaac1049ede...71f51c9cb35283d'
var SHA256 = require('@nginstack/engine/lib/crypto/SHA256');
var SHA256 = new SHA256();
SHA256.update('dados001');
SHA256.update('dados002');
SHA256.update('dados003');
SHA256.hexDigest(); // => 'd3e50ee7291f6585467d0aaab5fa665d30decf792dffd336b75ab64257c88b2b'

Methods

digest( [resultType])

Retorna o hash em formato binário.

Parameters:
Name Type Argument Description
resultType string | DigestType <optional>

O tipo do digest gerado. Os valores possíveis são "binarystring", "arraybuffer" e "uint8array". Caso não seja informado, será retornada uma string no formato "Binary String", onde cada caractere da string representa um byte do conteúdo binário.
Returns:

Hash SHA256 em formato binário dos dados acumulados.

Type
string | Uint8Array | ArrayBuffer

hexDigest()

Retorna o hash em formato hexadecimal.

Returns:

Hash SHA256 em formato hexadecimal em caixa baixa dos dados acumulados.

Type
string

toString()

Produz o mesmo resultado que o método #hexDigest.

Returns:

Hash SHA256 em formato hexadecimal em caixa baixa dos dados acumulados.

Type
string

update(data)

Método responsável por fazer o acúmulo de dados para cálculo do hash.

Parameters:
Name Type Description
data string | Uint8Array | ArrayBuffer

Dados que serão acumulados para cálculo do hash.
Returns:

Instância desta classe.

Type
SHA256

<static> digest(data [, resultType])

Método de classe que calcula o hash em binário a partir de um determinado dado.

Parameters:
Name Type Argument Description
data string | Uint8Array | ArrayBuffer

Dado que será usado no cálculo do hash.
resultType string | DigestType <optional>

O tipo do digest gerado. Os valores possíveis são "binarystring", "arraybuffer" e "uint8array". Caso não seja informado, será retornada uma string no formato "Binary String", onde cada caractere da string representa um byte do conteúdo binário.
Returns:

Hash SHA256 em formato binário do dado informado.

Type
string | Uint8Array | ArrayBuffer

<static> hexDigest(data)

Método de classe que calcula o hash em formato hexadecimal a partir de um determinado dado.

Parameters:
Name Type Description
data string | Uint8Array | ArrayBuffer

Dado que será usado no cálculo do hash.
Returns:

Hash SHA256 em formato hexadecimal em caixa baixa do dado informado.

Type
string