如何精准检测用户是否正在使用TWA应用？

为什么你的try/catch方案无效 #

修改window.location.href尝试跳转未注册的scheme时，浏览器不会抛出同步异常——要么静默失败，要么弹出系统级提示框，所以catch块根本不会触发。

几种可靠的检测方案 #

1. 配置TWA添加自定义请求头/元标签 #

这是最精准的方案，需要在TWA的配置中（比如AndroidManifest.xml的intent-filter或Digital Asset Links关联配置），设置加载网页时添加自定义HTTP头，例如X-TWA-Package: com.your.app.package。

前端读取方式：

• 同域场景下直接获取响应头：

fetch(window.location.href)
  .then(res => {
    const twaPackage = res.headers.get('X-TWA-Package');
    if (twaPackage === 'com.your.app.package') {
      console.log('当前在TWA应用内');
    }
  });

• 跨域场景需后端配合，在响应中添加Access-Control-Expose-Headers: X-TWA-Package，让前端能读取该自定义头。

也可以配置TWA在页面注入meta标签：

<meta name="twa-package" content="com.your.app.package">

前端读取：

const metaTag = document.querySelector('meta[name="twa-package"]');
if (metaTag && metaTag.content === 'com.your.app.package') {
  console.log('当前在TWA应用内');
}

2. 异步检测自定义Scheme可用性 #

利用跳转scheme后的页面状态变化做异步判断，代码示例：

function checkInTWA() {
  return new Promise(resolve => {
    const startTime = Date.now();
    // 尝试跳转你的自定义scheme
    window.location.href = 'example://check-app?action=check';
    
    // 设置短定时器检测页面是否还在当前状态
    setTimeout(() => {
      const timeElapsed = Date.now() - startTime;
      // 如果跳转成功，页面会被切换，定时器不会执行；失败则时间差很小
      resolve(timeElapsed < 100);
    }, 50);
  });
}

// 使用方式
checkInTWA().then(isTWA => {
  if (isTWA) {
    // 当前在TWA应用内
  } else {
    // 不在TWA应用内
  }
});

注意：部分浏览器可能会弹出"无法打开链接"的提示框，影响用户体验，建议仅在必要场景使用。

3. 结合Display模式与Digital Asset Links验证 #

TWA的display模式通常为standalone或fullscreen，普通PWA也可能使用，但可以结合Digital Asset Links的验证结果区分：

const isStandalone = window.matchMedia('(display-mode: standalone)').matches || window.navigator.standalone;

if (isStandalone) {
  // 进一步验证域名是否与你的APP绑定
  const assetLinkMeta = document.querySelector('meta[name="asset-links"]');
  if (assetLinkMeta && assetLinkMeta.content.includes('com.your.app.package')) {
    console.log('当前在TWA应用内');
  }
}

方案对比 #

• 自定义请求头/元标签：最可靠，无兼容性问题，但需要TWA和后端配合配置。
• 异步Scheme检测：无需额外配置，但可能触发浏览器提示，体验略差。
• Display模式+关联验证：能区分普通PWA和TWA，但依赖Digital Asset Links的正确配置。

内容的提问来源于stack exchange，提问作者Sara Ree