NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1124 most downloaded on pub.dev
A library to use the web bluetooth api in your web project. Will play nice if used in IO projects.
Latest stable
1.2.0
Last release 1 months ago
14 Oct 2026
Release timing varies
gaps range from 6 weeks to 1.4 years
Nearly every release is documented
notes for 20 of 20 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
20 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
watchAdvertisements now keeps an abort controller for the whole watch so unwatchAdvertisements can stop a pending start as well as a running watch.
watchAdvertisements now keeps an abort controller for the whole watch so
unwatchAdvertisements can stop a pending start as well as a running watch.startupTimeout parameter to watchAdvertisements to only bound the
time it takes to start watching.Breaking-ish Requesting devices or scans now no longer checks if a bluetooth device is available. The browser will return a DeviceNotFoundError if the
DeviceNotFoundError if the bluetooth adapter was unavailable while a scan was requested.
checkingAvailability to true for requestDevice,
requestAdvertisementDevice, and/ or requestLEScan.getAvailability to get a (new) Future that will check if there is currently a bluetooth adapter
available.Your coding agent can read these notes before it upgrades. Set up the MCP server →
web/BluetoothScanFilterHelper is now deprecated. Use web/BluetoothManufacturerDataFilter.create(), web/BluetoothServiceDataFilter.create(), and web/Bl…
dart:html to dart:js_interop to support wasm builds.src/AdvertisementReceivedEvent no longer extends web/AdvertisementReceivedEventInterfacesrc/AdvertisementReceivedEvent now has a withMemory constructorweb/AdvertisementReceivedEventInterface no longer existsweb/WebAdvertisementReceivedEvent has been renamed to web/BluetoothAdvertisementReceivedEventweb/WebAdvertisementReceivedEvent.fromJSObject constructor no longer existsweb/WebAdvertisementReceivedEvent.withMemory constructor no longer existsweb/BluetoothScanFilterHelper is now deprecated. Use web/BluetoothManufacturerDataFilter.create(),
web/BluetoothServiceDataFilter.create(), and web/BluetoothScanFilter.create() instead.web/BluetoothServiceDataFilter now requires a service UUID. Following specweb/BluetoothManufacturerDataFilter now requires a company identifier. Following specsrc/ServiceDataFilterBuilder now requires a service UUID. Following specsrc/ManufacturerDataFilterBuilder now requires a company identifier. Following specweb/js/AbortController has been removed in favor of the implementation form the web packageweb/js/JSUtils has been removed (this was an internal library so it shouldn't have any impact on most
projects)web/NativeBluetooth now returns JSPromises and other native objects instead of objectweb/testingSetNavigator() now requires that you set a web navigator object.web/* all addEventListener and removeEventListener functions now extend from web/EventTargetweb/* all objects now implement JSObject and have been marked with @JS. This also removes all
fromJSObject constructors.web/WebBluetoothConvertersweb/WatchAdvertisementsOptions the signal property is now nullable. Following the spec.web/* created event streams using BluetoothEventStreamProviders.web/WebBluetoothValueEvent for the availabilitychanged event.dart:js_interop instead of dart:html.BluetoothDefaultManufacturerIdentifiers cases. That were deprecated pre this
release.BluetoothDefaultServiceUUIDS cases. That were deprecated pre this release.Updated BluetoothDefaultManufacturerIdentifiers, some identifiers have been renamed, the old names have been marked as deprecated.
BluetoothDefaultManufacturerIdentifiers, some identifiers have been renamed, the old names have been marked
as deprecated.
BluetoothDefaultManufacturerIdentifiers.manufacturerIdentifiers to get a list of all the non-deprecated
identifiers.BluetoothDefaultServiceUUIDS with the latest service UUIDS. Some services now use the official name from the
Bluetooth SIG, the old names have been marked as deprecated.
BluetoothDefaultServiceUUIDS.services to get a list of all the non-deprecated service UUIDS.id field to the enum, this contains the official Bluetooth SIG id of the UUID.BluetoothDefaultCharacteristicUUIDS with the latest characteristic UUIDS. Some characteristic now use the
official name from the Bluetooth SIG, some characteristics no longer exist in the spec. The old names and values have
been marked as deprecated
BluetoothDefaultCharacteristicUUIDS.characteristics to get a list of all the non-deprecated characteristic
UUIDS.id field to the enum, this contains the official Bluetooth SIG id of the UUID.service, characteristic, and manufacturer data blocklists
Added optionalManufacturerData to RequestOptions. This is needed to get the manufacture data when watching advertisements.
optionalManufacturerData to RequestOptions. This is needed to get the manufacture data when watching
advertisements.BluetoothDefaultManufacturerIdentifiers enum with all the registered manufacturer identifiersAdded exclusionFilters to RequestOptionsBuilder.
exclusionFilters to RequestOptionsBuilder.Updated dependencies.
Breaking Removed SNAKE_CASE uuids.
defaultUuid.ordinal then you should now use defaultUuid.index.2.17forget to a BluetoothDevice, to forget a device.Breaking BluetoothDevice.gatt is no longer marked as deprecated, it is still marked as visibleForTesting .
Added requestLEScan to Bluetooth and FlutterWebBluetooth. You can now scan for devices advertisements without needing to pair with each device. However, a normal pair does need to happen before characteristics can be used.
Bluetooth.requestDevice() the RequestOptions are no longer nullable.BluetoothDevice.gatt is no longer marked as deprecated, it is still marked as visibleForTesting.has methods for all the fields in characteristic properties.false as default value when a property doesn't exist.hasProperties method to check if there are any properties at all. Use this to test if the properties areNote: The next version of the library will probably upgrade the minimum SDK from 2.12 to 2.17 to keep up with other packages. If there are any good reasons to not do this then please create an issue on Github.
Updated dependencies to work with Flutter 3.3.0
Updated dependencies to work with Flutter 3.3.0
Added manufacturer scan filters and service scan filters
Added manufacturer scan filters and service scan filters
Added getCharacteristics to the bluetooth service to get all the characteristics.
Added getCharacteristics to the bluetooth service to get all the characteristics.
Deprecated SNAKE_CASE for default uuids. Use the camelCase version instead
Removed rxdart as a dependency and a lot of code documentation was added.
logger instead of print statements. This allows other developers to decide what to do with the
log messagesA hot fix on version V0.0.6 because it would crash.
A hot fix on version V0.0.6 because it would crash.
availabilitychanged event on unsupported platforms.Small hot fix for the behavior subject.
Small hot fix for the behavior subject.
Small bug fixes to prevent crashes and actually use the notification function.
Small bug fixes to prevent crashes and actually use the notification function.
characteristicvaluechanged for the BluetoothCharacteristic.startNotifications(). (Thanks AshTerry.)Fixed crash for getting devices
Fixed crash for getting devices
navigator.bluetooth.getDevices in browsers that don't support it.Small changes: * Forgot some Flutter dependency
Small changes:
Removed Flutter as a dependency
Small changes
First release with support for (almost) the entire web bluetooth api.
First release with support for (almost) the entire web bluetooth api.
One column per quarter.