Clipboard

Baseline 廣泛可用 *

此功能已經成熟，並可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 3 月⁩起，它已在各瀏覽器中推出。

* 此特性的某些部分可能存在不同級別的支援。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

Clipboard 介面，屬於 Clipboard API，提供對系統剪貼簿內容的讀寫訪問。這允許 Web 應用程式實現剪下、複製和貼上功能。

系統剪貼簿透過全域性 Navigator.clipboard 屬性暴露。

Clipboard API 的所有方法都以非同步方式執行；它們返回一個 Promise，該 Promise 在剪貼簿訪問完成後被解析。如果剪貼簿訪問被拒絕，則 Promise 被拒絕。

所有方法都需要安全上下文。有關使用該 API 的其他要求，請參閱 API 概述主題的安全注意事項部分。

例項方法

Clipboard 基於 EventTarget 介面，幷包含其方法。

read(): 從剪貼簿請求任意資料（如影像），返回一個 Promise，該 Promise 會解析為一個包含剪貼簿內容的 ClipboardItem 物件陣列。
readText(): 從系統剪貼簿請求文字，返回一個 Promise，當文字可用時，該 Promise 會以包含剪貼簿文字的字串來 fulfilled。
write(): 將任意資料寫入系統剪貼簿，返回一個 Promise，該 Promise 在操作完成後被解析。
writeText(): 將文字寫入系統剪貼簿，返回一個 Promise，該 Promise 在文字完全複製到剪貼簿後被解析。

規範
Clipboard API 和事件 # clipboard-interface

此頁面最後修改於 2024年1月9日，由 MDN 貢獻者編輯。