百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
I

is-online

> 编程语言
开源

检查网络连接是否正常

1.4K stars0 点赞1 次浏览
访问官网GitHub

工具介绍

检查网络连接是否正常

is-online

检查网络连接是否正常 在 Node.js 和浏览器中工作 (带有捆绑程序的情况下) 在浏览器中,已经存在 navigator.onLine,但它毫无用处,因为它只能告诉你是否存在本地连接,而不能告诉你是否可以访问互联网。

安装

bash
npm install is-online

要求

  • Node.js 20+
  • 打包后在现代浏览器中运行(需要 fetch API 支持)

使用方法

javascript
import isOnline from 'is-online';

console.log(await isOnline());
//=> true

使用超时

javascript
import isOnline from 'is-online';

console.log(await isOnline({timeout: 10_000}));
//=> true

具有中止信号

javascript
import isOnline from 'is-online';

const controller = new AbortController();

setTimeout(() => {
	controller.abort();
}, 500);

const result = await isOnline({
	timeout: 3000,
	signal: controller.signal
});

console.log(result);
//=> false

使用备用 URL

javascript
import isOnline from 'is-online';

const result = await isOnline({
	fallbackUrls: [
		'https://www.google.com',
		'https://www.github.com',
		'http://example.com'
	]
});

console.log(result);
//=> true

API

isOnline(options?)

返回一个 Promise<boolean>,如果网络连接正常,则解析为 true,否则为 false。

选项

类型: object

过期时间

类型: number
默认值: 5000 等待服务器响应的毫秒数。

信号

类型: AbortSignal 一个 AbortSignal 用于终止操作。 当信号被中止时, promise 将解析为 false。

ipVersion

类型: number
值: 4 | 6
默认值: 4 要使用的 Internet 协议版本。 这是一个高级选项,通常不需要设置,但它可以证明有用,用于明确确认 IPv6 连接。

fallbackUrls

类型: string[] 用于检查连接性的备用 URL。 仅支持 HTTP 和 HTTPS URL。在 Node.js 中,这些 URL 仅在执行所有默认连接性检查时才会进行检查。

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

JavaScriptbrowserconnectivitydetectinternet

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言