SerialPort: метод open()
Ограниченная доступность
Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.
Экспериментальная функция: Это экспериментальная технология
Перед использованием в продуктовой среде тщательно ознакомьтесь с таблицей совместимости с браузерами.
Примечание: Эта функция доступна в посвященных веб-воркерах.
Метод open() интерфейса SerialPort возвращает Promise, который разрешается при открытии порта. По умолчанию порт открывается с 8 битами данных, 1 стопом и без проверки чётности. Параметр baudRate обязателен.
Синтаксис
open(options)
Параметры
options-
Объект с любыми из следующих значений:
baudRate-
Положительное ненулевое значение, определяющее скорость передачи данных, с которой должно быть установлено серийное общение.
bufferSizeНеобязательно-
Беззнаковое целое число, указывающее размер буферов чтения и записи, которые должны быть созданы. Если не указано, по умолчанию равно 255.
dataBitsНеобязательно-
Целое значение 7 или 8, указывающее количество битов данных на кадр. Если не указано, по умолчанию равно 8.
flowControlНеобязательно-
Тип управления потоком, либо
"none"либо"hardware". По умолчанию"none". parityНеобязательно-
Режим чётности, либо
"none","even", или"odd". По умолчанию"none". stopBitsНеобязательно-
Целое значение 1 или 2, указывающее количество стопов в конце кадра. Если не указано, по умолчанию равно 1.
Возвращаемое значение
A Promise.
Исключения
-
InvalidStateErrorDOMException -
Возвращается, если порт уже открыт.
-
NetworkErrorDOMException -
Возвращается, если попытка открыть порт не удалась.
Примеры
Перед взаимодействием с последовательным портом он должен быть открыт. Открытие порта позволяет сайту указать необходимые параметры, управляющие передачей и приемом данных. Разработчики должны проверить документацию подключенного устройства для получения соответствующих параметров.
await port.open({ baudRate: 9600 /* pick your baud rate */ });
Спецификации
| Спецификация |
|---|
| Web Serial API # dom-serialport-open |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
open |
89 | 89 | Нет | 75 | Нет | Нет | Нет | Нет | Нет | Нет | Нет |
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SerialPort/open