decipher.setAAD(buffer[, options])

版本历史

版本	变更
v15.0.0	The buffer argument can be a string or ArrayBuffer and is limited to no more than 2 ** 31 - 1 bytes.
v7.2.0	This method now returns a reference to `decipher`.
v1.0.0	新增于: v1.0.0

buffer <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView>
options <Object> stream.transform 选项
- plaintextLength <number>
- encoding <string> 当 buffer 是字符串时使用的字符串编码。
返回：Decipheriv 用于方法链的同一个 Decipheriv 实例。

使用经过认证的加密模式时（目前支持 GCM、CCM、OCB、SIV、GCM-SIV 和 chacha20-poly1305），decipher.setAAD() 方法用于设置 额外认证数据（AAD）输入参数的值。

🌐 When using an authenticated encryption mode (GCM, CCM, OCB, SIV, GCM-SIV, and chacha20-poly1305 are currently supported), the decipher.setAAD() method sets the value used for the additional authenticated data (AAD) input parameter.

options 参数对于 GCM、OCB、SIV 和 GCM-SIV 是可选的。使用 CCM 时，必须指定 plaintextLength 选项，并且其值必须与密文的字节长度匹配。详见 CCM 模式。

🌐 The options argument is optional for GCM, OCB, SIV, and GCM-SIV. When using CCM, the plaintextLength option must be specified and its value must match the length of the ciphertext in bytes. See CCM mode.

decipher.setAAD() 方法必须在 decipher.update() 之前调用。

🌐 The decipher.setAAD() method must be called before decipher.update().

在将字符串作为 buffer 传递时，请考虑将字符串用作加密 API 输入时的注意事项。

🌐 When passing a string as the buffer, please consider caveats when using strings as inputs to cryptographic APIs.