Netest

Netest is a Javascript library for testing internet speed in the browser. A speed check is conducted by downloading image(s), and using download time in order to get the average download speed, multiple checks could be made with different parameters.

Installation

Use npm to install Netest.

npm install netest

Usage

Conduct a single check

const netest = require("netest")

const netestOptions = {
   slowSpeedThreshold: 100,
   numOfChecks: 3,
   failIfTooLong: true,
   timeUntilLoadFailure: 60000,
   loadFailureCheckInterval: 2000,
   imageSource: "https://upload.wikimedia.org/wikipedia/commons/b/b9/Pizigani_1367_Chart_1MB.jpg",
   imageSize: 1040
};

netest(netestOptions)
.then((result) => {
   if (!result.isSlow) console.log("Your internet is great!");
})
.catch((error) => {
   if (error.hasFailed) console.log("Too bad, your internet sucks...")
});

You can also use it to run regular speed checks on the background

let speedCheckInterval = 3*60*1000; // 1 check per 3 minutes

let checkInterval = new BehaviorSubject(speedCheckInterval);
let speedChecks = checkInterval.pipe(
   switchMap(i => interval(i)),
   tap(() => {
      netest(netestOptions)
      .then((result) => { if (!result.isSlow) console.log("Your internet is great!") })
      .catch((error) => { if (error.hasFailed) console.log("Too bad, your internet sucks...") })
      .finally(() => checkInterval.next(speedCheckInterval)); // Reset the timer at end
   })
).subscribe();

Options

Field	Description	Type	Required
slowSpeedThreshold	Slow connection speed threshold in kb/s, any lower and user's connection is considered slow	Numeric	Yes
numOfChecks	Number of checks conducted and averaged	Numeric	Yes
failIfTooLong	Fails the tests if a check takes too long	Boolean	Yes
timeUntilLoadFailure	Duration threshold of a single check for test failure in ms	Numeric	Yes
loadFailureCheckInterval	How often should the failure threshold check be conducted in ms	Numeric	Yes
imageSource	Source of the image to be downloaded for the speed checks	String	Yes
imageSize	Size of the speed checks image in Kb	Numeric	Yes

Check Completion Outputs

Field	Description	Type
isSlow	Indicates that the internet speed is slow, when the speed precedes slowSpeedThreshold	Numeric
kbPerSec	Average internet speed	Numeric
averageLoadTime	Average completion time of all checks	Boolean
totalLoadTime	Total completion time of all checks	Numeric

Check Failure Outputs

Field	Description	Type
hasFailed	Indicates that a check has failed, when timeUntilLoadFailure threshold has passed	Numeric

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT