SharedStorage: append() 方法

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

实验性： 这是一项实验性技术
在生产中使用此技术之前，请仔细检查浏览器兼容性表格。

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

语法

append(key, value)

注意： 如果在共享存储中找不到指定的 key，则 append() 操作等同于 set()，也就是说，会向共享存储中添加一个具有指定 key 的新键值对。

一个 Promise，它将以 undefined 解析。

如果出现以下情况，Promise 会以 TypeError 拒绝：
- 由于共享存储不可用（例如，通过浏览器设置禁用了共享存储），追加的条目未能成功存储在数据库中。
- key 和/或 value 超出了浏览器定义的 max 长度。
- 调用站点未在成功的隐私沙盒注册流程中包含共享存储 API。
对于 WorkletSharedStorage，如果未通过 SharedStorageWorklet.addModule() 添加 worklet 模块，Promise 会以 TypeError 拒绝。

注意： 对于 WindowSharedStorage，如果 append() 操作因非共享存储不可用的原因未能成功写入数据库，则不会抛出错误 — 操作仍以 undefined fulfilled。

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

规范
共享存储 API # dom-sharedstorage-append

此页面最后修改于 2025年7月29日，由 MDN 贡献者修改。