Web Serial
Lets a site open a serial port the person picks and exchange bytes with it.
In one line
Can open one serial port you pick and exchange data with it
Lets a site open a serial port the person picks and exchange bytes with it.
Gives a page direct read and write to microcontrollers, 3D printers, GPS modules and Bluetooth serial adapters. Port identity (USB vendor and product id) can be read once granted.
What it can and can't do
What the user does: You tap Connect device and pick a port in the chooser.
It can
- Show the available ports, filtered by device type if the site asks
- Open the one port you pick
- Send and get data with that device, such as a 3D printer or a board
It cannot
- Open a port you did not pick
- Open any port without the chooser
- Work in Safari, including on iPhone
- Keep access after you remove the permission or unplug the device
How it differs between platforms: Chrome and Edge support it. Safari and iPhone do not. Samsung Internet only partly.
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 89 | 2021-03-02 | None |
| Edge | Supported | 89 | 2021-03-04 | None |
| Firefox | Supported | 151 | 2026-05-19 | None |
| Safari | Not supported | Not available | Not listed | None |
| Safari on iPhone | Not supported | Not available | Not listed | None |
| Chrome on Android | Supported | 148 | 2026-05-05 | None |
| Samsung Internet | Partial | 30.0 | 2026-05-11 | Serial ports are only available if they're provided by Bluetooth RFCOMM serial port emulation. |
How a site asks for it
| API | navigator.serial.requestPort({filters}), getPorts(), port.open({baudRate,...}), port.readable, port.writable |
| Permission name | serial |
| Permissions policy | serial |
| Browser compat keys | api.Serialapi.SerialPortapi.Navigator.serial |
| How access is granted | picker |
| What the user sees | Chooser of available ports; filtered by usbVendorId and usbProductId when supplied |
| Needs a secure context (HTTPS) | Yes |
| Needs a user gesture | Yes |
| How long it lasts | Per origin and port |
| How to take it back | Site settings, port.forget() (Chrome 103+), 'disconnect' event |
| Inside an iframe | Needs allow="serial" |
Typical flow
- Click
- requestPort()
- port.open({baudRate: 115200})
- Read through port.readable.getReader() and write through port.writable
Data you get
What comes back: Byte streams in both directions
Shape: stream
How often: continuous; bound by baud rate
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
baudRate | integer | baud | required; commonly 9600 to 115200, up to several Mbaud | device dependent |
dataBits | enum | bits | 7 or 8 | Not listed |
stopBits | enum | bits | 1 or 2 | Not listed |
parity | enum | None | none, even, odd | Not listed |
bufferSize | integer | bytes | default 255, must be under 16 MB | Not listed |
flowControl | enum | None | none or hardware | Not listed |
usbVendorId / usbProductId | integer | None | 0 to 65535 | from getInfo() |
bluetoothServiceClassId | string | None | UUID or 16 bit alias | Chrome 117+ for RFCOMM serial |
Technical limits
- Needs picker selection each origin; no silent enumeration
- Cannot access ports the OS reserves (some system consoles)
- Bluetooth serial limited to RFCOMM profile devices
- Needs HTTPS
- Safari and iOS have no implementation
The story
What it is
A site can connect to a device on a serial port that you pick.
For you
A picker lists plugged in devices. You pick one, and the page can send and read data from it, like a 3D printer or a circuit board.
For makers
Makers can set up and update hardware from a web page, with no driver or app. It is a big win for maker tools and factory test jigs.
Where you see it
| Type | Example | Apps |
|---|---|---|
| developer | A web page flashes new code onto an Arduino or ESP32 board. | Arduino, ESPHome |
| education | A coding class programs a robot from a browser tab. | micro:bit, Raspberry Pi Pico |
| creative | A 3D printer dashboard sends commands from the page. | Prusa, OctoPrint |
| enterprise | A factory tool tests devices and records the results. | None named |
| smart-home | A page sets up a sensor board for home use. | None named |
| security | A malicious page could trick someone into picking a device that holds secrets. | None named |
Risks
- Picking the wrong device
- Not on Safari
What the platform says
- Google: Web Serial. Chrome's docs say Web Serial lets a page read and write to serial devices like microcontrollers and 3D printers.
Good uses and abuse
Legitimate uses
- Arduino and ESP32 flashing
- 3D printer control
- Industrial and lab gear dashboards
Known abuse
- Writing hostile firmware to a connected board
- Port identity as a fingerprint
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 4 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 2 of 5 | How much the user has to do |
| Fingerprint bits | Not rated | Rough identifying entropy, when known |
History
- 2021-03, Chrome 89: Web Serial ships on desktop Chromium
- 2022-04, Chrome 103: port.forget()
- 2024-09, Chrome 130: SerialPort.connected attribute
- 2026, Firefox 151: Firefox adds Web Serial per BCD
- 2026-05, Chrome on Android 148: Android support for serial ports and USB or Bluetooth devices emulating serial
Related capabilities
Related
- WebUSB. Can talk to one USB device you pick from a list
- Web Bluetooth (GATT). Can connect to one nearby Bluetooth device you pick from a list
Sources
How well checked: Checked against real behavior.