{
  "slug": "clipboard",
  "name": "Async Clipboard API",
  "category": "Capabilities",
  "summary": "Programmatic read/write access to the system clipboard via navigator.clipboard, gated by a user gesture or the clipboard-read/clipboard-write permission.",
  "name_zh": "Async Clipboard API（异步剪贴板）",
  "summary_zh": "通过 navigator.clipboard 以编程方式读写系统剪贴板，受用户手势或 clipboard-read / clipboard-write 权限约束。",
  "spec_url": "https://w3c.github.io/clipboard-apis/",
  "mdn_url": "https://developer.mozilla.org/en-US/docs/Web/API/Clipboard",
  "confidence": "high",
  "verified_at": "2026-10-03",
  "support": [
    {
      "target": "Chrome (Desktop)",
      "os": "Desktop",
      "browser": "chrome",
      "engine": "blink",
      "status": "yes",
      "version_added": "76",
      "version_full": "76",
      "applicable": true,
      "notes": [
        {
          "text": "The user must grant the `clipboard-read` permission.",
          "text_zh": "用户必须授予 `clipboard-read` 权限。"
        }
      ],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-10-03",
      "confidence": "high"
    },
    {
      "target": "Chrome (Android)",
      "os": "Android",
      "browser": "chrome",
      "engine": "blink",
      "status": "yes",
      "version_added": "76",
      "version_full": "76",
      "applicable": true,
      "notes": [
        {
          "text": "The user must grant the `clipboard-read` permission.",
          "text_zh": "用户必须授予 `clipboard-read` 权限。"
        },
        {
          "text": "Derived by browser-compat-data mirroring from Chrome.",
          "text_zh": "由 browser-compat-data 镜像自 Chrome 的数据推导。"
        }
      ],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-10-03",
      "confidence": "high"
    },
    {
      "target": "Edge (Desktop)",
      "os": "Desktop",
      "browser": "edge",
      "engine": "blink",
      "status": "yes",
      "version_added": "79",
      "version_full": "79",
      "applicable": true,
      "notes": [
        {
          "text": "The user must grant the `clipboard-read` permission.",
          "text_zh": "用户必须授予 `clipboard-read` 权限。"
        },
        {
          "text": "Derived by browser-compat-data mirroring from Chrome.",
          "text_zh": "由 browser-compat-data 镜像自 Chrome 的数据推导。"
        }
      ],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-10-03",
      "confidence": "high"
    },
    {
      "target": "Firefox (Desktop)",
      "os": "Desktop",
      "browser": "firefox",
      "engine": "gecko",
      "status": "yes",
      "version_added": "127",
      "version_full": "127",
      "applicable": true,
      "notes": [
        {
          "text": "This method must be called within user gesture event handlers.",
          "text_zh": "此方法必须在用户手势事件的处理函数内调用。"
        },
        {
          "text": "A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is suppressed.",
          "text_zh": "读取剪贴板时会显示粘贴提示；若剪贴板内容来自同源，则不显示该提示。"
        },
        {
          "text": "Web extensions with the `clipboardRead` permission in their manifest can read data without the paste prompt displaying. Prior to Firefox 147, extensions without this permission were unable to read clipboard data.",
          "text_zh": "manifest 中声明了 `clipboardRead` 权限的 Web 扩展可以不经粘贴提示直接读取数据。Firefox 147 之前，没有该权限的扩展无法读取剪贴板数据。"
        }
      ],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-10-03",
      "confidence": "high"
    },
    {
      "target": "Firefox (Android)",
      "os": "Android",
      "browser": "firefox",
      "engine": "gecko",
      "status": "yes",
      "version_added": "127",
      "version_full": "127",
      "applicable": true,
      "notes": [
        {
          "text": "This method must be called within user gesture event handlers.",
          "text_zh": "此方法必须在用户手势事件的处理函数内调用。"
        },
        {
          "text": "A paste prompt is displayed when the clipboard is read. If the clipboard contains same-origin content, the prompt is suppressed.",
          "text_zh": "读取剪贴板时会显示粘贴提示；若剪贴板内容来自同源，则不显示该提示。"
        },
        {
          "text": "Web extensions with the `clipboardRead` permission in their manifest can read data without the paste prompt displaying. Prior to Firefox 147, extensions without this permission were unable to read clipboard data.",
          "text_zh": "manifest 中声明了 `clipboardRead` 权限的 Web 扩展可以不经粘贴提示直接读取数据。Firefox 147 之前，没有该权限的扩展无法读取剪贴板数据。"
        },
        {
          "text": "Derived by browser-compat-data mirroring from Firefox.",
          "text_zh": "由 browser-compat-data 镜像自 Firefox 的数据推导。"
        }
      ],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-10-03",
      "confidence": "high"
    },
    {
      "target": "Safari (macOS)",
      "os": "macOS",
      "browser": "safari",
      "engine": "webkit",
      "status": "yes",
      "version_added": "13.1",
      "version_full": "13.1",
      "applicable": true,
      "notes": [],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-07-21",
      "confidence": "high"
    },
    {
      "target": "Safari (iOS)",
      "os": "iOS",
      "browser": "safari",
      "engine": "webkit",
      "status": "yes",
      "version_added": "13.4",
      "version_full": "13.4",
      "applicable": true,
      "notes": [
        {
          "text": "Derived by browser-compat-data mirroring from Safari.",
          "text_zh": "由 browser-compat-data 镜像自 Safari 的数据推导。"
        }
      ],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-10-03",
      "confidence": "high"
    },
    {
      "target": "Samsung Internet",
      "os": "Android",
      "browser": "samsung",
      "engine": "blink",
      "status": "yes",
      "version_added": "12.0",
      "version_full": "12.0",
      "applicable": true,
      "notes": [
        {
          "text": "The user must grant the `clipboard-read` permission.",
          "text_zh": "用户必须授予 `clipboard-read` 权限。"
        },
        {
          "text": "Derived by browser-compat-data mirroring from Chrome Android.",
          "text_zh": "由 browser-compat-data 镜像自 Chrome Android 的数据推导。"
        }
      ],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-10-03",
      "confidence": "high"
    },
    {
      "target": "WebView (Android)",
      "os": "Android",
      "browser": "webview",
      "engine": "blink",
      "status": "yes",
      "version_added": "76",
      "version_full": "76",
      "applicable": true,
      "notes": [
        {
          "text": "The user must grant the `clipboard-read` permission.",
          "text_zh": "用户必须授予 `clipboard-read` 权限。"
        },
        {
          "text": "Derived by browser-compat-data mirroring from Chrome Android.",
          "text_zh": "由 browser-compat-data 镜像自 Chrome Android 的数据推导。"
        }
      ],
      "source": "https://raw.githubusercontent.com/mdn/browser-compat-data/main/api/Clipboard.json",
      "verified_at": "2026-10-03",
      "confidence": "high"
    }
  ],
  "biz_compat": [],
  "generated_by": "OpenPWA compatibility explorer",
  "licence": "CC BY 4.0",
  "licence_url": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "OpenPWA — https://openpwa.net",
  "attribution_html": "<a href=\"https://openpwa.net\">OpenPWA</a>, <a href=\"https://creativecommons.org/licenses/by/4.0/\">CC BY 4.0</a>"
}