Serial: getPorts() メソッド
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
メモ: この機能は専用ウェブワーカー内で利用可能です。
getPorts() は Serial インターフェイスのメソッドで、接続されており、かつこのオリジンにアクセス許可があるシリアルポートを表す SerialPort の配列で解決するプロミス (Promise) を返します。
構文
js
getPorts()
引数
なし。
返値
SerialPort オブジェクトの配列で解決する Promise を返します。
例外
SecurityErrorDOMException-
返された
Promiseは、以下のいずれかの場合、このエラーで拒否されます。
例
利用可能なポートの一覧
この例では、getPorts() を用いて利用可能なポートのリストを初期化します。
js
navigator.serial.getPorts().then((ports) => {
// ページの読み込み時、`ports` を用いて利用可能なポートのリストを初期化します。
});
仕様書
| 仕様書 |
|---|
| Web Serial API # dom-serial-getports |