latenz
v0.2.4
Published
Measure response latency when requesting a web host.
Downloads
33
Maintainers
Readme
latenz
A JavaScript latency analyzer like updown.io or ping.apex.sh. Get information about DNS lookup, connection time to your HTTP(S) server and how long it takes to receive the response.
$ > npm install latenz -g
$ > latenz sbstjn.com
host: sbstjn.com
Name Lookup: 10ms
Connection: 3ms (13ms)
Response: 63ms (76ms)
Received: 5ms (81ms)
total: 81ms
If you plan to use the result for further scripting, you might be a friend of the raw mode
, which can be enabled by using --raw
parameter:
$ > latenz sbstjn.com --raw
985 lookup:443 socket:3 response:534 end:5
For using HTTPS instead of HTTP (default), just pass the --secure
parameter to latenz:
$ > latenz sbstjn.com --raw --secure
985 lookup:443 socket:3 response:534 end:5
JavaScript Usage
If you need the result as a JSON inside JavaScript:
const Latenz = require('latenz');
const l = new Latenz();
l.measure('sbstjn.com').then(result => {
console.log(result);
/*
[
{ key: 'resolve', time: 139 },
{ key: 'socket', time: 2 },
{ key: 'response', time: 286 },
{ key: 'firstdata', time: 1 },
{ key: 'end', time: 2 }
]
*/
}).catch((e) => {
throw e;
});
You can pass an options object to measure
in order to enable a secure connection, change the used port or set the result mode:
l.measure('sbstjn.com',
{
secure: true,
port: 8443,
mode: 'pretty'
}
);
ToDo
- Error handling
- Support redirects
- Check numbers