Skip to Content
Platform.Ontology

Web Serial

Lets a site open a serial port the person picks and exchange bytes with it.

Asks you firstHardware and accessoriesSerialWeb browsersWhile you use 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

BrowserStatusFirst versionReleasedNote
ChromeSupported892021-03-02None
EdgeSupported892021-03-04None
FirefoxSupported1512026-05-19None
SafariNot supportedNot availableNot listedNone
Safari on iPhoneNot supportedNot availableNot listedNone
Chrome on AndroidSupported1482026-05-05None
Samsung InternetPartial30.02026-05-11Serial ports are only available if they're provided by Bluetooth RFCOMM serial port emulation.

How a site asks for it

APInavigator.serial.requestPort({filters}), getPorts(), port.open({baudRate,...}), port.readable, port.writable
Permission nameserial
Permissions policyserial
Browser compat keysapi.Serial
api.SerialPort
api.Navigator.serial
How access is grantedpicker
What the user seesChooser of available ports; filtered by usbVendorId and usbProductId when supplied
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin and port
How to take it backSite settings, port.forget() (Chrome 103+), 'disconnect' event
Inside an iframeNeeds allow="serial"

Typical flow

  1. Click
  2. requestPort()
  3. port.open({baudRate: 115200})
  4. 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

FieldTypeUnitRangePrecision
baudRateintegerbaudrequired; commonly 9600 to 115200, up to several Mbauddevice dependent
dataBitsenumbits7 or 8Not listed
stopBitsenumbits1 or 2Not listed
parityenumNonenone, even, oddNot listed
bufferSizeintegerbytesdefault 255, must be under 16 MBNot listed
flowControlenumNonenone or hardwareNot listed
usbVendorId / usbProductIdintegerNone0 to 65535from getInfo()
bluetoothServiceClassIdstringNoneUUID or 16 bit aliasChrome 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

TypeExampleApps
developerA web page flashes new code onto an Arduino or ESP32 board.Arduino, ESPHome
educationA coding class programs a robot from a browser tab.micro:bit, Raspberry Pi Pico
creativeA 3D printer dashboard sends commands from the page.Prusa, OctoPrint
enterpriseA factory tool tests devices and records the results.None named
smart-homeA page sets up a sensor board for home use.None named
securityA 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

ScoreValueMeaning
Sensitivity4 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough 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
  • 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.

On this page