0.0.6 • Published 3 years ago

fast-api-speedtest v0.0.6

Weekly downloads
-
License
GPL-3.0
Repository
github
Last release
3 years ago

fast-api-speedtest

Build Status NPM version GitHub license

Measure the speed of your internet connection with Netflix's Fast.com speed test.

Installation

$ npm install --save fast-api-speedtest

Example usage

const { FastAPI, SpeedUnits } = require('fast-api-speedtest');

const FastTest = new FastAPI({
    measureUpload: true,
    downloadUnit: SpeedUnits.MBps,
    timeout: 60000
});

FastTest.runTest().then(result => {
    console.log(`Ping: ${result.ping} ms`);
    console.log(`Download speed: ${result.downloadSpeed} ${result.downloadUnit}`);
    console.log(`Upload speed: ${result.uploadSpeed} ${result.uploadUnit}`);
}).catch(e => {
    console.error(e.message);
});

Available Options

PropertyTypeDefault
measureUploadBooleanfalseTo wait for the upload speed result
uploadUnitSpeedUnits / StringMbpsThe resulting unit of upload speed
downloadUnitSpeedUnits / StringMbpsThe resulting unit of download speed
timeoutNumber40000Limit how long the speed test can run
executablePathString-Path to the Chrome startup file. You can use it if Puppeteer failed to start.

Test result

PropertyType
ping*NumberNetwork ping
downloadSpeedNumberNetwork download speed
uploadSpeed*NumberNetwork upload speed
pingUnit*StringNetwork ping unit
downloadUnitStringNetwork download speed unit
uploadUnit*StringNetwork upload speed unit
serversString[]Location(s) of test server(s)

* only available when the "measureUpload" property is set to true

TODO

I want to make this package multifunctional to allow the use of additional speed testing sites and to allow you to choose the best test exactly for you.