battery-ja.html

<!DOCTYPE html><html lang="ja"><head><meta charset="utf-8">
<title>Battery Status API （日本語訳）</title>

<link rel="stylesheet" href="common.css" type="text/css">
<link rel="stylesheet" href="common-w3c.css" type="text/css">
<style>
.test {
	background: var(--note-bg-color);
}
</style>


<script src="common0.js"></script>
<script src="common1.js" async></script>


<script>
Util.ready = function(){
	const source_data = {
		toc_main: 'MAIN0',
		generate: expand
	}

	Util.switchWordsInit(source_data);
}

function expand(){
	const class_map = this.class_map;
	const tag_map = this.tag_map;
	const link_map = this.link_map;
	const unicode_map = this.unicode_map;

	let current_ifc = '';

	return this.html.replace(
		/%[\w\-~一-鿆]+|`(.*?)([$@\^])(\w*)/g,
		create_html
	);

	function create_html(match, key, indicator, klass){
if(!indicator) {//%
	return `<var>${match.slice(1)}</var>`;
}

let text = key;
let href = '';

switch(klass){
case 'r':
	text = `[${key}]`;
	href = `#bib-${key.toLowerCase()}`;
	break;
case 'm':
	const n = text.indexOf('(');
	if(n > 0){
		key = text.slice(0, n);
		text = key + text.slice(n).replace(/\w+/g, '<var>$&</var>');
	}
	break;
case '0':
	href = link_map[ `m.${key}`];
	break;
case 'l':
	text = `"<code class="literal">${key}</code>"`;
	break;
case 'sl':
	text = `[[${key}]]`;
	break;
case 'test': // tests
	href = `https://wpt.live/battery-status/${key}.https.html`;
	text = `${key}`;
	break;
case 'en':
	return `<span lang="en">${key}</span>`;
	break;
}

let tag = tag_map[klass];
if(tag) {
	let classname = class_map[klass];
	classname = classname ? ` class="${classname}"` : '';
	text = `<${tag}${classname}>${text}</${tag}>`;
}

if(indicator !== '^'){
	href = link_map[ klass ? `${klass}.${key}` : key ] || href;
	if(!href){
		console.log(match); // check error
		return match;
	}

	switch(indicator){
	case '$':
		text = `<a href="${href}">${text}</a>`;
		break;
	case '@':
		text = `<dfn id="${href.slice(1)}">${text}</dfn>`;
		break;
	}
}

return text;

	}
}
</script>


<script type="text/plain" id="_source_data">


●●options
spec_title:Battery Status API
spec_date:2024-10-24
trans_update:2024-10-13
source_checked:240105
original_url:https://w3c.github.io/battery/
	abbr_url:BATTERY
spec_status:ED
ref_id_prefix:bib-
ref_id_lowercase:true
page_state_key:SENSORS
site_nav:sensors
	conformance:w3c
copyright:2024,permissive
trans_1st_pub:2019-09-03


●●class_map
E:error
et:event-type
e:element
v:value
jv:js-value
sl:js-slot

●●tag_map
c:code
I:code
E:code
m:code
et:code
e:code
v:code
jv:code
sl:span
i:i
cite:cite

●●original_id_map

●●mdn_urls
dom-batterymanager:API/BatteryManager

dfn-chargingchange:Events/chargingchange
dfn-chargingtimechange:Events/chargingtimechange
dfn-dischargingtimechange:Events/dischargingtimechange
dfn-levelchange:Events/levelchange

●●link_map

Exposed:~WEBIDLjs#Exposed
SecureContext:~WEBIDLjs#SecureContext

boolean:~WEBIDL#idl-boolean
double:~WEBIDL#idl-double
unrestricted double:~WEBIDL#idl-unrestricted-double
Promise:~WEBIDL#idl-promise
c.Promise:~WEBIDL#idl-promise

E.NotAllowedError:~WEBIDL#notallowederror

I.EventHandler:~WAPI#eventhandler
I.EventTarget:~DOM4#eventtarget
I.Navigator:~HTMLnavigator#navigator
I.Window:~WINDOW#window
I.BatteryManager:#dom-batterymanager

m.charging:#dom-batterymanager-charging
m.chargingTime:#dom-batterymanager-chargingtime
m.dischargingTime:#dom-batterymanager-dischargingtime
m.getBattery:#dom-navigator-getbattery
m.level:#dom-batterymanager-level
m.onchargingchange:#dom-batterymanager-onchargingchange
m.onchargingtimechange:#dom-batterymanager-onchargingtimechange
m.ondischargingtimechange:#dom-batterymanager-ondischargingtimechange
m.onlevelchange:#dom-batterymanager-onlevelchange

m.addEventListener:~DOM4#dom-eventtarget-addeventlistener
m.querySelector:~DOM4#dom-parentnode-queryselector
m.textContent:~DOM4#dom-node-textcontent

sl.BatteryPromise:#dfn-batterypromise
sl.BatteryManager:#dfn-batterymanager
sl.Charging:#dfn-charging
sl.ChargingTime:#dfn-chargingtime
sl.DischargingTime:#dfn-dischargingtime
sl.Level:#dfn-level

