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 貢獻者修改。