From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/navigator/getbattery/index.html | 92 ++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 files/ja/web/api/navigator/getbattery/index.html (limited to 'files/ja/web/api/navigator/getbattery/index.html') diff --git a/files/ja/web/api/navigator/getbattery/index.html b/files/ja/web/api/navigator/getbattery/index.html new file mode 100644 index 0000000000..eb379249af --- /dev/null +++ b/files/ja/web/api/navigator/getbattery/index.html @@ -0,0 +1,92 @@ +--- +title: Navigator.getBattery() +slug: Web/API/Navigator/getBattery +tags: + - API + - Battery API + - Device API + - Method + - Navigator + - Reference + - getBattery + - メッセージ +translation_of: Web/API/Navigator/getBattery +--- +
{{ ApiRef("Battery API") }}{{deprecated_header}}
+ +

getBattery() メソッドは、システムのバッテリーに関する情報を提供します。これは {{domxref("BatteryManager")}} オブジェクトで解決されるバッテリーの promise を返し、バッテリーの状態を監視するために処理できるいくつかの新しいイベントを提供します。これは Battery Status API を実装しています。詳細、API の使用ガイド、サンプルコードについては、そのドキュメントを参照してください。

+ +
+

メモ: ブラウザーによっては、この機能へのアクセスは {{HTTPHeader("Feature-Policy")}} の {{HTTPHeader("Feature-Policy/battery","battery")}} ディレクティブで制御されます。

+
+ +

構文

+ +
var batteryPromise = navigator.getBattery();
+ +

Return value

+ +

解決されると、バッテリーの状態に関する情報を取得するために使用できる {{DOMxRef("BatteryManager")}} オブジェクトを単一の引数として持つフルフィルメントハンドラーを呼び出す {{JSxRef("Promise")}} です。

+ +

例外

+ +

このメソッドは真の例外を発生させません。代わりに、返された promise を拒絶し、 {{domxref("DOMException")}} の中に name を次のうちの一つに設定します。

+ +
+
SecurityError
+
ユーザーエージェントは安全でないコンテキストではバッテリー情報を公開しませんが、このメソッドが安全でないコンテキストから呼び出されました。
+ メモ: 一部のユーザーエージェントの古いバージョンでは、安全でないコンテキストでこの機能の利用を許可していることがあります。
+
NotAllowedError
+
メモ: 現在この例外を発生させるユーザーエージェントはありませんが、仕様書では以下のような動作が記述されています。
+ この文書ではこの機能の使用が許可されていません。例えば、 {{HTTPHeader("Feature-Policy")}} {{HTTPHeader("Feature-Policy/battery", "battery")}} 機能を介して明示的に許可されてなかったり、制限されていたりした場合です。
+
+ +

例

+ +

この例では、バッテリーの現在の充電状態を取得し、充電状態が変化するたびに充電状態が記録されるように、 {{Event("chargingchange")}} イベントのハンドラーを確立します。

+ +
let batteryIsCharging = false;
+
+navigator.getBattery().then(function(battery) {
+  batteryIsCharging = battery.charging;
+
+  battery.addEventListener('chargingchange', function() {
+    batteryIsCharging = battery.charging;
+  });
+});
+ +

Battery Status API をご覧ください。

+ + + +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName("Battery API", "#dom-navigator-getbattery", "Navigator.getBattery()")}}{{Spec2("Battery API")}}初回定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.Navigator.getBattery")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf