SharedStorage: append() 方法

实验性：这是一个 实验性技术
在生产环境中使用之前，请仔细查看 浏览器兼容性表。

append() 方法是 SharedStorage 接口的方法，用于将字符串追加到当前来源的共享存储中现有键值对的值。

语法

js
append(key, value)

参数

key

一个字符串，表示要追加值的键值对的键。

value

要追加到键值对现有值的字符串。

注意： 如果共享存储中找不到指定的 key，则 append() 操作等效于 set()，即，一个新的具有指定 key 的键值对将添加到共享存储中。

返回值

一个 Promise，它将在 undefined 上完成。

异常

  • 如果 Promise 拒绝，则带有 TypeError。
    • 由于共享存储不可用（例如，它使用浏览器设置禁用），附加的条目未成功存储在数据库中。
    • key 和/或 value 超过浏览器定义的最大长度。
    • 调用站点在成功的 隐私沙箱注册流程 中不包含 Shared Storage API。
  • 在 WorkletSharedStorage 的情况下，如果工作程序模块未使用 SharedStorageWorklet.addModule() 添加，则 Promise 将拒绝带有 TypeError。

注意： 在 WindowSharedStorage 的情况下，如果 append() 操作由于共享存储不可用以外的原因而未成功写入数据库，则不会抛出错误 - 操作仍将在 undefined 上完成。

示例

js
window.sharedStorage
  .append("integer-list", ",9")
  .then(console.log("Value appended to integer list"));

规范

规范
Shared Storage API
# dom-sharedstorage-append

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参见