Spec-Zone.ru › Web APIs

SerialPort: событие connect

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из самых широко используемых браузеров.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Экспериментально: Это экспериментальная технология
Перед использованием в продакшене тщательно проверьте таблицу совместимости браузеров.

Примечание: Эта функция доступна в посвященных веб-воркерах.

Событие connect интерфейса SerialPort срабатывает при подключении порта к устройству.

Описание

Более конкретно, событие connect срабатывает, когда порт становится логически подключенным к устройству после того, как пользователь разрешил сайту получить доступ к порту после вызова Serial.requestPort():

  • В случае проводного последовательного порта это происходит, когда порт физически подключен к устройству, например, через USB.
  • В случае беспроводного последовательного порта (например, Bluetooth RFCOMM) это происходит, когда порт устанавливает одно или несколько активных соединений с устройством (например, через Bluetooth L2CAP-каналы).

Передача

Это событие передается экземпляру Serial, который вернул этот интерфейс. Свойство event.target ссылается на объект SerialPort, который передается.

Для получения дополнительной информации см. Передачу событий.

Синтаксис

Используйте имя события в методах, таких как addEventListener(), или задайте свойство обработчика событий.

addEventListener("connect", (event) => {});

onconnect = (event) => {};

Тип события

Общее Event.

Примеры

Уведомление о подключении определенного порта

Метод Serial.requestPort() возвращает Promise, который разрешается объектом SerialPort, выбранным пользователем.

// Prompt user to choose a serial port
const port = await navigator.serial.requestPort();

port.addEventListener("connect", (event) => {
  // notify that the chosen port is connected
});

Прослушивание любых новых подключенных портов

Событие connect передается объекту Serial, где можно прослушать любые новые подключенные порты.

navigator.serial.addEventListener("connect", (event) => {
  // notify that a new port is available
  // use `event.target` to refer to the newly-added port
});

Спецификации

Спецификация
Web Serial API
# dfn-connect
Web Serial API
# dom-serialport-onconnect

Совместимость браузеров

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet WebView Android
connect_event 89 89 Нет 75 Нет Нет Нет Нет Нет Нет Нет
bluetooth_rfcomm 130 130 Нет 115 Нет Нет Нет Нет Нет Нет Нет

См. также

  • disconnect событие

© 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/connect_event

Spec-Zone.ru

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