npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

domain-ping

v0.2.1

Published

A small Node.js module that attempts to ping a domain

Downloads

1,373

Readme

Domain Ping

NPM

Join the chat at Gitter

Build Status Coverage Status Known Vulnerabilities npm license

A small Node.js module that attempts to ping a domain.

It does the following:

  • Fetches the domain's IP address from the DNS records
  • Checks if the server is responding to ping requests for that IP address
  • Checks if the server is responding to HTTP requests for that domain

When done, it returns an object with the gathered data (check Usage below).

Warning

I'll be implementing changes as quickly as possible, if you have a bug report or feature request, please read the Feedback section.

Please take note that this is still a beta module.

I'll ensure that patch (0.0.x) updates won't break your code, but major (x.0.0) and minor (0.x.0) ones might.

Always check this README file before upgrading to the latest version.

Changelog

Installation

To install the package, run this inside your project's folder.

$ npm install domain-ping --save

Usage

The module exports a Promise that must be handled on your side.

const domainPing = require("domain-ping");

domainPing('github.com') // Insert the domain you want to ping
    .then((res) => {
        console.log(res); // Replace with your code
    })
    .catch((error) => {
        console.error(error);
    });

This example should output an object like this:

{ domain: 'github.com',
  ip: '192.30.253.112',
  ping: true,
  ping_time: 53.480,
  online: true,
  statusCode: 200,
  success: true }

Where:

  • domain is the domain you requested
  • ip is the IP address the domain should be pointing to, as defined in the DNS server by an A record
  • ping is true if the server is responding to ping requests, false otherwise (false does not mean it's down, ICMP could be blocked on the server's firewall)
  • ping_time is the average time in ms of the ping requests
  • online is true if the server is responding to HTTP requests for the chosen domain, with status code = 200, false otherwise
  • statusCode is the actual status code replied by the server in the HTTP request (200, 404, 503, etc)
  • success is true if the entire process executed correctly, false otherwise (check Errors below)

Errors

In case of error, the output should look like this:

{ domain: 'githubabc.com',
  success: false,
  error: 'getaddrinfo ENOTFOUND githubabc.com' }

Where:

  • error is the actual message generated by the original error when it occurred, in the example above the domain githubabc.com doesn't appear to have an A record on the DNS server

Feedback

All bug reports and feature requests are welcome, and should be submitted through one of the following channels:

All requests will be created as Github issues, if you don't use that channel.

License

MIT © Ricardo Nunes