manifest edge_side_panel 浏览器支持

发布于 2026-09-06更新于 2026-09-14作者 Carey Gill · 编辑流程

edge_side_panel 是一个 Web App Manifest 成员，用于让 PWA 选择固定到 Microsoft Edge 的侧边栏。根据微软 2026 年 7 月更新的文档，该功能“正在被弃用”，并且“将很快不再受支持”。

浏览器支持

edge_side_panel 是 Microsoft Edge 特有的清单成员。微软的文档只描述了 Edge 对这个成员的行为，并未提及其他任何浏览器的实现。

如何使用

在添加 edge_side_panel 之前，微软的文档要求清单中已经包含 name、 short_name、description 和 icons：

{
  "name": "PWAmp music player",
  "short_name": "PWAmp",
  "description": "A skinnable music player app to play your favorite mp3 files",
  "display": "standalone",
  "icons": [{ "src": "./favicon-256.png", "sizes": "256x256" }],
  "edge_side_panel": {
    "preferred_width": 480
  }
}

如何在运行时检测

微软的文档建议使用 User-Agent Client Hints，并说明如果无法使用 Client Hints，开发者可以改为在 User-Agent 字符串中查找 Edge Side Panel。以下实现选择——并非微软文档推荐的做法——是在 navigator.userAgentData 缺失时将其视为“不在侧边栏中”，而不是抛出异常：

function isInEdgeSidebar() {
  if (!('userAgentData' in navigator)) {
    // 该浏览器不支持 User-Agent Client Hints。
    return false;
  }
  return navigator.userAgentData.brands.some((b) => b.brand === 'Edge Side Panel');
}

实践清单

不要围绕 edge_side_panel 构建新功能——微软自己的文档表示该功能正在被弃用，并将很快不再受支持。
微软的文档只涵盖 Microsoft Edge 对该成员的处理，并未记录其他浏览器的行为。
微软建议在侧边栏检测中优先使用 User-Agent Client Hints，其文档记录的回退方案是在无法使用 Client Hints 时检查 User-Agent 字符串。

下一步

← 返回兼容性浏览器。