et.chargingchange:#dfn-chargingchange
et.chargingtimechange:#dfn-chargingtimechange
et.dischargingtimechange:#dfn-dischargingtimechange
et.levelchange:#dfn-levelchange

l.'self':~PERMISSIONS-POLICY#default-allowlist-self

	●用語
~battery状態s~task~source:#dfn-battery-status-task-source
現在の~battery状態s情報:#dfn-current-battery-status-information
~battery状態s情報を報告-不能:#dfn-unable-to-report-the-battery-status-information
~battery状態sを更新して通知する:#dfn-update-the-battery-status-and-notify

	~UA:#dfn-user-agent

	●用語（外部
~task:~WAPI#concept-task
~task~source:~WAPI#task-source
大域~taskを~queueする:~WAPI#queue-a-global-task
現在の大域~obj:~WAPI#current-global-object
関連な~realm:~WAPI#concept-relevant-realm
関連な大域~obj:~WAPI#concept-relevant-global

~eventを発火する:~DOM4#concept-event-fire
~event~handler:~WAPI#event-handlers
~event~handler~event型:~WAPI#event-handler-event-type

利用は許容されて:~HEembed#allowed-to-use
結付けられた文書:~WINDOW#concept-document-window

既定の許容list:~PERMISSIONS-POLICY#policy-controlled-feature-default-allowlist
施策により制御される特能:~PERMISSIONS-POLICY#policy-controlled-feature
	識別される特能:~PERMISSIONS#_powerful-feature-by-name

新たな~obj:~WEBIDLjs#new
~promiseを却下する:~WEBIDLjs#reject
~promiseを解決する:~WEBIDLjs#resolve
新たな~promise:~WEBIDLjs#a-new-promise

内部~slot:~TC39#sec-object-internal-methods-and-internal-slots

●●words_table1


●●words_table

	●battery
battery::::バッテリー
device:
	~hostしている:hosting
充電-:charge::~
充電:charging::~
放電-:discharge::~
放電:discharging::~
満杯:full::~
直列:serial::~
並列:parallel::~
枯渇-:exhaust:~
総和:sum::~
容量:capacity::~
平均:average::~
加重:weighted::~
電力:power:~
	効率的に電力を使う:power-efficient
装備-:attach::~

	秒数で:in seconds
	秒数による:in seconds
	分単位:in minutes
	ようとする／しつつ:about to be
	尽きる:run out
	数秒ごと:every few seconds
	残り少ない:low
	残り時間:time remaining
	短命に:negatively affect the battery life
	使い果たした:depleted
	-:plugged

	●保安
私的:private::~
透明性:transparency::~
読出:readout::読み出し
ボヤカして:obfuscateして:ぼやかして
revokeする::取り消す
	指紋収集~行路:fingerprinting vector
許容list:allowlist::許容 list:許容リスト

	●仕様
	~Web~IDL:WebIDL
控えめ:unobtrusive:~
伝える:informする:~
模倣-:emulate:~
素朴:naive:~
	素朴:naïve:~
縮小:scale back:~
高度な:advanced:~
模範型:archetype:~
細工-:craft:~
退行-:degrade:~
捏造した:fakeな:~
一体化-:unify:~
横断的:horizontal:~
最新:latest:~
現代化:modern 化:~
	現代化:modernization
目指す:aimする:~

	Battery Status API:~battery状態s~API
	しかなくなる:must
	不能:unable to
	委ねられ:left to
	目下の:at hand
	知る:know#2
	編集~app:word processor
	見做す:assumption#1
	足りて:sufficient
	満たされ:meeting
	~~可能性:potential
	~~簡単な:trivial
	~web上の:web-based
	あるいは:alternatively
	別法として:alternatively
	その結果:thereby 〜leading to
	回:round
	~WG:group
	pull 要請:PR

	●未分類
