Improvements and additions to Web Serial API docs

[chrisdavidmills]

Description

MDN documented the Web Serial API a few years ago now (it was first supported in Chrome 89), but the MDN docs have not been updated much since then, for example to include support for Bluetooth RFCOMM services (originally only wired ports such as actual serial ports and USB devices were supported), which was added in Chrome 117 — see https://chromestatus.com/feature/5686596809523200.

This PR adds docs for Bluetooth RFCOMM support and other improvements besides, Specially:

• bluetoothServiceClassId properties inside the Serial.requestPort() filters option.
• The Serial.requestPort() allowedBluetoothServiceClassIds option.
• The bluetoothServiceClassId property inside the object returned by the SerialPort.getInfo() method.
• A mention of the Permissions Policy integration on the main landing page.
• A few other assorted language improvements and description and example additions.
• Some improvements to the SerialPort.close(), and SerialPort.forget() pages, to clarify the distinction between them and add more info generally.

Motivation

Additional details

Related issues and pull requests

[github-actions]

Preview URLs (8 pages)

• /en-US/docs/Web/API/Serial/getPorts
• /en-US/docs/Web/API/Serial/requestPort
• /en-US/docs/Web/API/SerialPort/close
• /en-US/docs/Web/API/SerialPort/forget
• /en-US/docs/Web/API/SerialPort/getInfo
• /en-US/docs/Web/API/SerialPort
• /en-US/docs/Web/API/Serial
• /en-US/docs/Web/API/Web_Serial_API

External URLs (3)

URL: /en-US/docs/Web/API/SerialPort/close
Title: SerialPort: close() method

• https://developer.chrome.com/docs/capabilities/serial (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Serial/requestPort
Title: Serial: requestPort() method

• https://github.com/WebBluetoothCG/registries/blob/master/gatt_assigned_services.txt (1 time) (Note! This may be a new URL 👀)
• https://www.usb.org/ (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2024-12-02 10:18:30)

[wbamberg]

👍 thanks!

[chrisdavidmills]

Cool, cheers @wbamberg!

Any other comments, @beaufortfrancois?

[beaufortfrancois]

LGTM with nit