Skip to content

Commit

Permalink
An example of using SerialPort.connected (#206)
Browse files Browse the repository at this point in the history
* An example of using SerialPort.connected

* update sample
  • Loading branch information
chengweih001 authored Aug 29, 2024
1 parent 0a6672f commit 7b11d03
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions EXPLAINER_BLUETOOTH.md
Original file line number Diff line number Diff line change
Expand Up @@ -220,6 +220,24 @@ applications identify whether a connection attempt is likely to succeed, a
`SerialPort.connected` attribute will be added to indicate whether the port is
logically connected.

The below examples shows how `SerialPort.connected` attribute can be used to
inform user right actions if the Bluetooth device is not powered on or not in
the proximity of the system.

```javascript
let ports = await navigator.serial.getPorts();
for (let port of ports) {
if (port.connected) {
await port.open({baudRate: 115200});
} else {
// Prompt the user to make sure the Bluetooth device is connectable to the system.
// Once the user thinks the device is ready to connect, the user can press a
// a button which runs `port.open` to trigger a connection attempt.
}
}
```


## Security Considerations

This API change poses security risks that are a superset of those of the Web
Expand Down

0 comments on commit 7b11d03

Please sign in to comment.