/
index.md
67 lines (42 loc) · 2.46 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
---
title: "SerialPort: disconnect イベント"
slug: Web/API/SerialPort/disconnect_event
l10n:
sourceCommit: ba5931fadbcc3b79ffacbb442b58380c827fc0ae
---
{{SecureContext_Header}}{{APIRef("Serial API")}}{{SeeCompatTable}}
{{domxref("SerialPort")}} インターフェイスの **`disconnect`** イベントは、ポートがデバイスから切断された時、発火します。このイベントは、USB で接続されたデバイスなどの取り外し可能なデバイスに関連付いたポートに関してのみ発火します。
このイベントは、このインターフェイスを返した {{domxref("Serial")}} のインスタンスに伝搬します。
## 構文
{{domxref("EventTarget.addEventListener", "addEventListener()")}} のようなメソッドでイベント名を用いるか、イベントハンドラープロパティを設定します。
```js
addEventListener("disconnect", (event) => {});
ondisconnect = (event) => {};
```
## 型
汎用の {{domxref("Event")}} です。
## バブリング
このイベントは {{domxref("Serial")}} に伝搬します。`event.target` プロパティはイベントを発生させた {{domxref('SerialPort')}} オブジェクトを指します。
詳しくは、[イベントのバブリングとキャプチャリング](/ja/docs/Learn/JavaScript/Building_blocks/Events#%E3%82%A4%E3%83%99%E3%83%B3%E3%83%88%E3%81%AE%E3%83%90%E3%83%96%E3%83%AA%E3%83%B3%E3%82%B0%E3%81%A8%E3%82%AD%E3%83%A3%E3%83%97%E3%83%81%E3%83%A3%E3%83%AA%E3%83%B3%E3%82%B0)を参照してください。
## 例
### 特定のポートが切断された時通知する
ここでは、イベントリスナーを特定の {{domxref("SerialPort")}} オブジェクトに設定します。
```js
port.addEventListener("disconnect", (event) => {
// このポートが利用不可能になったことを通知する
});
```
### 利用不可能になった任意のポートを監視する
`disconnect` イベントは {{domxref("Serial")}} オブジェクトに伝搬し、ここで利用不可能になった任意のポートを監視することができます。
```js
navigator.serial.addEventListener("disconnect", (event) => {
// ポートが利用不可能になったら通知する
// 利用不可能になったポートを参照するには、`event.target` を使う
});
```
## 仕様書
{{Specifications}}
## ブラウザーの互換性
{{Compat}}
## 関連情報
- {{domxref("SerialPort.connect_event", "connect")}} イベント