email::::メール
保存-:save:~
喪失:loss:~
書込む:writeする::書き込む
高-:high:~
管理器:manager::~::マネージャ
navigator::::ナビゲータ

	`+Infinity^jv:positive Infinity
	~instance化:instantiate
	新着:new
	問い合わせ:check
	~~頻度:definition of how often
	その頻度を下げる:less frequently
	より速く:faster
	%~event名:eventName
	%大域~obj:global
	%~navigator:navigator
	%~battery管理器:~batteryManager:#1

	●指示語
	ある:at least one


●●ref_normative

[dom]
    DOM Standard. Anne van Kesteren. WHATWG. Living Standard. URL: https://dom.spec.whatwg.org/ 
[ECMASCRIPT]
    ECMAScript Language Specification. Ecma International. URL: https://tc39.es/ecma262/multipage/ 
[html]
    HTML Standard. Anne van Kesteren; Domenic Denicola; Ian Hickson; Philip Jägenstedt; Simon Pieters. WHATWG. Living Standard. URL: https://html.spec.whatwg.org/multipage/ 
[permissions-policy]
    Permissions Policy. Ian Clelland. W3C. 18 December 2023. W3C Working Draft. URL: https://www.w3.org/TR/permissions-policy-1/ 
[RFC2119]
    Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119 
[RFC8174]
    Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words. B. Leiba. IETF. May 2017. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc8174 
[WEBIDL]
    Web IDL Standard. Edgar Chen; Timothy Gu. WHATWG. Living Standard. URL: https://webidl.spec.whatwg.org/ 

●●
ref_informative


●●trans_metadata
<p>
~THIS_PAGEは、~W3Cにより勧告として公開された
<a href="~SPEC_URL">Battery Status API</a>
を日本語に翻訳したものです。
~PUB
</p>


●●spec_metadata

最新公表バージョン
	https://www.w3.org/TR/battery-status/
公表履歴
	https://www.w3.org/standards/history/battery-status/
編集者草案
	https://w3c.github.io/battery/
commit 履歴
	https://github.com/w3c/battery/commits/
テスト一式
	https://wpt.live/battery-status/
実装報告
	https://w3c.github.io/test-results/battery-status/20160621.html
編集
	Anssi Kostiainen (Intel Corporation)
前任編集者
	Raphael Kubo da Costa (Intel Corporation)
	Mounir Lamouri (Google Inc.) (previously Mozilla)
フィードバック
	<a href="https://github.com/w3c/battery/">GitHub w3c/battery</a> (<a href="https://github.com/w3c/battery/pulls/">pull requests</a>, <a href="https://github.com/w3c/battery/issues/new/choose">new issue</a>, <a href="https://github.com/w3c/battery/issues/">open issues</a>)
	<a href="mailto:public-device-apis@w3.org?subject=%5Bbattery-status%5D%20YOUR%20TOPIC%20HERE">public-device-apis@w3.org</a> with subject line <kbd>[battery-status] <em>… message topic …</em></kbd> (<a rel="discussion" href="https://lists.w3.org/Archives/Public/public-device-apis">archives</a>)

公表者
	<a href="https://www.w3.org/groups/wg/das">Device and Sensors WG</a>
</script>
</head>

<body>

<header>
	<hgroup>
<h1>Battery Status API</h1>
	</hgroup>
</header>

<div id="MAIN" hidden>

	<section id="abstract">
◎要約

<p>
この仕様は、
~hostしている~deviceの~battery状態sについての情報を供する~APIを定義する。
◎
This specification defines an API that provides information about the battery status of the hosting device.
</p>

	</section>
	<section id="sotd">
◎位置付け

<p>
この節では、公表~時点における…
【以下、この節の他の内容は、~SOTD-W3Cに移譲。】
</p>

<p>
`Devices and Sensors ~WG^cite は、
この仕様に編集上の現代化を適用することに加え，
横断的な考査を要請する前に［
当~APIの~securityと~privacyの側面に対する自己-考査と改訂
］回を遂行することになる。
既存の
<a href="https://www.w3.org/PM/horizontal/review.html?shortname=battery-status">［
~security／~privacy
］の課題</a>
も可用である。
◎
The Devices and Sensors Working Group will apply editorial modernizations to this specification, perform a round of self-review and revisions on the security and privacy aspects of the API before requesting horizontal review. Existing security and privacy issues are available.
</p>

	</section>

<main id="MAIN0">

	<section id="introduction">
<h2 title="Introduction">1. 序論</h2>

◎非規範的

<p>
`~battery状態s~API^cite（ `Battery Status API^en ）は、
~web開発者~用に［
~hostしている~deviceの~battery状態sを~program的に決定する手段
］を定義する。
~web開発者は、［
~deviceの~battery状態sを知り得ない下で~web~appを設計する
］ときは，［
~battery~levelは、
目下の~task用に足りている
］と見做すしかなくなる。
このことは、［
~deviceの~batteryは、
欲されるより速く枯渇し得る
］ことを意味する
— ~web開発者は、
~battery状態sに基づいて裁定を下せないので。
~battery状態sの知識がある下では、
~web開発者は，~web内容と~appを効率的に電力を使うよう細工-可能になり、
その結果，利用者~体験も改善される。
しかしながら、
作者は，［
この~APIの素朴な実装【利用？】は、
~batteryを短命にし得る
］ことを自覚するべきである。
◎
The Battery Status API specification defines a means for web developers to programmatically determine the battery status of the hosting device. Without knowing the battery status of a device, a web developer must design the web application with an assumption of sufficient battery level for the task at hand. This means the battery of a device may exhaust faster than desired because web developers are unable to make decisions based on the battery status. Given knowledge of the battery status, web developers are able to craft web content and applications which are power-efficient, thereby leading to improved user experience. Authors should be aware, however, that a naïve implementation of this API can negatively affect the battery life.
</p>

<p>
`~battery状態s~API^citeは、
~deviceの~batteryが［
充電-中でないか, 残り少ない
］ときには，作業を［
先送りする／縮小する
］ために利用できる。
高度な~web~appの模範型（ `archetype^en ）や
~web上の~email~clientは、［
~deviceを充電している間は、
数秒ごとに新着~emailの有無を~serverに問い合わせる
］一方で，［
~deviceの~batteryが［
充電-中でない／残り少ない
］場合には、
その頻度を下げる
］こともあろう。
別の例として、
~web上の編集~appは，［
~battery~levelを監視して、
~batteryが尽きる前に変更を保存して，~data喪失を防止する
］こともできる。
◎
The Battery Status API can be used to defer or scale back work when the device is not charging in or is low on battery. An archetype of an advanced web application, a web-based email client, may check the server for new email every few seconds if the device is charging, but do so less frequently if the device is not charging or is low on battery. Another example is a web-based word processor which could monitor the battery level and save changes before the battery runs out to prevent data loss.
</p>

	</section>
	<section id="conformance">
