{
  "slug": "protocol-handlers",
  "name": "Manifest Protocol Handlers",
  "category": "Manifest",
  "summary": "Register a PWA to handle custom or allow-listed URL protocols via manifest.protocol_handlers.",
  "name_zh": "清单协议处理器（protocol_handlers）",
  "summary_zh": "通过 manifest.protocol_handlers 把 PWA 注册为自定义或白名单内 URL 协议的处理程序。",
  "spec_url": "https://www.w3.org/TR/manifest-app-info/",
  "mdn_url": "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
  "confidence": "medium",
  "verified_at": "2026-06-24",
  "support": [
    {
      "target": "Chrome (Android)",
      "os": "Android",
      "browser": "chrome",
      "engine": "blink",
      "status": "no",
      "version_added": null,
      "version_full": null,
      "applicable": true,
      "notes": [
        {
          "text": "Desktop-only registration.",
          "text_zh": "仅桌面端可注册。"
        }
      ],
      "source": "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
      "verified_at": "2026-06-24",
      "confidence": "medium"
    },
    {
      "target": "Chrome (Desktop)",
      "os": "Desktop",
      "browser": "chrome",
      "engine": "blink",
      "status": "yes",
      "version_added": "96",
      "version_full": "96",
      "applicable": true,
      "notes": [],
      "source": "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
      "verified_at": "2026-06-24",
      "confidence": "medium"
    },
    {
      "target": "Edge (Desktop)",
      "os": "Desktop",
      "browser": "edge",
      "engine": "blink",
      "status": "yes",
      "version_added": "96",
      "version_full": "96",
      "applicable": true,
      "notes": [],
      "source": "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
      "verified_at": "2026-06-24",
      "confidence": "medium"
    },
    {
      "target": "Safari (iOS)",
      "os": "iOS",
      "browser": "safari",
      "engine": "webkit",
      "status": "no",
      "version_added": null,
      "version_full": null,
      "applicable": true,
      "notes": [
        {
          "text": "Safari does not implement the `protocol_handlers` manifest member (MDN compatibility table, checked 2026-10-03).",
          "text_zh": "Safari 未实现 `protocol_handlers` manifest 成员（MDN 兼容性表，2026-10-03 核对）。"
        }
      ],
      "source": "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
      "verified_at": "2026-06-24",
      "confidence": "medium"
    },
    {
      "target": "Safari (macOS)",
      "os": "macOS",
      "browser": "safari",
      "engine": "webkit",
      "status": "no",
      "version_added": null,
      "version_full": null,
      "applicable": true,
      "notes": [
        {
          "text": "Safari does not implement the `protocol_handlers` manifest member (MDN compatibility table, checked 2026-10-03).",
          "text_zh": "Safari 未实现 `protocol_handlers` manifest 成员（MDN 兼容性表，2026-10-03 核对）。"
        }
      ],
      "source": "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
      "verified_at": "2026-06-24",
      "confidence": "medium"
    },
    {
      "target": "Firefox (Desktop)",
      "os": "Desktop",
      "browser": "firefox",
      "engine": "gecko",
      "status": "no",
      "version_added": null,
      "version_full": null,
      "applicable": true,
      "notes": [
        {
          "text": "Desktop Firefox does not install web apps from the manifest and does not implement `protocol_handlers` (MDN compatibility table, checked 2026-10-03).",
          "text_zh": "桌面版 Firefox 不依据 manifest 安装 Web 应用，也未实现 `protocol_handlers`（MDN 兼容性表，2026-10-03 核对）。"
        }
      ],
      "source": "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
      "verified_at": "2026-06-24",
      "confidence": "medium"
    },
    {
      "target": "Samsung Internet",
      "os": "Android",
      "browser": "samsung",
      "engine": "blink",
      "status": "no",
      "version_added": null,
      "version_full": null,
      "applicable": true,
      "notes": [
        {
          "text": "Chromium ships manifest protocol handlers for desktop installs only; Samsung Internet lists no support (MDN compatibility table, checked 2026-10-03).",
          "text_zh": "Chromium 仅在桌面安装中提供 manifest 协议处理程序；Samsung Internet 未列出支持（MDN 兼容性表，2026-10-03 核对）。"
        }
      ],
      "source": "https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest/Reference/protocol_handlers",
      "verified_at": "2026-06-24",
      "confidence": "medium"
    }
  ],
  "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>"
}