前言
在前端开发中，我们经常需要在各种网络环境下测试不同的网站或者服务。但是有时候我们会遇到一些网站或者服务在某些地区或者某些网络环境下会出现访问不到的情况。
为了方便得到相关信息，我们可以使用一个名为 ensure-reachable 的 npm 包来测试某个网站或者服务是否可达。
安装
安装 ensure-reachable 包可以使用 npm 命令，打开终端并运行以下命令：
npm install ensure-reachable
基本用法
我们可以使用 ensure-reachable 包的主函数进行测试。该函数的基本原型如下：
function ensureReachable(url: string, timeout: number): Promise<boolean>;
参数说明：
- url: 字符串类型，待测试的网站或者服务的 URL。
- timeout: 数字类型，测试的超时时间，单位为毫秒。
返回值：
- Promise 类型，如果测试成功，则返回 true，否则返回 false。
示例代码：
const ensureReachable = require('ensure-reachable');
ensureReachable('https://www.baidu.com/', 3000)
.then((result) => {
console.log(`Baidu reachable: ${result}`);
}).catch((err) => {
console.error(`Baidu not reachable: ${err}`);
});上述代码用于测试百度网站是否可达。如果测试成功，则 console 中将打印出 “Baidu reachable: true”；如果测试失败，则 console 中将打印出 “Baidu not reachable: xxxx”（其中 xxxx 为错误信息）。
高级用法
原始函数
如果需要更为细致的控制，可以使用 ensure-reachable 包中的原始函数。
原始函数的基本原型如下：
function testReachability(opts: TestReachabilityOptions): Promise<TestReachabilityResult>;
参数说明：
- opts: Object 类型，参数对象，包含如下字段：
- url: 字符串类型，待测试的网站或者服务的 URL。
- timeout: 数字类型，测试的超时时间，单位为毫秒。
- method: 字符串类型，使用的 HTTP 方法（GET/HEAD），默认为 "GET"。
- headers: Object 类型，自定义请求头。
- agent: HTTP.Agent 类型，自定义 agent 对象。
返回值：
- Promise 类型，返回的结果对象包含如下字段：
- ip: 字符串类型，对应 IP 地址。
- rtt: 数字类型，对应往返时间（round-trip time）。
- isAlive: 布尔类型，表示是否可达。
示例代码：
-- -------------------- ---- -------
----- --------------- - ----------------------------
----- ------- - -
---- --------------------------
-------- -----
------ --- ---------------------------------------- -- ----
--
-----------------------------------------
-------------- -- -
----------------------- ---------- --------------------
-------------- -- -
------------------------- --- ---------- ---------
---上述代码用于测试谷歌网站是否可达，并使用代理进行测试。
心跳测试
可以使用 ensure-reachable 包中的心跳测试方法进行连续测试。该方法会在指定的时间间隔内对指定的网站或者服务进行测试，测试结束后返回一份测试报告。
心跳测试的基本原型如下：
function makeSporadicTest( url: string, interval: number, timeout: number, callback: TestFailureCallback, opts?: SporadicTestOptions, ): () => void;
参数说明：
- url: 字符串类型，待测试的网站或者服务的 URL。
- interval: 数字类型，测试间隔时间，单位为毫秒。
- timeout: 数字类型，测试的超时时间，单位为毫秒。
- callback: Function 类型，测试失败时调用的回调函数。
- opts: Object 类型，参数对象，包含如下字段：
- errorHandler: Function 类型，异常处理函数，如果该函数返回 true，则异常不会导致心跳测试终止（默认返回 false）。
返回值：
- Function 类型，用于关闭测试的函数。
示例代码：
-- -------------------- ---- ------- ----- --------------- - ---------------------------- ----- -------- - ----- ----- ------- - ----- ----- --- - ------------------------- -- ---- --- ----- ------------ - ----- -- - -------------------- ------ --- ---------- --------- -- ----- ---------- - ------------------------------------- --------- -------- --------------
上述代码用于测试本地服务是否可达。测试会每隔三秒钟发送一次请求，如果请求超时则会调用 errorHandler 回调函数。将返回的函数传递给 stopHearts 变量，以便在不需要测试时进行关闭。
总结
ensure-reachable 包可以方便地进行网站或者服务可达性测试。在实际开发过程中，我们可以根据自己的需求灵活使用该包提供的不同功能。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066e26a563576b7b1ecfb8