Serial.getPorts()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
Serial
インターフェイスの getPorts()
メソッドは、接続されており、かつオリジンにアクセス許可があるシリアルポートを表す SerialPort
の配列で解決する Promise
を返します。
構文
js
getPorts()
引数
なし。
返値
SerialPort
オブジェクトの配列で解決する Promise
を返します。
例外
SecurityError
DOMException
-
Feature Policy でこの API の使用が制限されていたり、ユーザーの操作によって API の使用が許可されていないとき、返された
Promise
がこのエラーで拒否されます。
例
この例では、getPorts()
を用いて利用可能なポートのリストを初期化します。
js
navigator.serial.getPorts().then((ports) => {
// ページの読み込み時、`ports` を用いて利用可能なポートのリストを初期化します。
});
仕様書
Specification |
---|
Web Serial API # dom-serial-getports |
ブラウザーの互換性
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getPorts |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.