# Implementation Status
This document shows the implementation status of Web Bluetooth on the
different browsers.






# Chrome
Work is in progress:
* Know [How to file Web Bluetooth Bugs](https://www.chromium.org/developers/how-tos/file-web-bluetooth-bugs).
* In **Android, Chrome OS, Mac and Windows**, the GATT Communication API is shipped without any flag.
* **Linux** is partially implemented and not supported. The `chrome://flags/#enable-experimental-web-platform-features` flag must be enabled.
* The Windows implementation is available in Chrome 70.0.3526.0 and requires **Windows 10 version 1703 (Creators Update)**.
* Root [Issue 419413: Web Bluetooth](https://code.google.com/p/chromium/issues/detail?id=419413) and blocking issues are most authorative on status.
* Some Bluetooth GATT operations can't be run in parallel yet. See [#188
(comment)](https://github.com/WebBluetoothCG/web-bluetooth/issues/188#issuecomment-255121220)
* The `getDevices()` and `watchAdvertisements()` APIs are behind the
`chrome://flags/#enable-experimental-web-platform-features` 🚩 flag.
* The Persistent Device Permissions feature is behind the
`chrome://flags/#enable-web-bluetooth-new-permissions-backend` 🚩 flag.
## [GATT Communication API](https://webbluetoothcg.github.io/web-bluetooth/)
Feature/Platform | Chrome OS | Android | Mac | Linux | Windows |
------------------------- | :-------: | :-----: | :-: | :---: | :-----: |
getAvailability() | ✓ | ✓ | ✓ | ✓ | ✓ |
Referring Device (Physical Web) | | | | | |
Discovery | ✓ | ✓ | ✓ | ✓ | ✓ |
└ Service list | ✓ | ✓ | ✓ | ✓ | ✓ |
└ Name or prefix | ✓ | ✓ | ✓ | ✓ | ✓ |
â”” Manufacturer Data | 92 | 92 | 92 | 92 | 92 |
â”” Service Data | | | | | |
└ acceptAllDevices | ✓ | ✓ | ✓ | ✓ | ✓ |
â”” Exclusion filters | 114 | 114 | 114 | 114 | 114 |
Chooser UI | ✓ | ✓ | ✓ | ✓ | ✓ |
permissions.request() | | | | | |
permissions.query() | | | | | |
permissions.revoke() | | | | | |
getDevices() | 83 🚩 | 83 🚩 | 83 🚩 | 83 🚩 | 83 🚩 |
watchAdvertisements() | | 85 🚩 | 85 🚩 | | 85 🚩 |
Persistent Device Permissions | 83 🚩 | 83 🚩 | 83 🚩 | 83 🚩 | 83 🚩 |
GATT Server Connect | ✓ | ✓ | ✓ | ✓ | ✓ |
GATT Server Disconnect | ✓ | ✓ | ✓ | ✓ | ✓ |
Hanging connect() abortable by disconnect() | | | | | |
getPrimaryService*() | ✓ | ✓ | ✓ | ✓ | ✓ |
getIncludedService*() | | | | | |
getCharacteristic*() | ✓ | ✓ | ✓ | ✓ | ✓ |
Characteristic Properties | ✓ | ✓ | ✓ | ✓ | 70 |
Read Characteristic | ✓ | ✓ | ✓ | ✓ | ✓ |
Write Characteristic | ✓ | ✓ | ✓ | ✓ | ✓ |
â”” With Response | 85 | 85 | 85 | 85 | 85 |
â”” Without Response | 85 | 85 | 85 | 85 | 85 |
Start/Stop Notifications | ✓ | ✓ | ✓ | ✓ | 70 |
Descriptors | ✓ | ✓ | ✓ | ✓ | 70 |
Event bubbling | | | | | |
Device Disconnected Event | ✓ | ✓ | ✓ | ✓ | 70 |
Service Changed Event | | | | | |
BluetoothUUID | ✓ | ✓ | ✓ | ✓ | ✓ |
TypeError for bad UUIDs | ✓ | ✓ | ✓ | ✓ | ✓ |
Invalidate GATT attributes upon disconnect | ✓ | ✓ | ✓ | ✓ | ✓ |
GATT Blocklist | ✓ | ✓ | ✓ | ✓ | ✓ |
Low-latency Blocklist Updates | ✓ | ✓ | ✓ | ✓ | ✓ |
On-demand device pairing | | ✓ | ✓ | | |
## [Scanning API](https://webbluetoothcg.github.io/web-bluetooth/scanning.html)
Partial development. `chrome://flags/#enable-experimental-web-platform-features` 🚩 flag required.
Feature/Platform | Chrome OS | Android | Mac | Linux | Windows |
------------------------- | :-------: | :-----: | :-: | :---: | :-----: |
Advertisements Scanning | | 🚩 | 🚩 | | |
[Implementation issue](https://crbug.com/897312)
Tip: Chrome channel releases are tracked at [https://googlechromelabs.github.io/current-versions/](https://googlechromelabs.github.io/current-versions/).
### Notes
* [Android](https://crbug.com/471536): Requires Android 6.0 Marshmallow or later.
* [Mac](https://crbug.com/364359): Requires OS X Yosemite or later.
* Some MacBooks may not work: Check "About this Mac" / "System Report" / "Bluetooth" and verify that Low Energy is supported.
* [Linux](https://crbug.com/570344): Requires Kernel 3.19+ and [BlueZ](http://www.bluez.org/) 5.41+ installed. Read [How to get Chrome Web Bluetooth working on Linux](https://acassis.wordpress.com/2016/06/28/how-to-get-chrome-web-bluetooth-working-on-linux/).
* Note that Bluetooth daemon needs to run with experimental interfaces if BlueZ version is lower than 5.43: `sudo /usr/sbin/bluetoothd -E`
* [Windows](https://crbug.com/507419): Requires Windows 10 version 1706 (Creators Update) or later.
### Unsupported platforms
* Android WebView: Will be supported in the future.
* iOS: Uses the web exposed APIs as provided by the [WKWebView](https://developer.apple.com/library/ios/documentation/WebKit/Reference/WKWebView_Ref/), no implementation planned in the Chromium codebase.
Note: [WebBLE](https://itunes.apple.com/us/app/webble/id1193531073) is an app for iOS that supports the GATT Communication API. It was created initially for the [Puck.js project](https://www.espruino.com/Puck.js+Quick+Start#ios-iphone-ipad-).
[Bluefy](https://apps.apple.com/us/app/bluefy-web-ble-browser/id1492822055) is a free alternative to WebBLE created by [PNNSoft](https://pnnsoft.com/)
# Samsung Internet
In Samsung Internet v6.4, the GATT Communication API is shipped without any flag.
- https://medium.com/samsung-internet-dev/lets-connect-with-samsung-internet-v6-4-stable-1f197d43a812
- https://samsunginter.net/docs/web-bluetooth
# Opera
Supported but not working on latest versions on desktop:
- https://forums.opera.com/topic/37464/web-bluetooth
Works on Android since version 46.
# Vivaldi
Supported but not working on desktop (same issue than Opera's).
Works on Android.
# Servo
https://szeged.github.io/servo/
# Firefox
Not supported and no plan to support it in the near future:
- https://mozilla.github.io/standards-positions/#web-bluetooth
- https://bugzilla.mozilla.org/show_bug.cgi?id=1204396
# Microsoft Edge
Supported as of version 79.
# Safari
Not supported and no plan to support it in the near future:
- https://webkit.org/tracking-prevention/#anti-fingerprinting
- https://bugs.webkit.org/show_bug.cgi?id=101034
Note: on iOS and iPadOS, Web Bluetooth can be polyfilled inside Safari itself via the [iOSWebBLE](https://ioswebble.com) Safari extension, which bridges `navigator.bluetooth` to CoreBluetooth through a `SafariWebExtensionHandler` native process. This is a userland extension, not native WebKit support.
# Node.js
Node.js ports are available:
- https://github.com/thegecko/webbluetooth
- https://github.com/IjzerenHein/node-web-bluetooth