speedtest-net

The package provides a Node.js interface to the Speedtest.net service, allowing developers to run a full internet speed test—including ping, download, and upload measurements—from code or the command line. It wraps the official Ookla CLI, handling license acceptance, server selection, and network‑interface binding, and returns results as a structured JSON object.

Typical users are developers who need to programmatically monitor network performance, integrate speed‑testing into CI pipelines, or build tools that report connectivity metrics. The library exposes a promise‑based API and a set of options for customizing the test, such as specifying a server ID, source IP, or custom binary path, and it emits progress events that detail each phase of the test.

What distinguishes this tool is its dual‑mode operation: a simple CLI (`speedtest-net`) for ad‑hoc checks and a programmatic API for integration, both leveraging the official Ookla speedtest binary. It also supports event‑driven progress reporting and cancellation, giving fine‑grained control over test execution.