aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/networkinformation/index.html
blob: c59961e5f91467bf7590e25247670cf1e3a88eb8 (plain)
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
---
title: NetworkInformation
slug: Web/API/NetworkInformation
tags:
  - API
  - Experimental
  - Interface
  - Network Information API
  - Reference
translation_of: Web/API/NetworkInformation
---
<div>{{APIRef("Network Information API")}}{{SeeCompatTable}}</div>

<p><code><strong>NetworkInformation</strong></code> インターフェースは、デバイスがネットワーク通信に使用している接続の情報を提供します。また、接続の種類が変更した場合、スクリプトに通知する手段を提供します。<code>NetworkInformation</code> インターフェースは、インスタンス生成できません。代わりに、{{domxref("Navigator")}} インターフェースの <code>connection</code> プロパティを通してアクセスします。</p>

<h2 id="プロパティ">プロパティ</h2>

<p><em>このインターフェースは、親である {{domxref("EventTarget")}} のプロパティも継承しています。</em></p>

<dl>
 <dt>{{domxref("NetworkInformation.type")}} {{readonlyinline}}</dt>
 <dd>デバイスがネットワーク通信に使用している接続の種類を返す。値は次のうちのいずれかである:
 <ul>
  <li><code>bluetooth</code></li>
  <li><code>cellular</code></li>
  <li><code>ethernet</code></li>
  <li><code>none</code></li>
  <li><code>wifi</code></li>
  <li><code>wimax</code></li>
  <li><code>other</code></li>
  <li><code>unknown</code></li>
 </ul>
 </dd>
 <dt>{{domxref("NetworkInformation.downlinkMax")}} {{readonlyinline}}</dt>
 <dd>メガビット毎秒(Mbps)単位で、基底の接続技術の最大下り速度を返す。</dd>
</dl>

<h3 id="イベントハンドラ">イベントハンドラ</h3>

<dl>
 <dt>{{domxref("NetworkInformation.onchange")}}</dt>
 <dd>接続情報が変更されたときに発火するイベントで、このオブジェクトで {{event("change")}} が発火する。</dd>
</dl>

<h2 id="メソッド">メソッド</h2>

<p><em>このインターフェースは、親である {{domxref("EventTarget")}} のメソッドを継承しています。</em></p>

<h2 id="仕様">仕様</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">ステータス</th>
   <th scope="col">コメント</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Network Information', '#idl-def-NetworkInformation', 'NetworkInformation')}}</td>
   <td>{{Spec2('Network Information')}}</td>
   <td>最初の定義</td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザ実装状況">ブラウザ実装状況</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>機能</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>基本サポート</td>
   <td>20 {{property_prefix("webkit")}}</td>
   <td>31.0 {{property_prefix("moz")}}<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>機能</th>
   <th>Android</th>
   <th>Android Webview</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>基本サポート</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>31.0 {{property_prefix("moz")}}<sup>[1]</sup></td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] Network API は、<code>dom.network.enabled</code> 設定で無効化できます。Gecko 12.0 から Gecko 30.0 に含まれており、このインターフェースは <code>Connection</code> と呼ばれており、異なるメンバーを持っていました。Gecko 12.0 では、Android システムでのみ Network API が実装されていました。Linux ({{bug("712442")}}) と Windows ({{bug("721306")}}) でのサポートは進行中です。</p>

<h2 id="関連項目">関連項目</h2>

<ul>
 <li><a href="/ja/docs/Web/API/Network_Information_API">Network Information API</a></li>
 <li><a href="/ja/docs/Online_and_offline_events">Online and offline events</a></li>
 <li>これを実装している {{domxref("Navigator")}} インターフェース。</li>
</ul>