Skip to content
Go to file


npm npm

Ping.js is a small and simple Javascript library to ping response times to servers in pure Javascript! This is useful for when you want to display realtime ping times on a status page which are relative to the user.

JS Fiddle Example:

Example in jQuery:


  • Download the distribution files in dist to your project.
var p = new Ping();"", function(err, data) {
  // Also display error if err is returned.
  if (err) {
    console.log("error loading resource")
    data = data + " " + err;
  document.getElementById("ping-github").innerHTML = data;

or import as a module:

$ npm install ping.js
import Ping from 'ping.js';

or use the jsdelivr CDN:

<script src="" type="text/javascript"></script>

See demo/react-example for an example in React.


var p = new Ping(opt);


Create Ping instance.


Type: Object

favicon Override the default favicon.ico image location.

timeout Optional - Set a timeout in milliseconds., callback)

Creates a ping request to the source.

source IP address or website URL, including protocol and port (optional). Example:

callback(err, ping) Callback function which returns an error and the response time in milliseconds.


Install project:

git clone
cd ping.js
npm install
npm install -g grunt-cli

Run grunt to build distribution files:


Open demo/index.html in a browser to test results.


Javscript itself doesn't have a native way of sending a "ping", so results may not be completely accurate. Since ajax requests are affected by cross-domain issues (CORS), they are blocked by default. ping.js is using a method of loading a favicon.ico image from any host and timing the response time. If the favicon image doesn't exist, an error is returned along with the ping value. If there's a better way to do this in Javascript, feel free to create an issue, or pull request so I can review.


MIT License © Alfred Gutierrez

You can’t perform that action at this time.