JavaScript Navigator bluetooth Property

What You’ll Learn

navigator.bluetooth returns a Bluetooth object — the entry point to Web Bluetooth. Learn secure-context rules, feature detection, getAvailability(), how requestDevice() works, five examples, and try-it labs.

Introduction

Web Bluetooth lets a page talk to nearby Bluetooth Low Energy (BLE) devices — heart-rate monitors, bulbs, sensors — after the user picks a device in a browser chooser.

Your starting point is navigator.bluetooth. When the API exists, that property returns a Bluetooth object with methods such as getAvailability() and requestDevice().

Understanding the bluetooth Property

navigator.bluetooth is read-only. You do not assign to it — you call methods on the object it returns.

• getAvailability() — Promise<boolean>: can this UA support Bluetooth?
• requestDevice(options) — Promise<BluetoothDevice>: user picks a device.
• getDevices() — previously permitted devices for this origin (where supported).
• Requires HTTPS (or localhost) and explicit user permission via the chooser.

📝 Syntax

General form of the property:

navigator.bluetooth

Value

• A Bluetooth object for the current document (when supported).

Common patterns

if (!("bluetooth" in navigator)) {
  console.log("Web Bluetooth not available");
} else {
  const ok = await navigator.bluetooth.getAvailability();
  console.log("available:", ok);

  // From a button click:
  // const device = await navigator.bluetooth.requestDevice({
  //   acceptAllDevices: true
  // });
}

Examples Gallery

Examples follow MDN Navigator.bluetooth / Web Bluetooth patterns with safe detection. Use View Output or Try It Yourself for each case.

const supported = "bluetooth" in navigator;
console.log(supported ? "bluetooth available" : "bluetooth missing");

bluetooth missing
(or "available" on a supporting Chromium build)

const lines = [
  "isSecureContext: " + window.isSecureContext,
  "bluetooth: " + ("bluetooth" in navigator ? "present" : "absent")
];
console.log(lines.join("\n"));

isSecureContext: true
bluetooth: absent
(exact lines depend on URL / browser)

async function checkBt() {
  if (!("bluetooth" in navigator)) {
    return "Web Bluetooth API missing";
  }
  const ok = await navigator.bluetooth.getAvailability();
  return "getAvailability: " + ok;
}

checkBt().then(console.log);

Web Bluetooth API missing
(or "getAvailability: true/false")

async function onConnectClick() {
  if (!("bluetooth" in navigator)) {
    return "Web Bluetooth not supported";
  }
  try {
    const device = await navigator.bluetooth.requestDevice({
      acceptAllDevices: true
    });
    return "selected: " + (device.name || "(unnamed)");
  } catch (err) {
    return "requestDevice failed: " + err.name;
  }
}

// Wire to a button in Try It — do not auto-run without a gesture

Web Bluetooth not supported
(or a device name / NotFoundError / NotAllowedError after clicking Connect)

async function bluetoothStatus() {
  if (!window.isSecureContext) {
    return { ok: false, reason: "insecure-context" };
  }
  if (!("bluetooth" in navigator)) {
    return { ok: false, reason: "unsupported" };
  }
  const available = await navigator.bluetooth.getAvailability();
  return { ok: available, reason: available ? "ready" : "unavailable" };
}

bluetoothStatus().then((r) => console.log(JSON.stringify(r)));

{"ok":false,"reason":"unsupported"}
(or ready / unavailable / insecure-context)

🚀 Common Use Cases

• Fitness / health — heart-rate and cadence sensors over BLE.
• Smart home demos — bulbs and switches after user selection.
• Industrial / IoT tools — configure nearby devices from a web UI.
• Progressive enhancement — show Connect only when the API exists.
• Not universal — provide non-Bluetooth alternatives for Safari/Firefox users.

📝 Notes

• Experimental and not Baseline — support is limited.
• Secure context required (HTTPS / localhost).
• requestDevice needs a user gesture and shows a chooser.
• Safari and Firefox typically do not expose this API for general web use.
• Related: audioSession, Window, JavaScript hub.

💡 Best Practices