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
});
Спецификации
Совместимость браузеров
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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