Serial: метод getPorts()
Ограниченная доступность
Эта функция не является базовой, так как она не работает в некоторых из самых широко используемых браузеров.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или всех поддерживающих браузерах.
Экспериментальная: Это экспериментальная технология
Перед использованием в производстве внимательно ознакомьтесь со таблицей совместимости браузеров.
Примечание: Эта функция доступна в посвященных веб-воркерах.
Метод getPorts() интерфейса Serial возвращает Promise, который разрешается массивом объектов SerialPort, представляющих последовательные порты, подключенные к хосту, к которому у источника есть разрешение доступа.
Синтаксис
getPorts()
Параметры
Нет.
Возвращаемое значение
A Promise, который разрешается массивом объектов SerialPort.
Исключения
-
SecurityErrorDOMException -
Возвращаемый
Promiseотклоняется с этой ошибкой в следующих ситуациях:- Политика разрешений
serialблокирует использование этой функции. - Пользователь отказался предоставить разрешение.
- Политика разрешений
Примеры
Следующий пример использует getPorts() для инициализации списка доступных портов.
navigator.serial.getPorts().then((ports) => {
// Initialize the list of available ports with `ports` on page load.
});
Спецификации
| Спецификация |
|---|
| Web Serial API # dom-serial-getports |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
getPorts |
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/Serial/getPorts