跳转到内容

安装中的 API

getInstalledRelatedApps()

发布于

有限可用不支持的浏览器: Firefox (Desktop)、Safari (macOS)、Safari (iOS)WICG 草案

navigator.getInstalledRelatedApps() 方法返回设备上已安装的相关应用,范围限于调用方 Web 应用 manifest 的 related_applications 列表。你可以据此隐藏安装按钮,或用深链接打开对应的原生应用。Android 上的 Chrome 84 与 Samsung Internet 14 报告 Play 应用与已安装的 PWA;Windows 上的 Chrome 85、Edge 85 与 Opera 71 报告 UWP 应用,BCD 注明桌面版 Chrome 在其他平台兑现为空数组。Chrome 能力指南补充说,桌面版 Chrome 与 Edge 140 及以上版本(Windows、macOS、Linux、ChromeOS)可以检查安装在同一 scope 内的 PWA。Firefox 与 Safari 均未实现该方法(BCD api.Navigator.getInstalledRelatedApps)。

const apps = await navigator.getInstalledRelatedApps();

方法带有 [SecureContext],在纯 HTTP 源上不存在;它只定义在 Navigator 上,WorkerNavigator 上没有。

无。Promise 兑现为一个 RelatedApplication 字典数组,每个已安装的匹配项一个元素,字段如下。

字段 类型 说明
platform string 商店或生态:"play"、"windows"、"webapp"、"chrome_web_store"、"chromeos_play"、"f-droid" 或 "amazon"。从 manifest 条目复制而来。
id string,可选 平台相关的标识符(Android 包名、UWP 包家族名)。
url string,可选 manifest 条目中的 url;对 "webapp" 而言是相关 PWA 的 manifest URL。
version string,可选 平台暴露的已安装版本。

应用要匹配成功,调用方站点的 manifest 必须列出它,它也必须声明与调用方的关系。Android 应用通过 Digital Asset Links(资源中指向该网站的 asset_statements 条目)声明;UWP 应用通过 URI handler 声明;相关 PWA 在调用方位于其 scope 内时,通过自己的 related_applications 条目声明;对于 scope 之外的 PWA,Chrome 指南给出的是带 delegate_permission/common.query_webapk 的 assetlinks.json,并标明仅支持 Android。

  • InvalidStateError:从非顶层浏览上下文的文档(例如 <iframe>)调用,或文档已不再 fully active(规范 “getInstalledRelatedApps()” 第 1、2 步)。
  • TypeError:Firefox 与 Safari 中 navigator.getInstalledRelatedApps 为 undefined,同步抛出;在不安全源上,任一浏览器亦是如此。

空数组不是错误。related_applications 缺失,或列出的条目都没有匹配到已安装的应用时,结果就是空数组。条目是逐项匹配的,所以反向引用(asset links 或 URI handler)验证失败的条目,以及页面在桌面端查询其 scope 之外的 PWA,都不会出现在结果里。BCD 记录 Chrome 在 Windows 上检查 UWP 应用,在其他平台返回空数组,而 web.dev 列出 Chrome 与 Edge 140 起桌面端可检查同一 scope 内的 PWA。

两个示例都假定 manifest 的 related_applications 列出了 Android 应用 com.example.app 与站点自己的 PWA。

manifest 声明关系;页面在决定是否显示 web 安装入口前先检查。由于该方法只回答前 3 个条目,最重要的应用要排在前面。

{
"related_applications": [
{ "platform": "play", "id": "com.example.app",
"url": "https://play.google.com/store/apps/details?id=com.example.app" },
{ "platform": "webapp", "url": "https://example.com/manifest.json" }
],
"prefer_related_applications": false
}
async function decideInstallUi() {
const apps = await navigator.getInstalledRelatedApps();
if (apps.some((app) => app.platform === 'play')) {
installButton.hidden = true; // 原生应用已在设备上
openInAppLink.hidden = false; // 改为提供深链接
} else if (apps.some((app) => app.platform === 'webapp')) {
installButton.hidden = true; // 这个 PWA 已从另一个浏览器或配置文件安装
}
}

除非希望原生应用取代 PWA,否则让 prefer_related_applications 保持 false:它为 true 时,Chrome 的安装界面会转而提供商店页面,而不是安装 web 应用。

该方法不存在或没有结果时,页面得不到来自其他应用的已安装信号,应回退到常规安装流程,并用 display-mode 检查判断自身是否已安装。

async function relatedAppInstalled() {
if (!('getInstalledRelatedApps' in navigator)) return false; // Firefox、Safari、HTTP
try {
const apps = await navigator.getInstalledRelatedApps();
return apps.length > 0;
} catch (error) {
if (error.name === 'InvalidStateError') return false; // 在 iframe 内被调用
throw error;
}
}
if (!(await relatedAppInstalled())) {
showInstallAffordance(); // beforeinstallprompt 流程,或 iOS 上的分享菜单指引
}

false 分支按没有安装相关应用处理。这可能会让已经装了原生应用的用户仍然看到安装按钮。

规范

规范状态
getInstalledRelatedApps()(检测已安装的关联应用)WICG 草案
  • 图例
  • 支持
  • 部分支持
  • 需开启标志
  • 不支持
  • 未知
浏览器 / 平台支持版本置信度来源备注
Chrome (Desktop, Windows)#支持85低来源1
Chrome (Android)#支持84低来源—
Edge (Desktop, Windows)#支持85低来源2
Samsung Internet#支持14.0低来源—
Opera (Desktop, Windows)#支持71低来源3
Firefox (Desktop)#不支持—低来源4
Safari (macOS)#不支持—低来源5
Safari (iOS)#不支持—低来源6

源数据: /compatibility/get-installed-related-apps.json · 全球使用占比: 77 % (StatCounter 2026-09, CC BY-SA 4.0)

来源: 规范 · MDN · 最近核验 2026-09-04 · 置信度: 低 (由来源计算)