返回浏览器的在线状态。该属性返回一个布尔值，true 表示在线，false 表示离线。当浏览器连接网络状态发生变化时，该属性会发送更新。更新发生在用户点击链接或脚本请求远程页面时。例如，当用户在失去互联网连接后立即点击链接时，该属性会返回false。

不同浏览器对该属性的实现方式有所不同。

在 Chrome 和 Safari 中，如果浏览器无法连接到本地局域网（LAN）或路由器，则该浏览器处于离线状态；而所有其他情况下，该属性都会返回true。因此，虽然你可以根据浏览器返回false 值来判断其处于离线状态，但你却不能断定true 值就一定意味着浏览器可以访问互联网。例如，在运行虚拟化软件的计算机上，由于虚拟以太网适配器始终处于“已连接”状态，你可能会得到假阳性的结果。因此，如果你需要准确判断浏览器的联网状态，建议你开发额外的检测手段。

在 Firefox 中，将浏览器切换到离线模式会发送一个false 值。在 Firefox 41 之前，所有其他条件都返回一个true 值；在 Windows 上对 Nightly 68 进行实际行为测试表明，它只会像 Chrome 和 Safari 一样查找 LAN 连接，从而产生假阳性的结果。

你可以通过监听online 和offline 事件来观察网络状态的变化。

值

一个布尔值。

示例

基础用法

要检查你是否在线，请查询window.navigator.onLine，如下所示：

if (navigator.onLine) {  console.log("在线");} else {  console.log("离线");}

如果浏览器不支持navigator.onLine 属性，则上述示例始终会返回false 或undefined。

监听网络状态改变

要监听网络状态变化，可以使用addEventListener 方法为window.online 和window.offline 事件添加事件监听器，如下所示：

window.addEventListener("offline", (e) => {  console.log("离线");});window.addEventListener("online", (e) => {  console.log("在线");});

规范

浏览器兼容性