navigator.onLine仅反映浏览器的联网感知状态而非真实网络连通性，返回true/false表示浏览器是否认为已连接，需配合轻量探测等策略验证实际服务可达性。
navigator.onLine 是浏览器提供的一个简单属性，用于检测当前页面是否处于“在线”状态。但它并不检测网络连接的真实性，而是反映浏览器的**联网感知状态**——即浏览器是否认为自己已连接到网络（通常基于系统网络接口或浏览器自身判断），而非实际能否访问互联网或特定服务器。
行为原理：不是真连网检测
该属性返回布尔值：
- true：浏览器认为设备已连接（例如 Wi-Fi/以太网开启、移动数据开启）；
- false：浏览器明确感知到离线（如飞行模式开启、所有网络接口关闭）。
⚠️ 关键限制：
- 它无法识别“假在线”场景（如连着断网的路由器、防火墙拦截、DNS 故障、目标服务器宕机）；
- 无法区分局域网可达 vs 互联网可达；
- 不触发网络请求，纯同步读取，无延迟。
事件监听：online 和 offline
可通过全局 window 监听两个事件，响应状态变化：
-
online：当navigator.onLine从false变为true时触发； -
offline：当它从true变为false时触发。
示例用法：
window.addEventListener('offline', () => console.log('已离线'));
实际使用建议
不要单独依赖 navigator.onLine 判断业务可用性。推荐组合策略：
立即学习“Java免费学习笔记（深入）”；
- 用它做快速前置过滤（如禁用提交按钮、显示“离线中”提示）；
- 关键操作前发起轻量探测（如
fetch('/health', { method: 'HEAD', cache: 'no-store' })）验证服务可达性； - 对用户操作失败（如 API 请求超时/404/503）主动回退并更新 UI 状态；
- 避免轮询
navigator.onLine，优先用事件监听。
兼容性与注意事项
所有现代浏览器均支持 navigator.onLine 和对应事件，包括桌面端和移动端。但存在一些边缘行为差异：
- iOS Safari 在某些版本中可能延迟触发
offline（尤其从弱 Wi-Fi 切换到无信号）； - 部分安卓 WebView 实现可能始终返回
true； - PWA 中配合
Service Worker使用时，需注意其独立的网络控制逻辑，navigator.onLine仍反映主页面上下文状态。
