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 是字符串时使用的编码方式。
返回: <Decipher> 用于方法链调用。

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

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

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

【The options argument is optional for GCM. 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.】