@capgo/capacitor-network-diagnostics

概览

运行原生网络诊断，测试 URL 可达性、TCP 端口、WebSocket 握手、网速及丢包率

从这里开始 getNetworkStatus() 以及下方列出的其他核心方法。

平台支持

平台	支持	备注
iOS	是	原生
Android	是	原生
Web 端	否	使用 Capacitor.getPlatform() 做保护

核心功能

• getNetworkStatus - 读取原生连接类型和平台网络标志。
• testUrl - 检查 HTTP 或 HTTPS URL 的连通性，获取状态 code 和延迟。
• testPort - 向指定主机和端口打开原生 TCP socket。
• testWebSocket - 验证 ws:// 或 wss:// 握手。
• testDownloadSpeed - 通过你自己的测试文件端点，测量原生下载吞吐量。
• testPacketLoss - 通过重复的 TCP 或 HTTP 探测，估算应用层丢包率。
• runDiagnostics - 执行综合诊断并返回精简的问题列表。

App Store 和 Play Store 应用无法稳定使用原始 ICMP ping，因此丢包检测采用重复的 TCP 或 HTTP 探测。

公开 API

方法	描述
getNetworkStatus	读取当前的原生连接类型和平台网络标志。
testUrl	测试能否通过原生网络访问 HTTP 或 HTTPS URL。
testPort	测试能否通过原生网络连通 TCP 主机和端口。
testWebSocket	测试 WebSocket URL 能否完成原生握手。
testDownloadSpeed	测量原生 HTTP 请求的下载吞吐量。
testPacketLoss	通过重复的 TCP 或 HTTP 探测来估算应用层丢包率。
runDiagnostics	运行多项诊断并返回精简的问题列表。
getPluginVersion	返回原生插件版本标识。

单一事实来源

此参考文档同步自 src/definitions.ts 中的 capacitor-network-diagnostics.