application.keychain:setBytes() 函数
setBytes() 函数把一个 Blob 里的字节写入一个条目。键已经存在时覆盖它的值。
语法
setBytes(key, blob[, { accessible }])参数
key
键,非空字符串。
blob
要写入的字节,一个 Blob。
options.accessible
可选。访问级别,和 set() 的相同,默认 'whenUnlockedThisDeviceOnly'。见访问级别。
返回值
Promise,写好后兑现为 undefined。accessible 不是五个取值之一时被拒绝,name 是 'TypeMismatchError'。其他失败见出错时得到什么。
异常
TypeError(当场抛出,不返回 Promise)
key不是字符串,或是空字符串:setBytes: key must be a non-empty string。- 第二个参数不是
Blob:setBytes: the second argument must be a Blob。 accessible不是字符串:setBytes: accessible must be a string。
说明
用 setBytes 存的条目要用 getBytes() 读。
示例
js
async function saveSecret() {
const secret = crypto.getRandomValues(new Uint8Array(32));
await application.keychain.setBytes('secret', new Blob([secret]));
const buffer = await application.keychain.getBytes('secret');
if (buffer !== null) {
console.log(new Uint8Array(buffer).length);
}
}
saveSecret();结果:输出 32。读回来的字节和写入的相同。
对应的 iOS API
SecItemUpdate,条目不存在时 SecItemAdd,值是 Blob 的字节组成的 NSData。