Windows 10 Web Bluetooth Polyfill
The Polyfill enables Web Bluetooth in Chrome on Windows 10.
Installation
- You need to have Windows 10 Creators Update (version 1703 / build 15063) or newer
- Clone this repo:
git clone https://github.com/urish/web-bluetooth-polyfill
- Open Chrome Extensions pane (chrome://extensions/) and enable "Developer Mode" (there is a checkbox on top of the page)
- Click the "Load unpacked extension..." button
- Choose the
extension
folder inside the cloned repo - Take a note of the extension ID for the newly added extension, you will need it in step 8. The ID is a long string of lowercase english letters, e.g.
mfjncijdfecdpkfldkechgoadojddehp
- Download the latest BLEServer and unpack it inside
C:\Program Files (x86)\Web Bluetooth Polyfill
- Edit
C:\Program Files (x86)\Web Bluetooth Polyfill\manifest.json
and change the extension id in theallowed_origins
section to match the extension ID you found in step 6 - Run
C:\Program Files (x86)\Web Bluetooth Polyfill\register.cmd
to register the Native Messaging server
That's it! Enjoy Web Bluetooth on Windows :-)
Troubleshooting
- Run the
winver
program to verify that you have Windows 10 Creators Update. It should display: "Version 1703 (OS Build 15063.413)" or higher. - Make sure "Experimental Web Platform Features" flag is disabled. You can set it using this link: chrome://flags/#enable-experimental-web-platform-features
- Open the Devtools console of any web page, and look for the message: "Windows 10 Web Bluetooth Polyfill loaded". If you don't see this message, it means that either the extension was not installed correctly, or you already have something setting the
navigator.bluetooth
object to some value. - Follow the instructions here to debug the background page of the extension.
Current State
TL;DR - Should work out of the box with most Web Bluetooth apps.
Most of the functionality is already there, but there might be slight differences between the current implementation and the spec. Device Chooser UI is still missing, so the first matching device is picked up automatically. Check out the list of issues to see what is currently still missing. Pull Requests are very welcome!
List of API methods / events and their implementation status:
- requestDevice
- Device Chooser UI (#1)
- gatt.connect
- gatt.disconnect
- gattserverdisconnected event
- serviceadded / servicechanged / serviceremoved events (#3)
- getPrimaryService / getPrimaryServices
- getCharacteristic / getCharacteristics
- writeValue
- readValue
- startNotifications / characteristicvaluechanged event
- stopNotifications (#4)
- getIncludedService / getIncludedServices (#5)
- getDescriptor / getDescriptors (#6)
Running tests
If you want to run tests, during local development, you will need node.js and yarn. Then, run the following commands:
yarn
yarn test
You can also run the tests in watch mode, which will only run tests related to files changed since the last commit:
yarn run test:watch