<h2 title="Conformance">2. 適合性</h2>

<p class="trans-note">【
この節の内容は <a href="~W3Ccommon#conformance">~W3C日本語訳 共通~page</a>に移譲。
】</p>

<!-- 
This specification defines conformance criteria that apply to a single product: the user agent that implements the interfaces that it contains.
-->

	</section>
	<section id="security-and-privacy-considerations">
<h2 title="Security and privacy considerations">3. ~security／~privacyの考慮点</h2>

<p>
この仕様に定義される~APIは、
~hostしている~deviceの~battery状態sを決定するために利用される。
~UAは：
◎
The API defined in this specification is used to determine the battery status of the hosting device.
</p>
<ul>
	<li>
~battery状態s情報の高-精度な読出を公開するベキでない
— 新たな指紋収集~行路を導入し得るので。
◎
The user agent SHOULD not expose high precision readouts of battery status information as that can introduce a new fingerprinting vector.
</li>
	<li>
~battery状態s情報への~access【の許可】を利用者に依頼してもヨイ。
あるいは、
私的~閲覧~modeにおいては，利用者~許可の要件を施行してもヨイ。
◎
The user agent MAY ask the user for battery status information access, or alternatively, enforce the user permission requirement in its private browsing modes.
</li>
	<li>
~scriptによる この~APIの利用を控えめな方式で，利用者に伝えるベキである
— 透明性を援助するため，および
~API~access【の許可】を~revokeすることを利用者に許容するため。
◎
The user agent SHOULD inform the user of the API use by scripts in an unobtrusive manner to aid transparency and to allow the user to revoke the API access.
</li>
	<li>
［
~hostしている~deviceには~batteryは無い ／
~batteryは充電-中／
捏造した値を公開している
］場合には、
公開される値を作者が直に知り得ない仕方でボヤカしてもヨイ。
◎
The user agent MAY obfuscate the exposed value in a way that authors cannot directly know if a hosting device has no battery, is charging or is exposing fake values.
</li>
</ul>

	</section>
	<section id="concepts">
<h2 title="Concepts">4. 概念</h2>

<p>
この仕様~内に言及される`~task$用の`~task~source$は、
`~battery状態s~task~source@
とする。
◎
The task source for the tasks mentioned in this specification is the battery status task source.
</p>

	</section>
	<section id="extensions-to-the-navigator-interface">
<h2 title="Extensions to the Navigator interface">5. `Navigator^I ~interfaceに対する拡張</h2>

