Spec-Zone.ru › Web APIs

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.

Исключения

InvalidStateError DOMException

Возвращается, если порт уже открыт.

NetworkError DOMException

Возвращается, если попытка открыть порт не удалась.

Примеры

Перед взаимодействием с последовательным портом он должен быть открыт. Открытие порта позволяет сайту указать необходимые параметры, управляющие передачей и приемом данных. Разработчики должны проверить документацию подключенного устройства для получения соответствующих параметров.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API