Objecte Digest

Objecte resum d'informació

Podeu utilitzar l'objecte Digest d'aquesta manera:

1
2
3
4
5
6
7
8
9
10
11
12
13
const crypto = require('crypto');
// create a SHA-512 digest object
const digest = crypto.createHash('sha512');
// update digest with data
digest.update('hello');
digest.update('world');
// get digest result
const result = digest.digest();
console.log(result);

// output result in hex and base64
console.log(result.toString('hex'));
console.log(result.toString('base64'));

En el codi anterior, crypto.createHash()es crea un objecte d'operació de resum SHA-512 amb el mètode. update()Les dades que s'han de resumir es poden afegir gradualment mitjançant el mètode i digest()el resultat de resum es pot obtenir mitjançant el mètode.

relació hereditària

propietats dels membres

size

Enter, consulta el nombre de bytes de resum de l'algorisme de resum d'informació actual

1
readonly Integer Digest.size;

funció de membre

update

Actualitza la informació del resum binari

1
Digest Digest.update(Buffer data);

Paràmetres de trucada:

• data:Buffer, bloc de dades binàries

Resultats de retorn:

• Digest, retorna el propi objecte de resum d'informació

---

Actualitza la informació del resum de la cadena

1
2
Digest Digest.update(String data,
    String codec = "utf8");

Paràmetres de trucada:

• data: cadena, dades de cadena
• codec: String, especifica el format de codificació, els valors permesos són: "buffer", "hex", "base32", "base58", "base64", "utf8", oiconvConjunts de caràcters suportats pel mòdul

Resultats de retorn:

• Digest, retorna el propi objecte de resum d'informació

---

digest

Calcula i torna el resum

1
Value Digest.digest(String codec = "buffer");

Paràmetres de trucada:

• codec: String, especifica el format de codificació, els valors permesos són: "buffer", "hex", "base32", "base58", "base64", "utf8", oiconvConjunts de caràcters suportats pel mòdul

Resultats de retorn:

• Value, retorna una representació resumida de la codificació especificada

---

sign

Signar i retornar el resum

1
2
Buffer Digest.sign(PKey key,
    Object opts = {}) async;

Paràmetres de trucada:

• key:PKey, clau privada signada
• opts: Objecte, especifica les opcions de signatura

Resultats de retorn:

• Buffer, retorneu les dades signades

opts admet els paràmetres següents:

1
2
3
4
5
6
7
8
9
10
{
    alg: 0 指定签名的 hash 算法， 仅在 RSA 时有效， 缺省为 0. 支持算法: 0 = NONE,
    1 = MD5,
    2 = SHA1,
    3 = SHA224,
    4 = SHA256,
    5 = SHA384,
    6 = SHA512,
    7 = RIPEMD160
}

---

verify

Comproveu que les signatures siguin coherents

1
2
3
Boolean Digest.verify(PKey key,
    Buffer sign,
    Object opts = {}) async;

Paràmetres de trucada:

• key:PKey, la clau pública per verificar la signatura
• sign:Buffer, especifiqueu la signatura a verificar
• opts: Objecte, especifiqueu opcions de verificació

Resultats de retorn:

• Boolean, retorna el resultat verificat

opts admet els paràmetres següents:

1
2
3
4
5
6
7
8
9
10
{
    alg: 0 指定签名的 hash 算法， 仅在 RSA 时有效， 缺省为 0. 支持算法: 0 = NONE,
    1 = MD5,
    2 = SHA1,
    3 = SHA224,
    4 = SHA256,
    5 = SHA384,
    6 = SHA512,
    7 = RIPEMD160
}

---

toString

Retorna la representació de cadena de l'objecte. En general, es retorna "[Objecte natiu]". L'objecte es pot tornar a implementar segons les seves pròpies característiques.

1
String Digest.toString();

Resultats de retorn:

• String, retorna la representació de cadena de l'objecte

---

toJSON

Retorna una representació en format JSON de l'objecte, generalment retornant una col·lecció de propietats llegibles definides per l'objecte.

1
Value Digest.toJSON(String key = "");

Paràmetres de trucada:

• key: Corda, no utilitzada

Resultats de retorn:

• Value, retorna un valor que conté JSON serializable