<pre class="idl">
[`SecureContext$]
partial interface `Navigator$I {
  `Promise$&lt;`BatteryManager$I&gt; `getBattery$m();
};
</pre>

<p class="note">注記：
`getBattery()^m ~methodは、
<a href="https://github.com/w3c/battery/pull/51">pull 要請 #51</a>
が取り込まれるまでは，
~secureでない文脈にも公開されていた。
◎
Note
This method was exposed to a non-secure context until PR #51.
</p>

<div>
<p id="internal-slots">
各 `Navigator$I ~obj %~navigator は、
次に挙げる内部~slotを伴う：
</p>
<dl class="def-list">
	<dt>
`BatteryPromise@sl
</dt>
	<dd>
初期~値は ~NULL とする。
</dd>
	<dd>
%~navigator に対する `getBattery()$m の~callに対し返される `Promise$c 。
</dd>

	<dt>`BatteryManager@sl</dt>
	<dd>
初期~値は ~NULL とする。
</dd>
	<dd>
%~navigator に結付けられた `BatteryManager$I ~instance
— `getBattery()$m を介して作成されたならば。
</dd>
</dl>
◎
5.1 Internal slots
◎
Internal slot｜Initial value｜Description
[[BatteryPromise]]｜null｜A Promise returned by calls to getBattery().
[[BatteryManager]]｜null｜The BatteryManager instance associated with a given Navigator after it has been created via getBattery().
</div>

<div class="algo">
<p id="the-getbattery-method">
`getBattery()@m
~method手続きは：
◎
5.2 The getBattery() method
◎
The getBattery() method steps are:
</p>

<p class="test">
~test：
`battery-promise-window$test,
`battery-promise$test
<small>（これらの~testには、~secureな接続（~HTTPS）が要求される）</small>
◎
tests: 2
• battery-promise-window 🔒
• battery-promise 🔒
</p>

<ol>
	<li>
~IF［
コレ.`BatteryPromise$sl ~EQ ~NULL
］
⇒
コレ.`BatteryPromise$sl ~SET `新たな~promise$( コレに`関連な~realm$ )
◎
If this.[[BatteryPromise]] is null, then set it to a new promise in this's relevant realm.
</li>
	<li>
%文書 ~LET コレに`関連な大域~obj$に`結付けられた文書$
◎
↓</li>
	<li>
~IF［
%文書 には［
`battery^l で識別される`施策により制御される特能$
］の`利用は許容されて$いない
］
⇒
`~promiseを却下する$( コレ.`BatteryPromise$sl, `NotAllowedError$E 例外 )
◎
If this's relevant global object's associated Document is not allowed to use the "battery" policy-controlled feature, then reject this.[[BatteryPromise]] with a "NotAllowedError" DOMException.
</li>
	<li>
<p>
~ELSE：
◎
Otherwise:
</p>
		<ol>
			<li>
~IF［
コレ.`BatteryManager$sl ~EQ ~NULL
］
⇒
コレ.`BatteryManager$sl ~SET `新たな~obj$( `BatteryManager$I, コレに`関連な~realm$ )
◎
If this.[[BatteryManager]] is null, then set it to the result of creating a new BatteryManager in this's relevant realm.
</li>
			<li>
`~promiseを解決する$( コレ.`BatteryPromise$sl, コレ.`BatteryManager$sl )
◎
Resolve this.[[BatteryPromise]] with this.[[BatteryManager]].
</li>
		</ol>
	</li>
	<li>
~RET コレ.`BatteryPromise$sl
◎
Return this.[[BatteryPromise]].
</li>
</ol>
</div>

	</section>
	<section id="the-batterymanager-interface">
<h2 title="The BatteryManager interface">6. `BatteryManager^I ~interface</h2>

<pre class="idl">
[`SecureContext$, `Exposed$=`Window$I]
interface `BatteryManager$I : `EventTarget$I {
    readonly        attribute `boolean$             `charging$m;
    readonly        attribute `unrestricted double$ `chargingTime$m;
    readonly        attribute `unrestricted double$ `dischargingTime$m;
    readonly        attribute `double$              `level$m;
                    attribute `EventHandler$I        `onchargingchange$m;
                    attribute `EventHandler$I        `onchargingtimechange$m;
                    attribute `EventHandler$I        `ondischargingtimechange$m;
                    attribute `EventHandler$I        `onlevelchange$m;
};
</pre>

<p>
`BatteryManager@I
~interfaceは、
~hostしている~deviceの
`現在の~battery状態s情報@
を表現する。
◎
The BatteryManager interface represents the current battery status information of the hosting device.
</p>

<p>
~UAは、
— 例えば、［
利用者または~system
］の［
選好／設定／制限
］に因り —
【！any of】ある属性~用の値を報告-不能な場合，【その属性に関して？】
`~battery状態s情報を報告-不能@
であるとされる。
◎
The user agent is said to be unable to report the battery status information if it is not able to report the values for any of the attributes, for example, due to a user or system preference, setting, or limitation.
</p>

<p class="note">注記：
~UAが`~battery状態s情報を報告-不能$な場合、
`BatteryManager$I の各~内部~slotは，各自の既定の値であり続ける
— それは、
全部的に充電された~batteryを模倣する。
このことは、
例えば［
~battery状態s情報が可用にされていない場合
］に，［
指紋収集の~~可能性を抑制すること, および
~appが処理能を退行させるのを防止すること
］を目指す。
◎
Note
If the user agent is unable to report the battery status information, the BatteryManager's internal slots will remain with their default values, which emulate a fully charged and plugged in battery. This is aimed at reducing the potential for fingerprinting and preventing applications from degrading performance, if the battery status information is not made available, for example.
</p>

		<section id="internal-slots-0">
<h3 title="Internal slots">6.1. 内部~slot</h3>

<p>
各 `BatteryManager$I ~instanceは、
次に挙げる`内部~slot$を伴って作成される：
◎
6.1 Internal slots
◎
BatteryManager instances are created with the following internal slots:
◎
Internal slot｜Initial value
[[Charging]]｜true
[[ChargingTime]]｜0
[[DischargingTime]]｜Positive Infinity
[[Level]]｜1.0
</p>

<dl class="def-list">
	<dt id="the-charging-internal-slot">
`Charging@sl
◎
The [[Charging]] internal slot
</dt>
	<dd>
初期~値は `true^jv とする。
◎
↑</dd>
	<dd>
<p>
~systemの~batteryの充電~状態を表現する：
◎
The [[Charging]] internal slot represents the charging state of the system's battery.＼
</p>
		<ul>
			<li>
次に該当する場合は ~F に設定するモノトスル
⇒＃
~batteryは放電-中
◎
It MUST be set to false if the battery is discharging,＼
</li>
			<li>
他の場合
— 次に該当する場合など —
は ~T に設定するモノトスル
⇒＃
実装は~battery充電~状態を報告-不能である ／
~batteryは充電-中 ／
~systemは~batteryを装備していない
◎
and set to true if the battery is charging, the implementation is unable to report the state, or there is no battery attached to the system, or otherwise.
</li>
		</ul>
	</dd>
	<dd class="algo">
<p>
~system~batteryの充電~状態が変化したときは、
次を走らすモノトスル：
</p>
		<ol>
			<li>
%値 ~LET 当の~batteryは［
充電-中ならば ~T ／
放電-中ならば ~F
］</li>
			<li>
`~battery状態sを更新して通知する$( `Charging$sl, %値, `chargingchange$et )
</li>
		</ol>
◎
When the system battery's charging state changes, the user agent must run the update the battery status and notify algorithm with [[Charging]], true or false depending on whether the battery is charging or discharging, and "chargingchange".
</dd>

	<dt id="the-chargingtime-internal-slot">
`ChargingTime@sl
◎
6.1.2 The [[ChargingTime]] internal slot
</dt>
	<dd>
初期~値は `0^jv とする。
◎
↑</dd>
	<dd>
<p>［
~systemの~batteryが全部的に充電される
］までの残り時間を，秒数で表現する：
◎
The [[ChargingTime]] internal slot represents the remaining time in seconds until the system's battery is fully charged.＼
</p>
		<ul>
			<li>
次に該当する場合は 0 に設定するモノトスル
⇒＃
~batteryは満杯／
~systemは~batteryを装備していない
◎
It MUST be set to 0 if the battery is full or there is no battery attached to the system,＼
</li>
			<li>
他の場合
— 次に該当する場合など —
は `+Infinity^jv に設定するモノトスル
⇒＃
~batteryは放電-中／
実装は残りの充電~時間を報告-不能
◎
and to the value positive Infinity if the battery is discharging, the implementation is unable to report the remaining charging time, or otherwise.
</li>
		</ul>
	</dd>
	<dd class="algo">
~battery充電~時間が更新されたときは、
次を走らすモノトスル
⇒
`~battery状態sを更新して通知する$( `ChargingTime$sl, 秒数による新たな充電~時間, `chargingtimechange$et )
◎
When the battery charging time is updated, the user agent must run the update the battery status and notify algorithm with [[ChargingTime]], the new charging time in seconds, and "chargingtimechange".
</dd>
	<dt id="the-dischargingtime-internal-slot">
`DischargingTime@sl
◎
6.1.3 The [[DischargingTime]] internal slot
</dt>
	<dd>
初期~値は `+Infinity^jv とする。
◎
↑</dd>
	<dd>
<p>
［
~systemの~batteryが完全に放電され，~systemは休止されようとする
］までの残り時間を，秒数で表現する。
◎
The [[DischargingTime]] attribute represents the remaining time in seconds until the system's battery is completely discharged and the system is about to be suspended.＼
</p>
		<ul>
			<li>
放電していない場合【！or otherwise】
— 次に該当する場合など —
は `+Infinity^jv に設定するモノトスル
⇒＃
~batteryは充電-中 ／
実装は残りの放電~時間を報告-不能 ／
~systemは~batteryを装備していない
◎
It MUST be set to the value positive Infinity if the battery is charging, the implementation is unable to report the remaining discharging time, there is no battery attached to the system, or otherwise.
</li>
		</ul>
	</dd>
	<dd class="algo">
~battery放電~時間が更新されたときは、
次を走らすモノトスル
⇒
`~battery状態sを更新して通知する$( `DischargingTime$sl, 秒数による新たな放電~時間, `dischargingtimechange$et )
◎
When the battery discharging time is updated, the user agent must run the update the battery status and notify algorithm with [[DischargingTime]], the new discharging time in seconds, and "dischargingtimechange".
</dd>

	<dt id="the-level-internal-slot">
`Level@sl
◎
6.1.4 The [[Level]] internal slot
</dt>
	<dd>
初期~値は `1.0^jv とする。
◎
↑</dd>
	<dd>
<p>
~systemの~batteryの~levelを表現する。
◎
The [[Level]] internal slot represents the system's battery's level.＼
</p>
		<ul>
			<li>
次に該当する場合は 0 に設定するモノトスル
⇒＃
~batteryを使い果たしたため~systemは休止されつつある
◎
It MUST be set to 0 if the system's battery is depleted and the system is about to be suspended,＼
</li>
			<li>
次に該当する場合は 1.0 に設定するモノトスル
⇒＃
~batteryは満杯 ／
実装は~battery~levelを報告-不能 ／
~systemは~batteryを装備していない
◎
and to 1.0 if the battery is full, the implementation is unable to report the battery's level, or there is no battery attached to the system.
</li>
		</ul>
	</dd>
	<dd class="algo">
~battery~levelが更新されたときは、
次を走らすモノトスル
⇒
`~battery状態sを更新して通知する$( `Level$sl, 新たな~battery~level, `levelchange$et )
◎
When the battery level is updated, the user agent must run the update the battery status and notify algorithm with [[Level]], the new battery level, and "levelchange".
</dd>
</dl>

<p class="note">注記：
［
`chargingtimechange$et ／
`dischargingtimechange$et ／
`levelchange$et
］~eventを発火する~~頻度は、
実装に委ねられる。
◎
Note
The definition of how often the "chargingtimechange", "dischargingtimechange", and "levelchange" events are fired is left to the implementation.
</p>

		</section>
		<section id="_attributes">
<h3>6.2.〜6.5. 属性</h3>

<div class="algo" id="the-charging-attribute">
`charging@m
取得子~手続きは
⇒
~RET コレ.`Charging$sl
◎
6.2 The charging attribute
◎
The charging getter steps are to return this.[[Charging]].
</div>

<div class="algo" id="the-chargingtime-attribute">
`chargingTime@m
取得子~手続きは
⇒
~RET コレ.`ChargingTime$sl
◎
6.3 The chargingTime attribute
◎
The chargingTime getter steps are to return this.[[ChargingTime]].
</div>

<div class="algo" id="the-dischargingtime-attribute">
`dischargingTime@m
取得子~手続きは
⇒
~RET コレ.`DischargingTime$sl
◎
6.4 The dischargingTime attribute
◎
The dischargingTime getter steps are to return this.[[DischargingTime]].
</div>

<div class="algo" id="the-level-attribute">
`level@m
取得子~手続きは
⇒
~RET コレ.`Level$sl
◎
6.5 The level attribute
◎
The level getter steps are to return this.[[Level]].
</div>

		</section>
		<section id="event-handlers">
<h3 title="Event handlers">6.6. ~event~handler</h3>

<p>
`BatteryManager$I ~objは、
その属性として，次に挙げる`~event~handler$
（および，それぞれに対応する`~event~handler~event型$）
を~supportするモノトスル：
◎
The following are the event handlers (and their corresponding event handler event types) that MUST be supported as attributes by the BatteryManager object:
</p>

<table><thead>
<tr><th>~event~handler
<th>~event~handler~event型
<tbody>

<tr><td>`onchargingchange@m
<td>`chargingchange@et

<tr><td>`onchargingtimechange@m
<td>`chargingtimechange@et

<tr><td>`ondischargingtimechange@m
<td>`dischargingtimechange@et

<tr><td>`onlevelchange@m
<td>`levelchange@et
</table>

		</section>
		<section id="algorithms">
<h3 title="Algorithms">6.7. ~algo</h3>

<div class="algo">
<p>
`~battery状態sを更新して通知する@
~algoは、
所与の
( 内部~slot %~slot, %値, %~event名 )
に対し：
◎
To update the battery status and notify given an internal slot slot, a value and an eventName, run the following steps:
</p>
<ol class="algorithm">
	<li>
%大域~obj ~LET `現在の大域~obj$
◎
Let global be the current global object.
</li>
	<li>
~IF［
%大域~obj は `Window$I でない
］
⇒
~RET
◎
If global is not a Window, abort these steps.
</li>
	<li>
%~navigator ~LET %大域~obj に結付けられた `Navigator$I ~obj
◎
Let navigator be global's associated Navigator.
</li>
	<li>
%~battery管理器 ~LET %~navigator.`BatteryManager$sl
◎
Let batteryManager be the value of navigator. [[BatteryManager]].
</li>
	<li>
~IF［
%~battery管理器 ~EQ ~NULL
］
⇒
~RET
◎
If batteryManager is null, abort these steps.
</li>
	<li>
<p>
`大域~taskを~queueする$( `~battery状態s~task~source$, %大域~obj, 次の手続き )
◎
Queue a global task on the battery status task source given global to＼
</p>

<div class="algo">
<p>
手続きは：
◎
run the following steps:
</p>
		<ol>
			<li>
%~battery管理器.%~slot ~SET %値
◎
Set batteryManager.slot to value.
</li>
			<li>
`~eventを発火する$( %~battery管理器, %~event名 )
◎
Fire an event named eventName at batteryManager.
</li>
		</ol>
</div>
	</li>
</ol>
</div>

		</section>
		<section id="multiple-batteries">
<h3 title="Multiple batteries">6.8. ~batteryが複数個ある場合</h3>

<p>
~hostしている~deviceが複数個の~batteryを備えている場合、
`BatteryManager$I は，それらの~batteryを一体化した~viewを公開するベキである：
◎
If a hosting device contains more than one battery, BatteryManager SHOULD expose a unified view of the batteries.
</p>

<ul>
	<li>
`Charging$sl 内部~slotは、［
ある~batteryの充電~状態が上で述べたとおり ~T になるならば ~T ／
~ELSE_ ~F
］に設定するモノトスル。
◎
The [[Charging]] internal slot MUST be set to true if at least one battery's charging state as described above is true. Otherwise, it MUST be set to false.
</li>
	<li>
`ChargingTime$sl 内部~slotは、［
並列に充電している場合は 個々の~batteryの最大~充電~時間 ／
直列に充電している場合は 個々の充電~時間の総和
］に設定できる。
◎
The [[ChargingTime]] internal slot can be set to the maximum charging time of the individual batteries if charging in parallel, and to the sum of the individual charging times if charging serially.
</li>
	<li>
`DischargingTime$sl 内部~slotは、［
並列に放電している場合は 個々の~batteryの最大~放電~時間／
直列に放電している場合は 個々の放電~時間の総和
］に設定できる。
◎
The [[DischargingTime]] internal slot can be set to the maximum discharging time of the individual batteries if discharging in parallel, and to the sum of individual discharging times if discharging serially.
</li>
	<li>
`Level$sl 内部~slotは、［
各~batteryの~battery~levelの容量に応じた加重~平均（容量がすべて同じなら，単に平均）
］に設定できる。
◎
The [[Level]] internal slot can be set to the average of the levels of batteries of same capacity, or the weighted average of the battery levels for batteries of different capacities.
</li>
</ul>

<p class="trans-note">【
~battery状態s情報を報告-不能なもの, 可能なものが混在している場合、
どう挙動するべきかは述べられていない。
】</p>

		</section>
	</section>
	<section id="permissions-policy-integration">
<h2 title="Permissions Policy integration">7. 許可~施策との統合</h2>

<p>
`~battery状態s~API^citeは、
`施策により制御される特能$であり，
文字列 `battery^l により識別される。
その`既定の許容list$は、
`'self'$l とする。
◎
The Battery Status API is a policy-controlled feature identified by the string "battery". Its default allowlist is 'self'.
</p>

	</section>
	<section id="examples">
<h2 title="Examples">8. 例</h2>

◎非規範的

<div class="example" id="example-1">

<p>
~levelが変化する各回ごとに，~battery~levelを~consoleに書込む~~簡単な例：
◎
This trivial example writes the battery level to the console each time the level changes:
◎
Example 1
</p>

<pre class="lang-js">
/* <span class="comment">
~promiseが解決されたとき、
初期~値を取得して…
◎
We get the initial value when the promise resolves ...
</span> */
navigator.`getBattery$0().then(function(%battery) {
  console.log(%battery.`level$0);
  /* <span class="comment">
…後続な更新も取得する。
◎
... and any subsequent updates.
</span> */
  %battery.`onlevelchange$0 = function() {
    console.log(this.`level$0);
  };
});
</pre>

