使用@capgo/capacitor-network-diagnostics
本插件为Capacitor原生网络诊断,用于调试受限Wi-Fi、门户网站、阻塞端口、WebSocket故障、下载速度慢和数据包丢失等问题。
安装
npm install @capgo/capacitor-network-diagnostics
npx cap sync
此插件暴露的内容
getNetworkStatus- 读取原生连接类型和平台网络标志。testUrl- 检查HTTP或HTTPS URL的可达性,状态code和延迟。testPort- 打开一个原生TCP socket到一个主机和端口。testWebSocket- 验证一个ws://或wss://握手。testDownloadSpeed- 测量原生下载吞吐量。testPacketLoss- 通过重复探测估算应用层包丢失率。runDiagnostics- 运行组合诊断并返回问题列表。
示例用法
import { NetworkDiagnostics } from '@capgo/capacitor-network-diagnostics';
const report = await NetworkDiagnostics.runDiagnostics({
urls: [{ url: 'https://api.example.com/health' }],
ports: [{ host: 'api.example.com', port: 443 }],
websockets: [{ url: 'wss://ws.example.com/socket' }],
packetLoss: {
mode: 'tcp',
host: 'api.example.com',
port: 443,
count: 10,
},
});
console.log(report.status);
console.log(report.issues);
支持工作流程
要求受影响用户在连接到问题 Wi-Fi 或访问点时运行诊断。将以下结果发送给支持:
- 连接类型和 OS 网络标志
- 失败的 URL、端口或 WebSocket 端点
- 下载 Mbps
- 包丢失百分比
- 原生错误代码和消息
iOS 和 Android 应用程序中 ICMP 原始 ping 不可移植,因此使用重复的 TCP 或 HTTP 探测来测量包丢失。
全参考
- GitHub: https://github.com/Cap-go/capacitor-network-diagnostics/
- 文档:/docs/plugins/network-diagnostics/