Back to Content

NetworkInformation: downlinkMax property

files/en-us/web/api/networkinformation/downlinkmax/index.md

latest1.1 KB
Original Source

{{APIRef("Network Information API")}}{{SeeCompatTable}} {{AvailableInWorkers}}

The downlinkMax read-only property of the {{domxref("NetworkInformation")}} interface returns the maximum downlink speed, in megabits per second (Mbps), for the underlying connection technology.

Value

A number representing the maximum downlink speed, in megabits per second (Mb/s), for the underlying connection technology.

Examples

The following example monitors the connection using the change event and logs changes as they occur.

js
function logConnectionType() {
  let connectionType = "not supported";
  let downlinkMax = "not supported";

  if ("connection" in navigator) {
    connectionType = navigator.connection.effectiveType;

    if ("downlinkMax" in navigator.connection) {
      downlinkMax = navigator.connection.downlinkMax;
    }
  }

  console.log(
    `Current connection type: ${connectionType} (downlink max: ${downlinkMax})`,
  );
}

logConnectionType();
navigator.connection.addEventListener("change", logConnectionType);

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}