</div>

<div class="example" id="example-2">

<p>
別法として，
`addEventListener()$m ~methodを利用しても同じになる：
◎
Alternatively, the same using the addEventListener() method:
◎
Example 2
</p>

<pre class="lang-js">
navigator.`getBattery$0().then(function(%battery) {
  console.log(%battery.`level$0);
  %battery.`addEventListener$0('`levelchange$et', function() {
    console.log(this.`level$0);
  });
});
</pre>
</div>

<div class="example" id="example-3">
<p>
次の例では、［
充電~状態,
~level,
分単位の残り時間
］を示す指示子を更新する：
◎
The following example updates the indicators to show the charging state, level and time remaining in minutes:
◎
Example 3
</p>

<pre class="lang-html">
&lt;!DOCTYPE html&gt;
&lt;html&gt;
&lt;head&gt;
  &lt;title&gt;Battery Status API Example&lt;/title&gt;
  &lt;script&gt;
    window.onload = function () {
      function updateBatteryStatus(%battery) {
        document.`querySelector$0('#charging').`textContent$0 = %battery.`charging$0 ? '充電-中' : '充電-中でない';
        document.`querySelector$0('#level').`textContent$0 = %battery.`level$0;
        document.`querySelector$0('#dischargingTime').`textContent$0 = %battery.`dischargingTime$0 / 60;
      }

      navigator.`getBattery$0().then(function(%battery) {
        /* <span class="comment">
初期~時に~promiseが解決されたとき，~battery状態sを更新して…
◎
Update the battery status initially when the promise resolves ...
</span> */
        updateBatteryStatus(%battery);

        /* <span class="comment">
…後続な更新も取得する。
◎
.. and for any subsequent updates.
</span> */
        %battery.`onchargingchange$0 = function () {
          updateBatteryStatus(%battery);
        };

        %battery.`onlevelchange$0 = function () {
          updateBatteryStatus(%battery);
        };

        %battery.`ondischargingtimechange$0 = function () {
          updateBatteryStatus(%battery);
        };
      });
    };
  &lt;/script&gt;
&lt;/head&gt;
&lt;body&gt;
  &lt;div id="charging"&gt;（充電~状態は未知）&lt;/div&gt;
  &lt;div id="level"&gt;（~battery~levelは未知）&lt;/div&gt;
  &lt;div id="dischargingTime"&gt;（放電し切るまでの時間は未知）&lt;/div&gt;
&lt;/body&gt;
&lt;/html&gt;
</pre>

</div>

	</section>
	<section id="acknowledgements">
<h2 title="Acknowledgements">謝辞</h2>

<p lang="en">
The group is deeply indebted to Mounir Lamouri, Jonas Sicking, and the Mozilla WebAPI team in general for their invaluable feedback based on prototype implementations. Many thanks to the people behind the System Information API and Device Orientation Event specification for the initial inspiration. Also thanks to the nice folks bringing us the Page Visibility specification, which motivated the editor of this specification to write the introduction chapter discussing some real-world high value use cases that apply equally to this specification. Special thanks to all the participants of the Device APIs Working Group and others who have sent in substantial feedback and comments, and made the Web a better place for everyone by doing so. Finally, thanks to Lukasz Olejnik, Gunes Acar, Claude Castelluccia, and Claudia Diaz for the privacy analysis of the API.
</p>

	</section>
</main></div>