Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
I

is-reachable

> 编程语言
Open source

Check if servers are reachable

383 stars0 likes2 views
WebsiteGitHub

About

Check if servers are reachable

is-reachable

Check if servers are reachable

Works in Node.js and the browser (with a bundler).

The Node.js version uses HTTP HEAD/GET requests for HTTP(S) URLs and TCP connections for other ports. For HTTP(S), it tries HEAD requests first (for better performance and bandwidth efficiency), falling back to GET requests if HEAD is not supported.

The browser version is limited by the fact that browsers cannot connect to arbitrary ports. It only supports HTTP and HTTPS and tries to load common favicon paths (/favicon.ico, /favicon.png, /favicon.svg, /apple-touch-icon.png, /apple-touch-icon-precomposed.png) to determine reachability. The browser version does not support the requireHttpSuccess option and will only return true if the favicon files load successfully (equivalent to requireHttpSuccess: true).

[!IMPORTANT] By default, any HTTP response (including 404, 401, 403, 500, etc.) is considered “reachable” since it proves the server is responding. This aligns with the network-level definition of reachability. Use the requireHttpSuccess option if you need to check for successful responses only.

Install

bash
npm install is-reachable

Usage

javascript
import isReachable from 'is-reachable';

console.log(await isReachable('sindresorhus.com'));
//=> true

console.log(await isReachable('google.com:443'));
//=> true

// With timeout
console.log(await isReachable('sindresorhus.com', {
	signal: AbortSignal.timeout(3000)
}));
//=> true

API

isReachable(targets, options?)

Returns a Promise which is true if any of the targets are reachable.

targets

Type: string | string[]

One or more targets to check. Can either be hostname:port, an IP address like 1.2.3.4 or 1.2.3.4:port, a URL like https://hostname:port, or even just hostname. port must be specified if protocol is not http: or https: and defaults to 443. Protocols other than http: and https: are not supported. Bare IP addresses default to HTTP.

options

Type: object

signal

Type: AbortSignal

An AbortSignal to cancel the requests.

You can use AbortSignal.timeout() to create a signal that automatically aborts after a specified time:

javascript
await isReachable('sindresorhus.com', {
	signal: AbortSignal.timeout(3000)
});

Or combine multiple signals using AbortSignal.any():

javascript
const controller = new AbortController();
const timeoutSignal = AbortSignal.timeout(5000);

await isReachable('example.com', {
	signal: AbortSignal.any([controller.signal, timeoutSignal])
});
requireHttpSuccess

Type: boolean
Default: false

Only consider the server reachable if it returns a successful HTTP status code (200-299).

When false (default), any HTTP response (including 4xx and 5xx) is considered reachable, as it proves the server is responding. This aligns with the network-level definition of "reachability".

When true, only successful HTTP responses (2xx status codes) are considered reachable, which is useful for application health checks.

Related

  • is-online - Check if the internet connection is up

Maintainers

  • Sindre Sorhus
  • silverwind

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

JavaScriptbrowserconnectivitydetectinternet

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

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