notifications-ja.html

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

<link rel="stylesheet" href="common.css" type="text/css">
<link rel="stylesheet" href="common-whatwg.css" type="text/css">

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

<script>

Util.ready = function(){
	Util.switchWordsInit({
		persisted_parts: { _acks1: E('_acks1'), _ipr1: E('_ipr1') },
		toc_main: 'MAIN0',
		generate: expand
	});
}

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

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

	function create_html(match, key, indicator, klass){

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

let href = '';
let href1 = '';
{
	const n = key.indexOf('＠');
	if(n > 0) {
		href1 = key.slice(n + 1);
		key = key.slice(0, n);
	}
}
let text = key;

switch(klass){
case 'r':
	text = `[${key}]`;
	href = `#biblio-${key.toLowerCase()}`;
	break;
case 'l':
	text = `"<code class="literal">${text}</code>"`;
	break;
case 'mc':
	text = 'constructor';
	href = `#dom-${key.toLowerCase()}-${key.toLowerCase()}`;
	break;
case 'm': // IDL member
case 'mE':
	const n = text.indexOf('(');
	if(n > 0){
		key = text.slice(0, n);
		text = key + text.slice(n).replace(/\w+/g, '<var>$&</var>');
	}
	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 = href1 || 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_date:2024-11-07
trans_update:2024-11-09
source_checked:240823
spec_status:LS
original_url:https://notifications.spec.whatwg.org/
	abbr_url:NOTIFICATIONS
ref_id_prefix:biblio-
ref_id_lowercase:true
site_nav:uievents
copyright:,whatwg
trans_1st_pub:2018-01-05


●●class_map
E:error
A:abstract
jv:js-value
css:css
e:element
a:attr
v:value
et:event-type

●●tag_map
I:code
m:code
mO:code
mE:code
mA:code
mGO:code
mNI:code
E:code
p:code
css:code
ps:code
pe:code
et:code
e:code
a:code
v:code
c:code
jv:code
A:span
i:i
em:em
cite:cite

●●mdn_urls
notification:API/Notification
notificationevent:API/NotificationEvent
	callbackdef-notificationpermissioncallback:API/NotificationPermissionCallback
	dictdef-getnotificationoptions:API/GetNotificationOptions
dictdef-notificationaction:API/NotificationAction
	dictdef-notificationeventinit:API/NotificationEventInit
	dictdef-notificationoptions:API/NotificationOptions
	enumdef-notificationdirection:API/NotificationDirection
	enumdef-notificationpermission:API/NotificationPermission

●●link_map


	●IDL
Exposed:~WEBIDLjs#Exposed
SameObject:~WEBIDLjs#SameObject

any:~WEBIDL#idl-any
undefined:~WEBIDL#idl-undefined
boolean:~WEBIDL#idl-boolean
unsigned long:~WEBIDL#idl-unsigned-long
Promise:~WEBIDL#idl-promise
sequence:~WEBIDL#idl-sequence
FrozenArray:~WEBIDL#idl-frozen-array
USVString:~WEBIDL#idl-USVString
DOMString:~WEBIDL#idl-DOMString

E.TypeError:~WEBIDL#exceptiondef-typeerror

I.EpochTimeStamp:~HRTIME#dom-epochtimestamp
I.EventHandler:~WAPI#eventhandler
I.EventTarget:~DOM4#eventtarget
I.ExtendableEvent:~SW1#extendableevent
I.ExtendableEventInit:~SW1#dictdef-extendableeventinit
I.GetNotificationOptions:#dictdef-getnotificationoptions
I.Notification:#notification
I.NotificationAction:#dictdef-notificationaction
I.NotificationDirection:#enumdef-notificationdirection
I.NotificationEvent:#notificationevent
I.NotificationEventInit:#dictdef-notificationeventinit
I.NotificationOptions:#dictdef-notificationoptions
I.NotificationPermission:#enumdef-notificationpermission
I.NotificationPermissionCallback:#callbackdef-notificationpermissioncallback
I.ServiceWorkerGlobalScope:~SW1#serviceworkerglobalscope
I.ServiceWorkerRegistration:~SW1#serviceworkerregistration
I.VibratePattern:~VIBRATION#dom-vibratepattern
	:~VIBRATION#idl-def-vibratepattern

m.constructor:#dom-notification-notification
m.new Notification:#dom-notification-notification
	構築子:#dom-notification-notification
m.actions:#dom-notification-actions
m.badge:#dom-notification-badge
m.body:#dom-notification-body
m.cancelable:~DOM4#dom-event-cancelable
m.close:#dom-notification-close
m.data:#dom-notification-data
m.dir:#dom-notification-dir
m.getNotifications:#dom-serviceworkerregistration-getnotifications
m.icon:#dom-notification-icon
m.image:#dom-notification-image
m.lang:#dom-notification-lang
m.maxActions:#dom-notification-maxactions
m.onclick:#dom-notification-onclick
m.onshow:#dom-notification-onshow
m.onerror:#dom-notification-onerror
m.onclose:#dom-notification-onclose
m.onnotificationclick:#dom-serviceworkerglobalscope-onnotificationclick
m.onnotificationclose:#dom-serviceworkerglobalscope-onnotificationclose
m.permission:#dom-notification-permission
m.renotify:#dom-notification-renotify
m.requestPermission:#dom-notification-requestpermission
m.requireInteraction:#dom-notification-requireinteraction
m.showNotification:#dom-serviceworkerregistration-shownotification
m.silent:#dom-notification-silent
m.tag:#dom-notification-tag
m.timestamp:#dom-notification-timestamp
m.title:#dom-notification-title
m.vibrate:#dom-notification-vibrate
m.focus:~HTMLinteraction#dom-window-focus

m.query:~PERMISSIONS#dom-permissions-query

mA.action:#dom-notificationaction-action
mA.icon:#dom-notificationaction-icon
mA.title:#dom-notificationaction-title

mE.action:#dom-notificationevent-action
mE.notification:#dom-notificationevent-notification

mO.dir:#dom-notificationoptions-dir
mO.lang:#dom-notificationoptions-lang
mO.body:#dom-notificationoptions-body
mO.tag:#dom-notificationoptions-tag
mO.image:#dom-notificationoptions-image
mO.icon:#dom-notificationoptions-icon
mO.badge:#dom-notificationoptions-badge
mO.vibrate:#dom-notificationoptions-vibrate
mO.timestamp:#dom-notificationoptions-timestamp
mO.renotify:#dom-notificationoptions-renotify
mO.silent:#dom-notificationoptions-silent
mO.requireInteraction:#dom-notificationoptions-requireinteraction
mO.data:#dom-notificationoptions-data
mO.actions:#dom-notificationoptions-actions

mGO.tag:#dom-getnotificationoptions-tag
mNI.notification:#dom-notificationeventinit-notification
mNI.action:#dom-notificationeventinit-action

l.default:#dom-notificationpermission-default
l.denied:#dom-notificationpermission-denied
l.granted:#dom-notificationpermission-granted
l.auto:#dom-notificationdirection-auto
l.ltr:#dom-notificationdirection-ltr
l.rtl:#dom-notificationdirection-rtl

l.notifications:#permissiondef-notifications

A.StructuredDeserialize:~HTMLcloning#structureddeserialize
A.StructuredSerializeForStorage:~HTMLcloning#structuredserializeforstorage

c.Object.freeze:~TC39#sec-object.freeze

	r.BIDI:#biblio-bidi
	r.DOM:#biblio-dom
	r.FETCH:#biblio-fetch
	r.HTML:#biblio-html
	r.INFRA:#biblio-infra
	r.LANG:#biblio-lang
	r.SERVICE-WORKERS:#biblio-service-workers
	r.URL:#biblio-url
	r.VIBRATION:#biblio-vibration
	r.WEBIDL:#biblio-webidl

	●用語
唯一の:#_only-one

通知を~alertする:#alert-steps
通知を閉じる:#close-steps
通知を~fetchする:#fetch-steps
通知を示す:#notification-show-steps
通知~許可~状態を取得する:#get-the-notifications-permission-state

最大~動作~数:#maximum-number-of-actions

~text内容:#_text-content
nT.~sw登録:#service-worker-registration
nT.~title:#concept-title
nT.本体:#body
nT.方向:#concept-direction
nT.言語:#concept-language
nT.~tag:#tag
nT.~data:#data
nT.時刻印:#timestamp
nT.生成元:#concept-origin
nT.再通知-が選好されるか:#renotify-preference-flag
nT.静音が選好されるか:#silent-preference-flag
nT.ヤリトリを要求する選好はあるか:#require-interaction-preference-flag

nT.~badge資源:#badge-resource
nT.~badge~URL:#badge-url

nT.~icon資源:#icon-resource
nT.~icon~URL:#icon-url

nT.画像~資源:#image-resource
nT.画像~URL:#image-url
nT.振動~pattern:#vibration-pattern

nT.動作~群:#actions

通知~動作:#action
nA.~icon資源:#action-icon-resource
nA.名前:#action-name
nA.~title:#action-title
nA.~icon~URL:#action-icon-url

通知~list:#list-of-notifications
通知:#concept-notification
持続的:#persistent-notification
持続的でない:#non-persistent-notification
通知を作成する:#create-a-notification
設定群~objで通知を作成する:#create-a-notification-with-a-settings-object
~sw通知~eventを発火する:#fire-a-service-worker-notification-event
~close~eventを取扱う:#handle-close-events

	●外部

実装定義:~INFRA#implementation-defined
~list:~INFRA#list
空:~INFRA#list-is-empty
	空にする:~INFRA#list-empty → 空
除去する:~INFRA#list-remove
付加する:~INFRA#list-append
置換する:~INFRA#list-replace

辞書:~WEBIDL#dfn-dictionary

~Record:~TC39#sec-list-and-record-specification-type

環境~設定群~obj:~WAPI#environment-settings-object
関連な設定群~obj:~WAPI#relevant-settings-object
現在の大域~obj:~WAPI#current-global-object
関連な大域~obj:~WAPI#concept-relevant-global
関連な~realm:~WAPI#concept-relevant-realm
~event~handler~event型:~WAPI#event-handler-event-type
~event~handler:~WAPI#event-handlers
enV.生成元:~WAPI#concept-settings-object-origin
enV.~API用~基底~URL:~WAPI#api-base-url
大域~taskを~queueする:~WAPI#queue-a-global-task
~taskを~queueする:~WAPI#queue-a-task
~task~source:~WAPI#task-source
~DOM操作~task~source:~WAPI#dom-manipulation-task-source

閲覧~文脈:~HTMLds#browsing-context

作動中な~worker:~SW1#dfn-active-worker
機能的~eventを発火する:~SW1#fire-functional-event

振動を遂行する:~VIBRATION#dfn-perform-vibration
検証して正規化する:~VIBRATION#dfn-validate-and-normalize

新たな~obj:~WEBIDLjs#new
新たな~promise:~WEBIDLjs#a-new-promise
~promiseを却下する:~WEBIDLjs#reject
~promiseを解決する:~WEBIDLjs#resolve
凍結d配列を作成する:~WEBIDLjs#dfn-create-frozen-array
~callback関数を呼出す:~WEBIDLjs#invoke-a-callback-function

~event~listener:~DOM4#concept-event-listener
~eventを発火する:~DOM4#concept-event-fire

並列的:~HTMLINFRA#in-parallel

~fetch:~FETCH#concept-fetch
内部~応答:~FETCH#concept-internal-response
応答:~FETCH#concept-response
rs.種別:~FETCH#concept-response-type

生成元:~ORIGIN#concept-origin
同一-生成元:~ORIGIN#same-origin

~URL:~URL1#concept-url
~URL構文解析する:~URL1#concept-url-parser
~URLを直列化する:~URL1#concept-url-serializer
~sw登録:~SW1#dfn-service-worker-registration

~Unix~epoch:~HRTIME#dfn-unix-epoch
enV.現在の壁~時計~時刻:~HRTIME#dfn-eso-current-wall-time
所要時間を得る:~HRTIME#dfn-duration-from
所要時間を時刻印に暗黙的に変換する:~HRTIME#dfn-implicitly-convert-a-duration-to-a-timestamp

強力な特能:~PERMISSIONS#dfn-powerful-feature
pM.名前:~PERMISSIONS#dfn-name
現在の許可~状態を取得する:~PERMISSIONS#dfn-getting-the-current-permission-state
利用する許可を要請する:~PERMISSIONS#dfn-request-permission-to-use

	:~HEimages#update-the-image-data
	:https://www.w3.org/Bugs/Public/show_bug.cgi?id=24055
	:http://robert.ocallahan.org/2011/06/permissions-for-web-applications_30.html

_acks1:#_acks1
_ipr1:#_ipr1

●●ref_data
VIBRATION=副   ~/vibration-ja.html

●●words_table1
VIBRATION:vibration-ja.html

●●words_table

	●許可

	●通知
center::::センター
存続期間:lifetime:~
再通知-:renotify::~
持続化-:persist::~
持続的:persistent::~
	持続的でない:non-persistent
	notices
過去:past:~
epoch:
	数秒:couple of seconds

	●通知 UI
mail::::メール
alert:
badge::::バッジ
振動-:vibrate::~
振動:vibration::~
段落分断:paragraph-breaking::~
	本体:main body
退ける:dismissする:~
chat::::チャット
開く:openする:~
開いた:openした:~
開かず:openせず:~
静音:silent::~
音響:sound::~
隅:corner:~
写真:photo:~
	会合:meeting
絵図:picture:~
双方向-:bidirectional::~

	●仕様
上品:graceful:~
不用意:accidental:~
十分:enough:~
保つ:keepする:~
末端-:end:~
協調-:coordinate:~
編集-:edit:~
増補-:reinforce:~
慎む:refrainする:~

	easily
	subsubstep
	抽象-化-:abstracting
	nicer
	頻繁に:frequently
	不足ない:sufficiently
	ものとして知られている一つ:the one instance thus far
	に依存する:-dependent
	ことにして:address
	とされる:consider
	可能になる／可能にする:allow
	でありつつ:while remaining
	誤って命名され:misnamed
	不明瞭になる:loss
	〜にする:make sure
	いつでも〜であり続ける:remain readily
	-:assuming
	選択肢:choice


	許可~API^cite:Permissions API
	通知~API^cite:Notifications API

	●未分類
Record:
閉じる:closeする:~
close::::
丸める:roundする:~
切取られ:clipされ:切り取られ
塗る:paintする:~
運用-:operate:~
入口:entry::~
archive::::アーカイブ
desktop::::デスクトップ
offline::::オフライン
website::::web サイト
例外投出あり:rethrow any exceptions::~
優先度:priority:~
整形式性:well-formedness:~
機能的:functional::~
入出力:IO:~
Unix:
時計:clock::~::クロック
壁:wall::~
丸めた:roundした:~
	所要時間を時刻印に暗黙的に変換する:number of milliseconds
	所要時間を得る:from 〜 to
	~access可能:accessible
	~tagを付与:tagged
	付加-:push
	解決-:fulfill
	時間差:passed
	存続中に:during their lifecycle
	甲:Alice
	乙:Bob
	丙:John Doe
	P1
	P2
	P3
	~F:unset
	例外が投出されたときは:if this throws an exception,／If this threw an exception
	~GTE:excess
	基底~URL:baseURL
	-:bring 〜
	受信箱:inbox
	遊休中:idle 中
	~queueされた順に通知する:first-in-first-out
	存在する:in existence
	~focusする:intoFocus
	-:relative

	●変数
	%~URL:url
	%~title:title
	%~option群:options
	%設定群:settings
	%生成元:origin
	%通知:notification
	%基底~URL:baseURL
	%~fallback時刻印:fallbackTimestamp
	%値:-
	%vibrate:-
	%timestamp:-
	%icon:-
	%~entry:entry
	%動作:action
	%動作~名:action
	%応答:the response
	%画像~URL:-
	%~icon~URL:-
	%~badge~URL:-
	%結果:-
	%示したか:shown
	%旧~通知:oldNotification
	%~focusするか:intoFocus
	%大域~obj:
	%大域~obj:global
	%許可~状態:permissionState
	%動作~群:frozenAction
	%~promise:promise
	-:tag
	%通知~群:notifications
	%~obj群:objects
	%~realm:realm
	%名前:name

	●指示語
	旧:old
	最新の:newest
	最新に:current
	他が指定されない限り:unless otherwise specified
	数多の:many
	大きい:large
	自体:itself
	ずっと:much
	並べて:side by side
	より高い:higher
	何種類かの:wide variety of
	種類:category
	全体にわたり:throughout
	低くされ:less than
	前もって:upfront
	まだ:thus far
	より少ない:fewer
	一部:part


●●ref_normative

[BCP47]
    A. Phillips, Ed.; M. Davis, Ed.. ＜Tags for Identifying Languages＞. September 2009. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc5646
[BIDI]
    Manish Goregaokar मनीष गोरेगांवकर; Robin Leroy. ＜Unicode Bidirectional Algorithm＞. 2 September 2024. Unicode Standard Annex #9. URL: https://www.unicode.org/reports/tr9/tr9-50.html
[DOM]
    Anne van Kesteren. ＜DOM Standard＞. Living Standard. URL: https://dom.spec.whatwg.org/
[FETCH]
    Anne van Kesteren. ＜Fetch Standard＞. Living Standard. URL: https://fetch.spec.whatwg.org/
[HR-TIME]
    Yoav Weiss. ＜High Resolution Time＞. URL: https://w3c.github.io/hr-time/
[HTML]
    Anne van Kesteren; et al. ＜HTML Standard＞. Living Standard. URL: https://html.spec.whatwg.org/multipage/
[INFRA]
    Anne van Kesteren; Domenic Denicola. ＜Infra Standard＞. Living Standard. URL: https://infra.spec.whatwg.org/
[Permissions]
    Marcos Caceres; Mike Taylor. ＜Permissions＞. URL: https://w3c.github.io/permissions/
[SERVICE-WORKERS]
    Jake Archibald; Marijn Kruisselbrink. ＜Service Workers＞. URL: https://w3c.github.io/ServiceWorker/
[URL]
    Anne van Kesteren. ＜URL Standard＞. Living Standard. URL: https://url.spec.whatwg.org/
[VIBRATION]
    Anssi Kostiainen. ＜Vibration API (Second Edition)＞. URL: https://w3c.github.io/vibration/
[WEBIDL]
    Edgar Chen; Timothy Gu. ＜Web IDL Standard＞. Living Standard. URL: https://webidl.spec.whatwg.org/


●●trans_metadata
<p>
~THIS_PAGEは、~WHATWGによる
<a href="https://notifications.spec.whatwg.org/">Notifications API</a>
を日本語に翻訳したものです。
~PUB
</p>

●●spec_metadata

Participate:
	<a href="https://github.com/whatwg/notifications">GitHub whatwg/notifications</a> (<a href="https://github.com/whatwg/notifications/issues/new/choose">new issue</a>, <a href="https://github.com/whatwg/notifications/issues">open issues</a>)
	<a href="https://whatwg.org/chat">Chat on Matrix</a>

Commits:
	<a href="https://github.com/whatwg/notifications/commits">GitHub whatwg/notifications/commits</a>
	<a href="https://notifications.spec.whatwg.org/commit-snapshots/d7f3e1a5ba09006aafa310608ac7e7a096b2190a/" id="commit-snapshot-link">Snapshot as of this commit</a>
	<a href="https://twitter.com/notifyapi">@notifyapi</a>

Tests:
	<a href="https://github.com/web-platform-tests/wpt/tree/master/notifications">web-platform-tests notifications/</a> (<a href="https://github.com/web-platform-tests/wpt/labels/notifications">ongoing work</a>)

各国語翻訳（非規範的）
	日本語（このページ）
	<a href="https://htmlspecs.com/notifications/" hreflang="zh-hans" lang="zh-hans" rel="alternate">简体中文</a>
</script>


</head>

<body>

<header>

<a href="https://whatwg.org/"><img
	style="float: right;"
	alt="WHATWG"
	height="100"
	src="data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMDAgMTAwIj4KPGNpcmNsZSBjeD0iNTAiIGN5PSI1MCIgcj0iNDUiIGZpbGw9IiNmZmYiIHN0cm9rZT0iIzNjNzkwYSIgc3Ryb2tlLXdpZHRoPSIxMCIvPgo8cGF0aCBkPSJtNDUsMjV2MzVoMTB2LTM1em0wLDQwdjEwaDEwdi0xMCIgZmlsbD0iIzNjNzkwYSIvPgo8L3N2Zz4K"
></a>

<!-- 
https://resources.whatwg.org/logo-notifications.svg"
 -->

	<hgroup>
<h1>通知 API — Notifications API</h1>
	</hgroup>
</header>

<div id="MAIN" hidden>
	<section id="abstract">
◎要約

<p>
この標準は、末端-利用者~向けに通知を
— 概して~top-level閲覧~文脈の表示域の外側に —
表示する~APIを定義する。
それは、~platformに独立でありつつ，既存の通知~systemと互換になるように設計されている。
◎
This standard defines an API to display notifications to the end user, typically outside the top-level browsing context’s viewport. It is designed to be compatible with existing notification systems, while remaining platform-independent.
</p>

	</section>

<main id="MAIN0">

	<section id="terminology">
<h2 title="Terminology">1. 各種用語</h2>

<p>
この仕様は、
Infra 標準 `INFRA$r に依存する。
◎
This specification depends on the Infra Standard. [INFRA]
</p>

<p>
この仕様にて利用される一部の用語は、
次に挙げる仕様にて定義される
⇒
`DOM$r
`FETCH$r
`HR-TIME$r
`HTML$r
`WEBIDL$r
`SERVICE-WORKERS$r
`URL$r
`VIBRATION$r
◎
Some terms used in this specification are defined in the DOM, Fetch, High Resolution Time, HTML, IDL, Service Workers, URL, and Vibration API Standards. [DOM] [FETCH] [HR-TIME] [HTML] [WEBIDL] [SERVICE-WORKERS] [URL] [VIBRATION]
</p>

		<section id="_conventions">
<h3>【この訳に特有な表記規約】</h3>

◎表記記号

		</section>
	</section>
	<section id="notifications">
<h2 title="Notifications">2. 通知</h2>

<p>
`通知@
（ `notification^en ）は、
起こった何か
— ~messageの送達など —
の抽象的な表現である。
◎
A notification is an abstract representation of something that happened, such as the delivery of a message.
</p>

<p>
各 `通知$には、
以下に挙げるものが結付けられる：
◎
↓</p>

<dl class="def-list">
	<dt>
`~sw登録@nT
◎
A notification has an associated service worker registration＼
</dt>
	<dd>
~NULL ／
ある`~sw登録$
◎
(null or a service worker registration).＼
</dd>
	<dd>
初期~時は ~NULL とする。
◎
It is initially null.
</dd>

	<dt>
`~title@nT
◎
A notification has an associated title＼
</dt>
	<dd>
ある文字列
◎
(a string).
</dd>

	<dt>
`方向@nT
◎
A notification has an associated direction＼
</dt>
	<dd>
`auto^l ／
`ltr^l ／
`rtl^l
◎
("auto", "ltr", or "rtl").
</dd>
	<dd class="trans-note">【
ある `NotificationDirection$I 値。
】</dd>

	<dt>
`言語@nT
◎
A notification has an associated language＼
</dt>
	<dd>
ある文字列
◎
(a string).
</dd>
	<dd class="trans-note">【
`§ 言語＠#language$を見よ。
】</dd>

	<dt>
`本体@nT
◎
A notification has an associated body＼
</dt>
	<dd>
ある文字列
◎
(a string).
</dd>

	<dt>
`~tag@nT
◎
A notification has an associated tag＼
</dt>
	<dd>
ある文字列
◎
(a string).
</dd>
	<dd class="trans-note">【
`同じ概念的~eventを識別する＠#tags-example$。
】</dd>

	<dt>
`~data@nT
◎
A notification has an associated data＼
</dt>
	<dd>
ある`~Record$
◎
(a Record).
</dd>
	<dd class="trans-note">【
~appが自前の目的に利用できる任意な~data。
】</dd>

	<dt>
`時刻印@nT
◎
A notification has an associated timestamp＼
</dt>
	<dd>
ある `EpochTimeStamp$I 値
◎
(an EpochTimeStamp).
</dd>
	<dd class="note">注記：
時刻印は、
通知【の作成~時刻に代えて，その内容が表す現実の~event】の実際の時刻を指示するためにも利用できる。
例えば、［
機器が~offlineにあるために即時に送達できなかった~message用に通知が利用された時点を指す過去
］にすることも, ［
開始しつつある会合~用の未来
］にすることもできる。
◎
Timestamps can be used to indicate the time at which a notification is actual. For example, this could be in the past when a notification is used for a message that couldn’t immediately be delivered because the device was offline, or in the future for a meeting that is about to start.
</dd>

	<dt>
`生成元@nT
◎
A notification has an associated origin＼
</dt>
	<dd>
ある`生成元$
◎
(an origin).
</dd>

	<dt>
`再通知-が選好されるか@nT
◎
A notification has an associated renotify preference＼
</dt>
	<dd>
ある真偽値
◎
(a boolean).＼
</dd>
	<dd>
初期~時は ~F とする。
◎
It is initially false.＼
</dd>
	<dd>
~T の場合、
次を指示する
⇒
`通知を示す$ときに与えられた新たな通知が，既存の通知と同じ`~tag$nTを有するならば、
その手続きを走らせた後に，末端-利用者に~alertされるべきである
◎
When true, indicates that the end user should be alerted after the notification show steps have run with a new notification that has the same tag as an existing notification.
</dd>

	<dt>
`静音が選好されるか@nT
◎
A notification has an associated silent preference＼
</dt>
	<dd>
~NULL ／
ある真偽値
◎
(null or a boolean).＼
</dd>
	<dd>
初期~時は ~F とする。
◎
It is initially null.＼
</dd>
	<dd>
~T の場合、
次を指示する
⇒
音響や振動は生じるべきでない。
◎
When true, indicates that no sounds or vibrations should be made.＼
</dd>
	<dd>
~NULL の場合、
次を指示する
⇒
音響や振動を生産するかどうかは~platform規約に委ねられるべきである。
◎
When null, indicates that producing sounds or vibrations should be left to platform conventions.
</dd>
	<dd class="trans-note">【
`音響の~supportは除去された＠https://github.com/whatwg/notifications/commit/459bf358cae197a5b88c6a227e018756ef4c21cd$。
】</dd>

	<dt>
`ヤリトリを要求する選好はあるか@nT
◎
A notification has an associated require interaction preference＼
</dt>
	<dd>
ある真偽値
◎
(a boolean).＼
</dd>
	<dd>
初期~時は ~F とする。
◎
It is initially false.＼
</dd>
	<dd>
~T の場合、
次を指示する
⇒
大きさに不足ない~screenを備える機器~上では、
当の通知は，末端-利用者が それを［
作動化する／退ける
］まで，いつでも可用であり続けるべきである。
◎
When true, indicates that on devices with a sufficiently large screen, the notification should remain readily available until the end user activates or dismisses the notification.
</dd>

	<dt>
`画像~URL@nT
◎
A notification can have these associated graphics: an image URL,＼
</dt>
	<dt>
`~icon~URL@nT
◎
icon URL,＼
</dt>
	<dt>
`~badge~URL@nT
◎
and badge URL;＼
</dt>
	<dd>
いずれも
⇒
ε ／`~URL$
— 初期~時は ε とする。
◎
↑</dd>
	<dd>
これらは、
順に，［
`画像~資源$nT,
`~icon資源$nT,
`~badge資源$nT
］が~fetchされる~URLを与える。
◎
and their corresponding＼
</dd>

	<dt>
`画像~資源@nT
◎
image resource,＼
</dt>
	<dt>
`~icon資源@nT
◎
icon resource,＼
</dt>
	<dt>
`~badge資源@nT
◎
and badge resource.
</dt>
	<dd>
いずれも
⇒
ε ／ ある画像
— 初期~時は ε とする。
◎
↑</dd>

	<dd>
`画像~資源$nTは、
`通知$を成す内容の一部として示され，［
`~icon資源$nT, `~badge資源$nT
］より高い視覚的な優先度で表示されるべき絵図を与える†。
より少ない状況下で表示されてもヨイが††。
◎
An image resource is a picture shown as part of the content of the notification, and should be displayed with higher visual priority than the icon resource and badge resource, though it may be displayed in fewer circumstances.
</dd>
	<dd class="trans-note">【†
言い換えれば、［
`画像~資源$nTとは、
挙げられた 3 種の資源のうち［
通知~platformにおいて，一般に最も高い優先度で表示される画像である
］ものと定義される
］と解釈することもできる。
】【††
どれを優先するかは、
状況に応じて，通知~platformが制御するかもしれない。
】</dd>
	<dd>
`~icon資源$nTは、
`通知$を増補する画像（~iconや送信者の写真など）を与える。
◎
An icon resource is an image that reinforces the notification (such as an icon, or a photo of the sender).
</dd>
	<dd>
`~badge資源$nTは、
当の~web~app
— あるいは，~web~appが何種類かの`通知$を送信する場合には、
`通知$の種類 —
を表現している~iconを与える。
`通知$自体を表示する十分な空間がない場合にも、
`通知$を表現するために利用されて`ヨイ^em。
`通知$の内側に表示されても`ヨイ^emが、
その視覚的な優先度は［
`画像~資源$nT, `~icon資源$nT
］より低くされるべきである。
◎
A badge resource is an icon representing the web application, or the category of the notification if the web application sends a wide variety of notifications. It may be used to represent the notification when there is not enough space to display the notification itself. It may also be displayed inside the notification, but then it should have less visual priority than the image resource and icon resource.
</dd>

	<dt>
`振動~pattern@nT
◎
A notification has an associated vibration pattern＼
</dt>
	<dd>
ある`~list$
◎
(a list).＼
</dd>
	<dd>
初期~時は « » とする。
◎
It is initially « ».
</dd>
	<dd class="trans-note">【
通知-時に生じる振動を表す~dataを与える。
】</dd>
	<dd class="note">注記：
開発者には、［
`画像~資源$nT,
`~icon資源$nT,
`~badge資源$nT,
`振動~pattern$nT
］を通して伝達される情報を［
末端-利用者が他からも~access可能にする
］ことが奨励される
— とりわけ，これらの特能を~supportしない通知~platformは、
これらを無視するかもしれないので。
◎
Developers are encouraged to not convey information through an image, icon, badge, or vibration pattern that is not otherwise accessible to the end user, especially since notification platforms that do not support these features might ignore them.
</dd>

	<dt>
`動作~群@nT
◎
A notification has associated actions＼
</dt>
	<dd>
`通知~動作$たちが成す`~list$
◎
(a list of zero or more notification actions).＼
(a list of zero or more actions).＼
</dd>
	<dd class="trans-note">【
翻訳の都合により，この~listを成す各`通知~動作$は、
単に “動作” とも称される。
】</dd>
</dl>

<p>
各
`通知~動作@
は、
末端-利用者~向けの選択肢を表現し，
次に挙げるものが結付けられる：
◎
A notification action represents a choice for an end user. Each notification action has an associated:
</p>
<ul>
	<li>
`名前@nA
⇒
文字列
◎
name
• A string.
</li>
	<li>
`~title@nA
⇒
文字列
◎
title
• A string.
</li>
	<li>
`~icon~URL@nA
⇒
~NULL ／ ある`~URL$
— 初期~時は ~NULL とする。
【`~icon資源$nAが~fetchされる~URL】
◎
icon URL
• Null or a URL. It is initially null.
</li>
	<li>
`~icon資源@nA
⇒
~NULL ／ ある資源
— 初期~時は ~NULL とする。
◎
icon resource
• Null or a resource. It is initially null.
</li>
</ul>

<p>
末端-利用者は、［
通知~自体を作動化する代替として，その`動作~群$nTを成すある動作を作動化する
］こともある。
`最大~動作~数@
は、
`実装定義$な 0 以上の整数であり，
`動作~群$nTを成し得る動作の個数として［
通知~platformの拘束の中で~supportされる最大
］を表現する。
◎
Users may activate actions, as alternatives to activating the notification itself. The maximum number of actions supported is an implementation-defined integer of zero or more, within the constraints of the notification platform.
</p>

<p class="note">注記：
動作の表示-は~platformに依存するので、
開発者には，［
末端-利用者が通知から呼出せるどの動作も，~web~appの中で【通知~以外の何かにより】可用にする
］ことが奨励される。
◎
Since display of actions is platform-dependent, developers are encouraged to make sure that any action an end user can invoke from a notification is also available within the web application.
</p>

<p class="note no-backref">注記：
一部の~platformは、
`~icon資源$nAを［
末端-利用者に表示する前に，~platformの視覚的な~styleにより良く合致するよう改変する
］かもしれない
— 例えば［
隅を丸める／特定の色で塗る
］などにより。
開発者には、
そのような事例に対しても，利用する~iconの重要な情報が［
隅が切取られる／色が~~不明瞭になる
］などにより失われないよう，上品に取扱うことが奨励される。
◎
Some platforms might modify an icon resource to better match the platform’s visual style before displaying it to the end user, for example by rounding the corners or painting it in a specific color. Developers are encouraged to use an icon that handles such cases gracefully and does not lose important information through, e.g., loss of color or clipped corners.
</p>

<p>
所与の`通知$ %通知 が：
◎
↓<p>
<ul>
	<li>
`持続的@
（ `persistent^en ）
であるとは、
次が満たされることをいう
⇒
%通知 の`~sw登録$nT ~NEQ ~NULL
◎
A non-persistent notification is a notification whose service worker registration is null.
</li>
	<li>
<p>
◎追跡路
`持続的でない@
（ `non-persistent^en ）
とは、
次が満たされることをいう
⇒
~NOT %通知 は`持続的$である
◎
(This is a tracking vector.)
A persistent notification is a notification whose service worker registration is non-null.
</p>

<p class="trans-note">【
これは，純粋に否定なので、
この訳では，単に “`持続的$でない” と記す（~mark-upする）ことにする。
】</p>
	</li>
</ul>

<hr>

<div class="algo">
<p>
`設定群~objで通知を作成する@
~algoは、
所与の
( 文字列 %~title, `NotificationOptions$I `辞書$ %~option群, `環境~設定群~obj$ %設定群 )
に対し：
◎
To create a notification with a settings object, given a string title, NotificationOptions dictionary options, and environment settings object settings:
</p>
<ol>
	<li>
%生成元 ~LET %設定群 の`生成元$enV
◎
Let origin be settings’s origin.
</li>
	<li>
%基底~URL ~LET %設定群 の`~API用~基底~URL$enV
◎
Let baseURL be settings’s API base URL.
</li>
	<li>
%~fallback時刻印 ~LET 次の結果を最も近い整数に丸めた結果
⇒
`所要時間を時刻印に暗黙的に変換する$( 次の結果 )
⇒
`所要時間を得る$( `~Unix~epoch$, `現在の壁~時計~時刻$enV( %設定群 ) )
◎
Let fallbackTimestamp be the number of milliseconds from the Unix epoch to settings’s current wall time, rounded to the nearest integer.
</li>
	<li>
~RET `通知を作成する$( ↓ )
⇒＃
%~title,
%~option群,
%生成元,
%基底~URL,
%~fallback時刻印
◎
Return the result of creating a notification given title, options, origin, baseURL, and fallbackTimestamp.
</li>
</ol>
</div>

<div class="algo">
<p>
`通知を作成する@
~algoは、
所与の
⇒＃
文字列 %~title,
`NotificationOptions$I `辞書$ %~option群,
`生成元$ %生成元,
`~URL$ %基底~URL,
`EpochTimeStamp$I %~fallback時刻印
◎終
に対し：
◎
To create a notification, given a string title, NotificationOptions dictionary options, an origin origin, a URL baseURL, and an EpochTimeStamp fallbackTimestamp:
</p>
<ol>
	<li>
%通知 ~LET 新たな`通知$
◎
Let notification be a new notification.
</li>
	<li>
<p>
~IF［
~OR↓
］…
</p>
		<ul>
			<li>
［
%~option群[ "`silent$mO" ] ~EQ ~T
］~AND［
%~option群[ "`vibrate$mO" ] ~NEQ ε
］
</li>
			<li>
［
%~option群[ "`renotify$mO" ] ~EQ ~T
］~AND［
%~option群[ "`tag$mO" ] ~EQ 空~文字列
］
</li>
		</ul>
<p>
…ならば
⇒
~THROW `TypeError$E
</p>
◎
If options["silent"] is true and options["vibrate"] exists, then throw a TypeError.
◎
If options["renotify"] is true and options["tag"] is the empty string, then throw a TypeError.
</li>
	<li>
%通知 の `~data$nT ~SET 
`StructuredSerializeForStorage$A( %~option群[ "`data$mO" ] )
◎
Set notification’s data to StructuredSerializeForStorage(options["data"]).
</li>
	<li>
%通知 の
⇒＃
`~title$nT ~SET %~title,
`方向$nT ~SET %~option群[ "`dir$mO" ],
`言語$nT ~SET %~option群[ "`lang$mO" ],
`生成元$nT ~SET %生成元,
`本体$nT ~SET %~option群[ "`body$mO" ],
`~tag$nT ~SET %~option群[ "`tag$mO" ]
◎
Set notification’s title to title.
◎
Set notification’s direction to options["dir"].
◎
Set notification’s language to options["lang"].
◎
Set notification’s origin to origin.
◎
Set notification’s body to options["body"].
◎
Set notification’s tag to options["tag"].
</li>
	<li>
<p>
%通知 の
⇒＃
`画像~URL$nT ~SET `~URLを得る^i( %~option群[ "`image$mO" ] ),
`~icon~URL$nT ~SET `~URLを得る^i( %~option群[ "`icon$mO" ] ),
`~badge~URL$nT ~SET `~URLを得る^i( %~option群[ "`badge$mO" ] )
</p>

<div class="algo">
<p>
この段の中で `~URLを得る^i ときは、
所与の
( %値 )
に対し，次の手続きを走らすとする：
</p>
		<ol>
			<li>
~IF［
%値 ~EQ ε
］
⇒
~RET ε
</li>
			<li>
%~URL ~LET `~URL構文解析する$( %値, %基底~URL )
</li>
			<li>
~RET［
%~URL ~EQ `失敗^i ならば ε ／
~ELSE_ %~URL
］
</li>
		</ol>
</div>

◎
If options["image"] exists, then parse it using baseURL, and if that does not return failure, set notification’s image URL to the return value. (Otherwise notification’s image URL is not set.)
◎
If options["icon"] exists, then parse it using baseURL, and if that does not return failure, set notification’s icon URL to the return value. (Otherwise notification’s icon URL is not set.)
◎
If options["badge"] exists, then parse it using baseURL, and if that does not return failure, set notification’s badge URL to the return value. (Otherwise notification’s badge URL is not set.)
</li>
	<li>
%vibrate ~LET %~option群[ "`vibrate$mO" ]
◎
↓</li>
	<li>
~IF［
%vibrate ~NEQ ε
］
⇒
%通知 の`振動~pattern$nT ~SET `検証して正規化する$( %vibrate )
◎
If options["vibrate"] exists, then validate and normalize it and set notification’s vibration pattern to the return value.
</li>
	<li>
%timestamp ~LET %~option群[ "`timestamp$mO" ]
◎
↓</li>
	<li>
%通知 の`時刻印$nT ~SET %timestamp に応じて
⇒＃
ε ならば %~fallback時刻印 ／
~ELSE_ %timestamp
◎
If options["timestamp"] exists, then set notification’s timestamp to the value. Otherwise, set notification’s timestamp to fallbackTimestamp.
</li>
	<li>
%通知 の
⇒＃
`再通知-が選好されるか$nT ~SET %~option群[ "`renotify$mO" ],
`静音が選好されるか$nT ~SET %~option群[ "`silent$mO" ],
`ヤリトリを要求する選好はあるか$nT ~SET %~option群[ "`requireInteraction$mO" ]
◎
Set notification’s renotify preference to options["renotify"].
◎
Set notification’s silent preference to options["silent"].
◎
Set notification’s require interaction preference to options["requireInteraction"].
</li>
	<li>
%通知 の`動作~群$nT ~SET « »
◎
Set notification’s actions to « ».
</li>
	<li>
<p>
%~option群[ "`actions$mO" ] を成す
~EACH( %~entry )
に対し：
◎
For each entry in options["actions"],＼
</p> 
		<ol>
			<li>
~IF［
%通知 の`動作~群$nTの~size ~GTE `最大~動作~数$
］
⇒
~BREAK
◎
up to the maximum number of actions supported (skip any excess entries):
</li>
			<li>
%動作 ~LET 新たな`通知~動作$
— その
⇒＃
`名前$nA ~SET %~entry[ "`action$mA" ],
`~title$nA ~SET %~entry[ "`title$mA" ]
◎
Let action be a new notification action.
◎
Set action’s name to entry["action"].
◎
Set action’s title to entry["title"].
</li>
			<li>
%icon ~LET %~entry[ "`icon$mA" ]
◎
↓</li>
			<li>
<p>
~IF［
%icon ~NEQ ε
］：
</p>
				<ol>
					<li>
%~URL ~LET `~URL構文解析する$( %icon, %基底~URL )
</li>
					<li>
~IF［
%~URL ~NEQ `失敗^i
］
⇒
%動作 の`~icon~URL$nA ~SET %~URL
</li>
				</ol>
◎
If entry["icon"] exists, then parse it using baseURL, and if that does not return failure, set action’s icon URL to the return value. (Otherwise action’s icon URL remains null.)
</li>
			<li>
%通知 の`動作~群$nTに %動作 を付加する
◎
Append action to notification’s actions.
</li>
		</ol>
	</li>
	<li>
~RET %通知
◎
Return notification.
</li>
</ol>
</div>

		<section id="lifetime-and-ui-integrations">
<h3 title="Lifetime and UI integration">2.1. 存続期間と~UI統合</h3>

<p>
~UAは、
`通知~list@
を保つモノトスル
— それは、
`通知$たちが成す`~list$である。
~UAには、
次の要件が課される：
◎
The user agent must keep a list of notifications, which is a list of zero or more notifications. 
</p>

<ul>
	<li>
`持続的$でない通知に対しては，作成した数秒~後には`通知を閉じる$べきである。
◎
User agents should run the close steps for a non-persistent notification a couple of seconds after they have been created.
</li>
	<li>
~platformの “通知~center” が可用であっても，`持続的$でない通知をそこに表示するべきでない。
◎
User agents should not display non-persistent notification in a platform’s "notification center" (if available).
</li>
	<li>
<p>
`持続的$な通知を，`通知~list$から除去されるまでは持続化するべきである。
◎
User agents should persist persistent notifications until they are removed from the list of notifications.
</p>

<p class="example">
`持続的$な通知は、
それを表現するいずれかの `Notification$I ~obj上で `close()$m ~methodを呼出すこともできる。
◎
A persistent notification could have the close() method invoked of one of its Notification objects.
</p>
	</li>
	<li>
~platformの “通知~center” が可用ならば，`持続的$な通知をそこに表示するべきである。
◎
User agents should display persistent notifications in a platform’s "notification center" (if available).
</li>
</ul>

		</section>
		<section id="permissions-integration">
<h3 title="Permissions integration">2.2. 許可~APIとの統合</h3>

<p>
`通知~API^citeは、
`名前$pM
`notifications@l
により識別される`強力な特能$である
◎
The Notifications API is a powerful feature which is identified by the name "notifications". [Permissions]
</p>

<div class="algo">
<p>
`通知~許可~状態を取得する@
~algoは：
◎
To get the notifications permission state, run these steps:
</p>
<ol>
	<li>
%許可~状態 ~LET `現在の許可~状態を取得する$( `notifications$l )
◎
Let permissionState be the result of getting the current permission state with "notifications".
</li>
	<li>
~RET %許可~状態 に応じて
⇒＃
`prompt^l ならば `default^l／
~ELSE_ %許可~状態
◎
If permissionState is "prompt", then return "default".
◎
Return permissionState.
</li>
</ol>
</div>

		</section>
		<section id="direction">
<h3 title="Direction">2.3. 方向</h3>

<p>
この節における用語 “期待される” は、
~HTML `§ 具現化＠~HTMLrendering#rendering$
に利用されるそれと等価とする。
`HTML$r
◎
This section is written in terms equivalent to those used in the Rendering section of HTML. [HTML]
</p>

<p>
~UAには、
`通知$の`~text内容$における~Unicode意味論を尊守することが期待される
— ここでの
`~text内容@
とは、［
`~title$nTと`本体$nT, および
`動作~群$nTを成す各~動作の`~title$nA
］を成す~textの総称である。
各`~text内容$は、
表示されるときには［
1 個~以上の双方向-~algo段落が成す，互いに独立な集合
］として，双方向-~algoの規則［
`P1^i, `P2^i, `P3^i
］に定義されるとおりに扱うことが期待される
— 一例として、
文字 
<span class="code-point">U+000A</span> (<span class="char-symbol">LF</span>)
による段落分断の挙動を~supportすることも含め。
`通知$の`方向$nTに対する `auto^l 以外の値は、
`通知$の各`~text内容$を成す各~段落に対し，規則［
`P2^i, `P3^i
］より高~levelな上書きを供する。
`BIDI$r
◎
User agents are expected to honor the Unicode semantics of the text of a notification’s title, body, and the title of each of its actions. Each is expected to be treated as an independent set of one or more bidirectional algorithm paragraphs when displayed, as defined by the bidirectional algorithm’s rules P1, P2, and P3, including, for instance, supporting the paragraph-breaking behavior of U+000A LINE FEED (LF) characters. For each paragraph of the title, body and the title of each of the actions, the notification’s direction provides the higher-level override of rules P2 and P3 if it has a value other than "auto". [BIDI]
</p>

<p>
`通知$の`方向$nTは、［
通知~platformが，`通知$を成す一連の動作を末端-利用者~向けに並べて表示する場合
］に，それらが従うべき順序も決定する。
◎
The notification’s direction also determines the relative order in which the notification’s actions should be displayed to the end user, if the notification platform displays them side by side.
</p>

		</section>
		<section id="language">
<h3 title="Language">2.4. 言語</h3>

<p>
`通知$の`言語$nTは、［
`通知$の`~text内容$用の首な言語
］を文字列で指定する。
空~文字列は、
首な言語は未知であることを指示する。
他の文字列は、
言語~tag `BCP47$r として解釈するモノトスル。
［
妥当性／整形式性
］は、
施行されない。
◎
The notification’s language specifies the primary language for the notification’s title, body and the title of each of its actions. Its value is a string. The empty string indicates that the primary language is unknown. Any other string must be interpreted as a language tag. Validity or well-formedness are not enforced. [BCP47]
</p>

<p class="note">注記：
開発者には、
妥当な言語~tagのみを利用することが奨励される。
◎
Developers are encouraged to only use valid language tags.
</p>

		</section>
		<section id="resources">
<h3 title="Resources">2.5. 資源</h3>

<div class="algo">
<p>
`通知を~fetchする@
~algoは、
所与の
( `通知$ %通知 )
に対し：
◎
The fetch steps for a given notification notification are:
</p>

<ol>
	<li class="algo">
<p>
%資源を~fetchして復号する ~LET 所与の
( %~URL, %手続き )
に対し，
%~URL を`~fetch$した上で，次を`並列的$に走らす手続き：
</p>
		<ol>
			<li>
%結果 ~LET ε
</li>
			<li>
%応答 ~SET ~fetchされた結果の`応答$
</li>
			<li>
%応答 を待機する
</li>
			<li>
~IF［
%応答 の`内部~応答$の`種別$rs ~EQ `default^l
］
⇒
資源を画像として復号するよう試みる
⇒
~IF ［
~UAは 復号された資源の形式を~supportする
］
⇒
%結果 ~SET 復号された資源
</li>
			<li>
%手続き( %結果 )
</li>
		</ol>

<p class="note">注記：
画像~資源の場合、
この資源を~fetchする意図は
`img^e 要素に`類似する＠~HEimages#update-the-image-data$が，
`抽象-化する必要がある＠~HTMLissue/4474$
【！https://www.w3.org/Bugs/Public/show_bug.cgi?id=24055】
◎
The intent is to fetch this resource similar to an &lt;img&gt;, but this needs abstracting.
</p>

<p class="trans-note">【
この段は、
以下を集約するため，この訳にて導入している。
】</p>
◎
↓</li>
	<li>
( %画像~URL, %~icon~URL, %~badge~URL ) ~LET %通知 の
( `画像~URL$nT, `~icon~URL$nT, `~badge~URL$nT )
◎
↓</li>
	<li>
<p>
~IF［
通知~platformは画像を~supportする
］~AND［
%画像~URL ~NEQ ε
］
⇒
%資源を~fetchして復号する( %画像~URL, 次の手続き )
</p>

<p class="algo">
手続きは、
所与の ( %結果 ) に対し
⇒
%通知 の`画像~資源$nT ~SET %結果
</p>
◎
If the notification platform supports images, fetch notification’s image URL, if image URL is set.
◎
The intent is to fetch this resource similar to an &lt;img&gt;, but this needs abstracting.
◎
Then, in parallel:
• Wait for the response.
• If the response’s internal response’s type is "default", then attempt to decode the resource as image.
• If the image format is supported, set notification’s image resource to the decoded resource. (Otherwise notification has no image resource.)
</li>
	<li>
<p>
~IF［
通知~platformは~iconを~supportする
］~AND［
%~icon~URL ~NEQ ε
］
⇒
%資源を~fetchして復号する( %~icon~URL, 次の手続き )
</p>

<p class="algo">
手続きは、
所与の ( %結果 ) に対し
⇒
%通知 の`~icon資源$nT ~SET %結果
</p>
◎
If the notification platform supports icons, fetch notification’s icon URL, if icon URL is set.
◎
The intent is to fetch this resource similar to an &lt;img&gt;, but this needs abstracting.
◎
Then, in parallel:
• Wait for the response.
• If the response’s internal response’s type is "default", then attempt to decode the resource as image.
◎
If the image format is supported, set notification’s icon resource to the decoded resource. (Otherwise notification has no icon resource.)
</li>
	<li>
<p>
~IF［
通知~platformは~badgeを~supportする
］~AND［
%~badge~URL ~NEQ ε
］
⇒
%資源を~fetchして復号する( %~badge~URL, 次の手続き )
</p>

<p class="algo">
手続きは、
所与の ( %結果 ) に対し
⇒
%通知 の`~badge資源$nT ~SET %結果
</p>
◎
If the notification platform supports badges, fetch notification’s badge URL, if badge URL is set.
◎
The intent is to fetch this resource similar to an &lt;img&gt;, but this needs abstracting.
◎
Then, in parallel:
• Wait for the response.
• If the response’s internal response’s type is "default", then attempt to decode the resource as image.
• If the image format is supported, set notification’s badge resource to the decoded resource. (Otherwise notification has no badge resource.)
</li>
	<li>
<p>
~IF［
通知~platformは動作と動作~iconを~supportする
］
⇒
%通知 の`動作~群$nTを成す
~EACH( %動作 )
に対し
⇒
~IF［
%動作 の`~icon~URL$nA ~NEQ ~NULL
］
⇒
%資源を~fetchして復号する( %動作 の`~icon~URL$nA, 次の手続き )
</p>

<p class="algo">
手続きは、
所与の ( %結果 ) に対し
⇒
%動作 の`~icon資源$nA ~SET %結果 に応じて
⇒
ε ならば ~NULL ／
~ELSE_ %結果
</p>
◎
If the notification platform supports actions and action icons, then for each action in notification’s actions: if icon URL is non-null, fetch action’s icon URL.
◎
The intent is to fetch this resource similar to an &lt;img&gt;, but this needs abstracting.
◎
Then, in parallel:
• Wait for the response.
• If the response’s internal response’s type is "default", then attempt to decode the resource as image.
• If the image format is supported, then set action’s icon resource to the decoded resource. (Otherwise action’s icon resource remains null.)
</li>
</ol>
</div>

		</section>
		<section id="showing-a-notification">
<h3 title="Showing a notification">2.6. 通知を示す手続き</h3>

<div class="algo">
<p>
`通知を示す@
~algoは、
所与の
( `通知$ %通知 )
に対し：
◎
The notification show steps for a given notification notification are:
</p>
<ol>
	<li>
`通知を~fetchする$( %通知 )
— この~fetchにおいて %資源を~fetchして復号する 手続きが呼出されたならば、
それらすべてが完了するまで待機する
◎
Run the fetch steps for notification.
◎
Wait for any fetches to complete and notification’s image resource, icon resource, and badge resource to be set (if any), as well as the icon resources for the notification’s actions (if any).
</li>
	<li>
%示したか ~LET ~F
◎
Let shown be false.
</li>
	<li>
%旧~通知 ~LET `通知~list$内に次を満たす`通知$が［
在るならば それ ／
無いならば ~NULL
］
⇒
［
その`~tag$nT ~EQ %通知 の`~tag$nT ~NEQ 空~文字列
］~AND［
( その`生成元$nT, %通知 の`生成元$nT )
は`同一-生成元$である
］
◎
Let oldNotification be the notification in the list of notifications whose tag is not the empty string and is notification’s tag, and whose origin is same origin with notification’s origin, if any, and null otherwise.
</li>
	<li>
<p>
~IF［
%旧~通知 ~NEQ ~NULL
］：
◎
If oldNotification is non-null, then:
</p>
		<ol>
			<li>
`~close~eventを取扱う$( %旧~通知 )
◎
Handle close events with oldNotification.
</li>
			<li>
<p>
~IF［
通知~platformは置換を~supportする
］：
◎
If the notification platform supports replacement, then:
</p>
				<ol>
					<li>
`通知~list$内の %旧~通知 を %通知 に`置換する$
◎
Replace oldNotification with notification, in the list of notifications.
</li>
					<li>
%示したか ~SET ~T
◎
Set shown to true.
</li>
				</ol>
<p class="note">注記：
通知~platformには、
~nativeな置換
【表示-中な通知を置換する？】
を~supportすることが強く奨励される
— その方が利用者~体験は良くなるので。
◎
Notification platforms are strongly encouraged to support native replacement as it leads to a better user experience.
</p>
			</li>
			<li>
~ELSE
⇒
`通知~list$から %旧~通知 を`除去する$
◎
Otherwise, remove oldNotification from the list of notifications.
</li>
		</ol>
	</li>
	<li>
<p>
~IF［
%示したか ~EQ ~F
］：
◎
If shown is false, then:
</p>
		<ol>
			<li>
`通知~list$に %通知 を`付加する$
◎
Append notification to the list of notifications.
</li>
			<li>
機器~上に %通知 を表示する（通知~platformの適切な~APIを~callするなどにより）
◎
Display notification on the device (e.g., by calling the appropriate notification platform API).
</li>
		</ol>
	</li>
	<li>
~IF［［
%示したか ~EQ ~F
］~OR［
%旧~通知 ~NEQ ~NULL
］］~AND［
%通知 の`再通知-が選好されるか$nT ~EQ ~T
］
⇒
`通知を~alertする$( %通知 )
◎
If shown is false or oldNotification is non-null, and notification’s renotify preference is true, then run the alert steps for notification.
</li>
	<li>
<p>
~IF［
%通知 は`持続的$でない
］
⇒
`~taskを~queueする$( 【`~task~source$が指定されていない】, 次の手続き )
</p>

<div class="algo">
手続きは
⇒
`~eventを発火する$( %通知 を表現している【`唯一の$】 `Notification$I ~obj, `show^et )
</div>
◎
If notification is a non-persistent notification, then queue a task to fire an event named show on the Notification object representing notification.
</li>
</ol>
</div>

		</section>
		<section id="activating-a-notification">
<h3 title="Activating a notification">2.7. 通知の作動化-法</h3>

<p>
下層の通知~platformは作動化を~supportする下で、［
`通知$ %通知 ／
%通知 の`動作~群$nTを成すいずれかの動作
］が末端-利用者により作動化されたときは、
~UAは，（他が指定されない限り）次の手続きを走らすモノトスル：
◎
When a notification notification, or one of its actions, is activated by the end user, assuming the underlying notification platform supports activation, the user agent must (unless otherwise specified) run these steps:
</p>

<ol>
	<li>
<p>
~IF［
%通知 は`持続的$である
］：
◎
If notification is a persistent notification, then:
</p>

		<ol>
			<li>
%動作~名 ~LET 空~文字列
◎
Let action be the empty string.
</li>
			<li>
~IF［
利用者により %通知 の`動作~群$nTを成すいずれかの動作が作動化された
］
⇒
%動作~名 ~SET 当の動作の`名前$nA
◎
If one of notification’s actions was activated by the user, then set action to that notification action’s name.
</li>
			<li>
`~sw通知~eventを発火する$( `notificationclick^et, %通知, %動作~名 )
◎
Fire a service worker notification event named "notificationclick" given notification and action. 
</li>
			<li>
~RET
◎
↓</li>
		</ol>
	</li>
	<li>
<p>
`~taskを~queueする$( 【`~task~source$が指定されていない】, 次の手続き )
◎
Otherwise, queue a task＼
</p>

<div class="algo">
<p>
手続きは：
◎
to run these steps:
</p>
		<ol>
			<li>
<p>
%~focusするか ~LET 次を走らせた結果
⇒
`~eventを発火する$( %通知 を表現している【`唯一の$】 `Notification$I ~obj, `click^et )
— 次のように初期化して
⇒＃
`cancelable$m 属性 ~SET ~T
◎
Let intoFocus be the result of firing an event named click on the Notification object representing notification, with its cancelable attribute initialized to true.
</p>

<p class="note">注記：
~UAには、［
`click^et ~event用の~event~listenerの中からも， `focus()$m が働くようにする
］ことが奨励される。
◎
User agents are encouraged to make focus() work from within the event listener for the event named click.
</p>
			</li>
			<li>
~IF［
%~focusするか ~EQ ~T
］
⇒
~UAは %通知 に関係する`閲覧~文脈$の表示域に~focusするべきである
◎
If intoFocus is true, then the user agent should bring the notification’s related browsing context’s viewport into focus.
</li>
		</ol>
</div>
	</li>
</ol>

<p class="note">注記：
~web~platform全体にわたり、
"`activate^en" （ “作動化-” ）は，意図的に "`click^en" と誤って命名されている。
◎
Throughout the web platform "activate" is intentionally misnamed as "click".
</p>

		</section>
		<section id="closing-a-notification">
<h3 title="Closing a notification">2.8. 通知の~close法</h3>

<p>
［
下層の通知~platform／末端-利用者
］により`通知$が~closeされたときは、
`通知を閉じる$手続きを走らすモノトスル。
◎
When a notification is closed, either by the underlying notification platform or by the end user, the close steps for it must be run.
</p>

<div class="algo">
<p>
`通知を閉じる@
~algoは、
所与の
( `通知$ %通知 )
に対し：
◎
The close steps for a given notification notification are:
</p>

<ol>
	<li>
~IF［
%通知 ~NIN `通知~list$
］
⇒
~RET
◎
If the list of notifications does not contain notification, then abort these steps.
</li>
	<li>
`~close~eventを取扱う$( %通知 )
◎
Handle close events with notification.
</li>
	<li>
`通知~list$から %通知 を`除去する$
◎
Remove notification from the list of notifications.
</li>
</ol>
</div>

<div class="algo">
<p>
`~close~eventを取扱う@
~algoは、
所与の
( %通知 )
に対し：
◎
To handle close events given a notification notification:
</p>

<ol>
	<li>
~IF［
%通知 は`持続的$である
］~AND［
%通知 は末端-利用者により~closeされた
］
⇒
`~sw通知~eventを発火する$( `notificationclose^et, %通知 )
◎
If notification is a persistent notification and notification was closed by the end user, then fire a service worker notification event named "notificationclose" given notification.
</li>
	<li>
<p>
~IF［
%通知 は`持続的$でない
］
⇒
`~taskを~queueする$( 【`~task~source$が指定されていない】, 次の手続き )
</p>

<div class="algo">
手続きは
⇒
`~eventを発火する$( %通知 を表現している `Notification$I ~obj, `close^et  )
</div>
◎
If notification is a non-persistent notification, then queue a task to fire an event named close on the Notification object representing notification.
</li>
</ol>
</div>

		</section>
		<section id="alerting-the-user">
<h3 title="Alerting the end user">2.9. 末端-利用者への~alert法</h3>

<div class="algo">
<p>
末端-利用者に
`通知を~alertする@
~algoは、
所与の
( `通知$ %通知 )
に対し：
◎
The alert steps for alerting the end user about a given notification notification are:
</p>
<ol>
	<li>
~IF［
%通知 の`振動~pattern$nT は空でない【！if any】
］
⇒
`振動を遂行する$( %通知 の`振動~pattern$nT )
◎
Perform vibration using notification’s vibration pattern, if any.
</li>
</ol>
</div>

		</section>
	</section>
	<section id="api">
<h2 title="API">3. ~API</h2>

<pre class="idl">
[`Exposed$=(Window,Worker)]
interface `Notification@I : `EventTarget$I {
  `Notification$mc(`DOMString$ %title, optional `NotificationOptions$I %options = {});

  static readonly attribute `NotificationPermission$I `permission$m;
  [`Exposed$=Window] static `Promise$&lt;`NotificationPermission$I&gt; `requestPermission$m(optional `NotificationPermissionCallback$I %deprecatedCallback);

  static readonly attribute `unsigned long$ `maxActions$m;

  attribute `EventHandler$I `onclick$m;
  attribute `EventHandler$I `onshow$m;
  attribute `EventHandler$I `onerror$m;
  attribute `EventHandler$I `onclose$m;

  readonly attribute `DOMString$ `title$m;
  readonly attribute `NotificationDirection$I `dir$m;
  readonly attribute `DOMString$ `lang$m;
  readonly attribute `DOMString$ `body$m;
  readonly attribute `DOMString$ `tag$m;
  readonly attribute `USVString$ `image$m;
  readonly attribute `USVString$ `icon$m;
  readonly attribute `USVString$ `badge$m;
  [`SameObject$] readonly attribute `FrozenArray$&lt;`unsigned long$&gt; `vibrate$m;
  readonly attribute `EpochTimeStamp$I `timestamp$m;
  readonly attribute `boolean$ `renotify$m;
  readonly attribute `boolean$? `silent$m;
  readonly attribute `boolean$ `requireInteraction$m;
  [`SameObject$] readonly attribute `any$ `data$m;
  [`SameObject$] readonly attribute `FrozenArray$&lt;`NotificationAction$I&gt; `actions$m;

  `undefined$ `close$m();
};

dictionary `NotificationOptions@I {
  `NotificationDirection$I `dir@mO = "auto";
  `DOMString$ `lang@mO = "";
  `DOMString$ `body@mO = "";
  `DOMString$ `tag@mO = "";
  `USVString$ `image@mO;
  `USVString$ `icon@mO;
  `USVString$ `badge@mO;
  `VibratePattern$I `vibrate@mO;
  `EpochTimeStamp$I `timestamp@mO;
  `boolean$ `renotify@mO = false;
  `boolean$? `silent@mO = null;
  `boolean$ `requireInteraction@mO = false;
  `any$ `data@mO = null;
  `sequence$&lt;`NotificationAction$I&gt; `actions@mO = [];
};

enum `NotificationPermission@I {
  `default@l,
  `denied@l,
  `granted@l
};

enum `NotificationDirection@I {
  `auto@l,
  `ltr@l,
  `rtl@l
};

dictionary `NotificationAction@I {
  required `DOMString$ `action@mA;
  required `DOMString$ `title@mA;
  `USVString$ `icon@mA;
};

callback `NotificationPermissionCallback@I = `undefined$ (`NotificationPermission$I %permission);
</pre>

<p>
各 `Notification$I ~objには、
それが表現する`通知$が結付けられる：
◎
↓</p>
<ul>
	<li id="_only-one">
`持続的$でない通知を表現する `Notification$I ~objは、
`new Notification()$m 構築子を通して作成でき，通知ごとに 1 個に限られる。
◎
A non-persistent notification is represented by one Notification object and can be created through Notification's constructor.
</li>
	<li>
`持続的$な通知を表現する `Notification$I ~objは、
通知ごとに 0 個~以上いくつでもあり得る。
そのような`通知$は、
`showNotification()$m ~methodを通して作成できる。
【そのような~objたちは、 `getNotifications()$m を通して／ `~sw通知~eventを発火する$ときに作成される。】
◎
A persistent notification is represented by zero or more Notification objects and can be created through the showNotification() method.
</li>
</ul>

		<section id="garbage-collection">
<h3 title="Garbage collection">3.1. ~garbage収集</h3>

<p>
`Notification$I ~obj %N は、
次を満たしている間は~garbage収集されないモノトスル
⇒
［
%N が表現している`通知$ ~IN `通知~list$
］~AND［
%N には次に挙げるいずれかの型の`~event~listener$が~~登録されている
］
⇒
`click^et,
`show^et,
`close^et,
`error^et
◎
A Notification object must not be garbage collected while the list of notifications contains its corresponding notification and it has an event listener whose type is click, show, close, or error. 
</p>

		</section>
		<section id="constructors">
<h3 title="Constructors">3.2. 構築子</h3>

<div class="algo">
<p>
`new Notification(title, options)@m
構築子~手続きは：
◎
The new Notification(title, options) constructor steps are:
</p>
<ol>
	<li>
~IF［
コレに`関連な大域~obj$は `ServiceWorkerGlobalScope$I ~objである
］
⇒
~THROW `TypeError$E
◎
If this’s relevant global object is a ServiceWorkerGlobalScope object, then throw a TypeError.
</li>
	<li>
<p>
~IF［
%~option群[ "`actions$mO" ] は`空$でない
］
⇒
~THROW `TypeError$E
◎
If options["actions"] is not empty, then throw a TypeError.
</p>

<p class="note">注記：
`動作~群$nT（ `actions$mO ）は、
`持続的$な通知に限り，~supportされる。
◎
Actions are only supported for persistent notifications.
</p>
	</li>
	<li>
%通知 ~LET `設定群~objで通知を作成する$( %title, %options, コレに`関連な設定群~obj$ )
◎
Let notification be the result of creating a notification with a settings object given title, options, and this’s relevant settings object.
</li>
	<li>
コレの`通知$ ~SET %通知
◎
Associate this with notification.
</li>
	<li class="algo">
<p>
この段は`並列的$に走らす：
◎
Run these steps in parallel:
</p>
		<ol>
			<li>
<p>
~IF［
`通知~許可~状態を取得する$() ~NEQ `granted$l
］：
◎
If the result of getting the notifications permission state is not "granted", then＼
</p>
				<ol>
					<li>
<p>
`~taskを~queueする$( 【`~task~source$が指定されていない】, 次の手続き )
</p>

<div class="algo">
手続きは
⇒
`~eventを発火する$( コレ, `error^et )
</div>
◎
queue a task to fire an event named error on this,＼
</li>
					<li>
~RET
◎
and abort these steps.
</li>
				</ol>
			</li>
			<li>
`通知を示す$( %通知 )
◎
Run the notification show steps for notification.
</li>
		</ol>
	</li>
</ol>
</div>

		</section>
		<section id="static-members">
<h3 title="Static members">3.3. 静的~member</h3>

<div class="algo">
<p>
`permission@m
静的~取得子~手続きは
⇒
~RET `通知~許可~状態を取得する$()
◎
The static permission getter steps are to return the result of getting the notifications permission state.
</p>
</div>

<div class="note">
<p>注記：
標準を編集する者は、
上を複製するのは慎むこと。
同期的な許可は、
同期的な入出力の様なものであり，不良な案である。
◎
If you edit standards please refrain from copying the above. Synchronous permissions are like synchronous IO, a bad idea.
</p>

<p>
開発者には、
代わりに`許可~API^citeの `query()$m ~methodを利用することが奨励される。
`Permissions$r
◎
Developers are encouraged to use the Permissions query() method instead. [Permissions]
</p>

<pre class="example" id="permissions-query-example">
const %permission = await navigator.permissions.query({name: "notifications"});
if (permission.state === "granted") {
   /* <span class="comment">
`通知~API^citeを利用する許可が得られた…
◎
We have permission to use the API…
</span> */
}
</pre>
</div>

<div class="algo">
<p>
`requestPermission(deprecatedCallback)@m
静的~method~手続きは：
◎
The static requestPermission(deprecatedCallback) method steps are:
</p>
<ol>
	<li>
%大域~obj ~LET `現在の大域~obj$
◎
Let global be the current global object.
</li>
	<li>
%~promise ~LET `新たな~promise$( コレに`関連な~realm$ )
◎
Let promise be a new promise in this’s relevant Realm.
</li>
	<li class="algo">
<p>
この段は`並列的$に走らす：
◎
Run these steps in parallel:
</p>
		<ol>
			<li>
%許可~状態 ~LET `利用する許可を要請する$( `notifications$l )
◎
Let permissionState be the result of requesting permission to use "notifications".
</li>
			<li>
<p>
`大域~taskを~queueする$( `~DOM操作~task~source$, %大域~obj, 次の手続き )
◎
Queue a global task on the DOM manipulation task source given global＼
</p>

<div class="algo">
<p>
手続きは：
◎
to run these steps:
</p>
				<ol>
					<li>
~IF［
%deprecatedCallback ~NEQ ε
］
⇒
`~callback関数を呼出す$( %deprecatedCallback, « %許可~状態 », `報告する^i )
◎
If deprecatedCallback is given, then invoke deprecatedCallback with « permissionState » and "report".
</li>
					<li>
`~promiseを解決する$( %~promise, %許可~状態 )
◎
Resolve promise with permissionState.
</li>
				</ol>
</div>
			</li>
		</ol>
	</li>
	<li>
~RET %~promise
◎
Return promise.
</li>
</ol>

<p class="warning">
通知は、［
前もって末端-利用者に何かを依頼することはイミを成す
］ものと知られている一つである。
他の~API用の仕様は、
この~patternを利用せずに，
`より相応しい数多の代替＠http://robert.ocallahan.org/2011/06/permissions-for-web-applications_30.html$いずれかを使役するべきである。
◎
Notifications are the one instance thus far where asking the end user upfront makes sense. Specifications for other APIs should not use this pattern and instead employ one of the many more suitable alternatives.
</p>
</div>

<div class="algo">
`maxActions@m
静的~取得子~手続きは
⇒
~RET `最大~動作~数$
◎
The static maxActions getter steps are to return the maximum number of actions supported.
</div>

		</section>
		<section id="object-members">
<h3 title="Object members">3.4. ~obj~member</h3>

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

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

<tr><td>`onclick@m
<td>`click^et

<tr><td>`onshow@m
<td>`show^et

<tr><td>`onerror@m
<td>`error^et

<tr><td>`onclose@m
<td>`close^et
</table>

<div class="algo">
`close()@m
~method手続きは
⇒
`通知を閉じる$( コレの`通知$ )
◎
The close() method steps are to run the close steps for this’s notification.
</div>

<div class="algo">
`title@m
取得子~手続きは
⇒
~RET コレの`通知$の`~title$nT
◎
The title getter steps are to return this’s notification’s title.
</div>

<div class="algo">
`dir@m
取得子~手続きは
⇒
~RET コレの`通知$の`方向$nT
◎
The dir getter steps are to return this’s notification’s direction.
</div>

<div class="algo">
`lang@m
取得子~手続きは
⇒
~RET コレの`通知$の`言語$nT
◎
The lang getter steps are to return this’s notification’s language.
</div>

<div class="algo">
`body@m
取得子~手続きは
⇒
~RET コレの`通知$の`本体$nT
◎
The body getter steps are to return this’s notification’s body.
</div>

<div class="algo">
`tag@m
取得子~手続きは
⇒
~RET コレの`通知$の`~tag$nT
◎
The tag getter steps are to return this’s notification’s tag.
</div>

<div class="algo">
`image@m
取得子~手続きは
⇒
~RET コレの`通知$の`画像~URL$nT %~URL に応じて
⇒＃
ε ならば空~文字列 ／
~ELSE_ `~URLを直列化する$( %~URL )
◎
The image getter steps are:
• If there is no this’s notification’s image URL, then return the empty string.
• Return this’s notification’s image URL, serialized.
</div>

<div class="algo">
`icon@m
取得子~手続きは
⇒
~RET コレの`通知$の`~icon~URL$nT %~URL に応じて
⇒＃
ε ならば空~文字列 ／
~ELSE_ `~URLを直列化する$( %~URL )
◎
The icon getter steps are:
• If there is no this’s notification’s icon URL, then return the empty string.
• Return this’s notification’s icon URL, serialized.
</div>

<div class="algo">
`badge@m
取得子~手続きは
⇒
~RET コレの`通知$の`~badge~URL$nT %~URL に応じて
⇒＃
ε ならば空~文字列 ／
~ELSE_ `~URLを直列化する$( %~URL )
◎
The badge getter steps are:
• If there is no this’s notification’s badge URL, then return the empty string.
• Return this’s notification’s badge URL, serialized.
</div>

<div class="algo">
`vibrate@m
取得子~手続きは
⇒
~RET コレの`通知$の`振動~pattern$nT
◎
The vibrate getter steps are to return this’s notification’s vibration pattern.
</div>

<div class="algo">
`timestamp@m
取得子~手続きは
⇒
~RET コレの`通知$の`時刻印$nT
◎
The timestamp getter steps are to return this’s notification’s timestamp.
</div>

<div class="algo">
`renotify@m
取得子~手続きは
⇒
~RET コレの`通知$の`再通知-が選好されるか$nT
◎
The renotify getter steps are to return this’s notification’s renotify preference.
</div>

<div class="algo">
`silent@m
取得子~手続きは
⇒
~RET コレの`通知$の`静音が選好されるか$nT
◎
The silent getter steps are to return this’s notification’s silent preference.
</div>

<div class="algo">
`requireInteraction@m
取得子~手続きは
⇒
~RET コレの`通知$の`ヤリトリを要求する選好はあるか$nT
◎
The requireInteraction getter steps are to return this’s notification’s require interaction preference.
</div>

<div class="algo">
`data@m
取得子~手続きは
⇒
~RET `StructuredDeserialize$A( コレの`通知$の`~data$nT, コレに`関連な~realm$ )
⇒
例外が投出されたときは
⇒
~RET ~NULL
◎
The data getter steps are to return StructuredDeserialize(this’s notification’s data, this’s relevant Realm). If this throws an exception, then return null.
</div>

<div class="algo">
<p>
`actions@m
取得子~手続きは：
◎
The actions getter steps are:
</p>
<ol>
	<li>
%動作~群 ~LET 新たな空な
<code>`sequence$&lt;`NotificationAction$I&gt;</code>
型~値
◎
Let frozenActions be an empty list of type NotificationAction.
</li>
	<li>
<p>
コレの`通知$の`動作~群$nTを成す
~EACH( %~entry )
に対し：
◎
For each entry of this’s notification’s actions:
</p>
		<ol>
			<li>
%動作 ~LET 新たな `NotificationAction$I
◎
Let action be a new NotificationAction.
</li>
			<li>
%動作[ "`action$mA" ] ~SET %~entry の`名前$nA,
◎
Set action["action"] to entry’s name.
</li>
			<li>
%動作[ "`title$mA" ] ~SET %~entry の`~title$nA,
◎
Set action["title"] to entry’s title.
</li>
			<li>
~IF［
%~entry の`~icon~URL$nA ~NEQ ~NULL
］
⇒
%動作[ "`icon$mA" ] ~SET `~URLを直列化する$( %~entry の`~icon~URL$nA )
◎
If entry’s icon URL is non-null, then set action["icon"] to entry’s icon URL, serialized.
</li>
			<li>
%動作 上で `Object.freeze$c を~callする
— これは、
~scriptによる不用意な変異を防止する。
◎
Call Object.freeze on action, to prevent accidental mutation by scripts.
</li>
			<li>
%動作~群 に %動作 を付加する
◎
Append action to frozenActions.
</li>
		</ol>
	</li>
	<li>
~RET `凍結d配列を作成する$( %動作~群 )
◎
Return the result of create a frozen array from frozenActions.
</li>
</ol>
</div>

		</section>
		<section id="examples">
<h3 title="Examples">3.5. 例</h3>

			<section id="using-events">
<h4 title="Using events from a page">3.5.1. ~pageからの~eventの利用-法</h4>

<p>
`持続的$でない通知を表現する `Notification$I ~objには、
その存続中に~eventが配送される
— 開発者は、
それを利用して，自身が欲する挙動を生成できる。
◎
Non-persistent Notification objects dispatch events during their lifecycle, which developers can use to generate desired behaviors.
</p>

<p>
`click^et ~eventは、
末端-利用者が通知を作動化したときに配送される。
◎
The click event dispatches when the end user activates a notification.
</p>

<div class="example">
<pre class="lang-js">
var %not = new Notification("Gebrünn Gebrünn by Paul Kalkbrenner", { icon: "newsong.svg", tag: "song" });
%not.onclick = function() { displaySong(this); };
</pre>
</div>

			</section>
			<section id="using-actions">
<h4 title="Using actions from a service worker">3.5.2. ~swからの動作の利用-法</h4>

<p>
`持続的$な通知は、
`ServiceWorkerGlobalScope$I に向けて
`notificationclick^et ~eventを発火する。
◎
Persistent notifications fire notificationclick events on the ServiceWorkerGlobalScope.
</p>

<div class="example">
<p>
次の例の~swは、
1 個の “~archive” `通知~動作$を伴うある通知を示して、［
末端-利用者が、
~websiteを開かずに，この通知から この共通的な~taskを遂行する
］ことも可能にする
（例えば，通知~platformは、
通知~上に~buttonを示すかもしれない）。
末端-利用者は、
通知の本体を作動化して，その受信箱を開くこともできる。
◎
Here a service worker shows a notification with a single "Archive" notification action, allowing end users to perform this common task from the notification without having to open the website (for example, the notification platform might show a button on the notification). The end user can also activate the main body of the notification to open their inbox.
</p>

<pre class="lang-js">
self.registration.showNotification("甲さんから新たな~mailです", {
  actions: [{action: 'archive', title: "~archive"}]
});

self.addEventListener('notificationclick', function(%event) {
  %event.notification.close();
  if (%event.action === 'archive') {
    silentlyArchiveEmail();
  } else {
    clients.openWindow("/受信箱");
  }
}, false);
</pre>

<!--
New mail from Alice
 -->

</div>

			</section>
			<section id="tags-example">
<h4 title="Using the tag member for multiple instances">3.5.3. 複数の~instance用の `tag^mO ~memberの利用-法</h4>

<p>
同じ~web~appの複数の~instanceが，同時並行に運用されることは、
頻繁にある
— 末端-利用者が~browserの複数の~UItab内で~mail~appを開いたときなど。
~desktopは共有される資源であり、
`通知~API^citeの `tag$mO ~memberが，これらの~instanceが容易に協調する仕方を供する。
◎
Web applications frequently operate concurrently in multiple instances, such as when an end user opens a mail application in multiple browser tabs. Since the desktop is a shared resource, the notifications API provides a way for these instances to easily coordinate, by using the tag member.
</p>

<p>
同じ概念的~eventを表現する複数の通知には、
同じ仕方で~tagを付与できる
— 両者とも示されるとき、
末端-利用者は 1 個の通知のみを受信することになる。
◎
Notifications which represent the same conceptual event can be tagged in the same way, and when both are shown, the end user will only receive one notification.
</p>

<figure>
<pre class="lang-js">
/* <span class="comment">
ある~instanceの中で新たな~mailを通知する：
</span> */
new Notification("丙さんから~mailです", { tag: 'message1' });
</pre>

<pre class="lang-js">
/* <span class="comment">
少し経ってから，別の~instanceの中で新たな~mailを通知する：
</span> */
new Notification("丙さんから~mailです", { tag: 'message1' });
</pre>
</figure>

<!-- 
Instance 1                                   | Instance 2
                                             |
// Instance notices there is new mail.       |
new Notification("New mail from John Doe",   |
                 { tag: 'message1' });       |
                                             |
                                             |  // Slightly later, this instance notices
                                             |  // there is new mail.
                                             |  new Notification("New mail from John Doe",
                                             |                   { tag: 'message1' });
 -->

<p>
この状況における結果は、
~UAがここの~algoに従うならば，
<strong>1 個</strong>の通知 `丙さんから~mailです^l になる。
◎
The result of this situation, if the user agent follows the algorithms here, is a single notification "New mail from John Doe".
</p>

			</section>
			<section id="using-the-tag-member-for-a-single-instance">
<h4 title="Using the tag member for a single instance">3.5.4. 単独の~instance用の `tag^mO ~memberの利用-法</h4>

<p>
`tag$mO ~memberは、
~appの単独の~instanceからも利用できる
— 自身の通知を，状態~変化に伴いアリな限り最新に保つために。
◎
The tag member can also be used by a single instance of an application to keep its notifications as current as possible as state changes.
</p>

<div class="example">

<p>
例えば、
甲さんが~chat~appを利用していて，
相手の乙さんは甲が “遊休中”† の間に複数の~messageを送信した場合、
~appは［
甲が各~messageに対する~desktop通知をいちいち見ない
］ことを選好することもできる。
【†~appがどうやって “遊休中” を検出するかは、~appに委ねられる。】
◎
For example, if Alice is using a chat application with Bob, and Bob sends multiple messages while Alice is idle, the application may prefer that Alice not see a desktop notification for each message.
</p>

<pre class="lang-js">
/* <span class="comment">乙からの "こんにちは"</span> */
new Notification("乙さん： こんにちは", { tag: 'chat_乙' });

/* <span class="comment">乙からの "今日の午後は~~空いてますか？"</span> */
new Notification("乙さん： こんにちは / 今日の午後は~~空いてますか？", { tag: 'chat_乙' });
</pre>
<!-- 
// Bob says "Hi"
new Notification("Bob: Hi", { tag: 'chat_Bob' });

// Bob says "Are you free this afternoon?"
new Notification("Bob: Hi / Are you free this afternoon?", { tag: 'chat_Bob' });
-->

<p>
この状況における結果は、
`1 個^emの通知になる。
2 個目の通知は、
同じ~tagが伴われた最初の通知を置換する。
通知を~queueする（~queueされた順に通知する）~platformにおいては、
~tagを利用すれば，~queue内での通知の位置も保守-可能になる。
最新の通知を最初に示すような~platformにおいては、
`close()$m ~methodを利用して類似な結果を達成することもできる。
◎
The result of this situation is a single notification; the second one replaces the first having the same tag. In a platform that queues notifications (first-in-first-out), using the tag allows the notification to also maintain its position in the queue. Platforms where the newest notifications are shown first, a similar result could be achieved using the close() method.
</p>
</div>

			</section>
		</section>
	</section>
	<section id="service-worker-api">
<h2 title="Service worker API">4. ~sw~API</h2>

<pre class="idl">
dictionary `GetNotificationOptions@I {
  `DOMString$ `tag@mGO = "";
};

partial interface `ServiceWorkerRegistration$I {
  `Promise$&lt;`undefined$&gt; `showNotification$m(`DOMString$ %title, optional `NotificationOptions$I %options = {});
  `Promise$&lt;`sequence$&lt;`Notification$I&gt;&gt; `getNotifications$m(optional `GetNotificationOptions$I %filter = {});
};

[`Exposed$=ServiceWorker]
interface `NotificationEvent@I : `ExtendableEvent$I {
  `NotificationEvent@mc(`DOMString$ %type, `NotificationEventInit$I %eventInitDict);

  readonly attribute `Notification$I `notification@mE;
  readonly attribute `DOMString$ `action@mE;
};

dictionary `NotificationEventInit@I : `ExtendableEventInit$I {
  required `Notification$I `notification@mNI;
  `DOMString$ `action@mNI = "";
};

partial interface `ServiceWorkerGlobalScope$I {
  attribute `EventHandler$I `onnotificationclick$m;
  attribute `EventHandler$I `onnotificationclose$m;
};
</pre>

<div class="algo">
<p>
`showNotification(title, options)@m
~method手続きは：
◎
The showNotification(title, options) method steps are:
</p>
<ol>
	<li>
%大域~obj ~LET コレに`関連な大域~obj$
◎
Let global be this’s relevant global object.
</li>
	<li>
%~promise ~LET `新たな~promise$( コレに`関連な~realm$ )
◎
Let promise be a new promise in this’s relevant Realm.
</li>
	<li>
~IF［
コレにて`作動中な~worker$ ~EQ ~NULL
］
⇒＃
`~promiseを却下する$( %~promise, `TypeError$E 例外 )；
~RET %~promise
◎
If this’s active worker is null, then reject promise with a TypeError and return promise.
</li>
	<li>
<p>
%通知 ~LET `設定群~objで通知を作成する$( %~title, %~option群, コレに`関連な設定群~obj$ )
◎
Let notification be the result of creating a notification with a settings object given title, options, and this’s relevant settings object.＼
</p>

<p>
例外が投出されたときは、
~catchして
⇒＃
`~promiseを却下する$( %~promise, その例外 )；
~RET %~promise
◎
If this threw an exception, then reject promise with that exception and return promise.
</p>
	</li>
	<li>
%通知 の`~sw登録$nT ~SET コレ
◎
Set notification’s service worker registration to this.
</li>
	<li class="algo">
<p>
この段は`並列的$に走らす：
◎
Run these steps in parallel:
</p>
		<ol>
			<li>
<p>
~IF［
`通知~許可~状態を取得する$() ~NEQ `granted$l
］：
◎
If the result of getting the notifications permission state is not "granted", then＼
</p>
				<ol>
					<li>
<p>
`大域~taskを~queueする$( `~DOM操作~task~source$, %大域~obj, 次の手続き )
</p>

<div class="algo">
手続きは
⇒
`~promiseを却下する$( %~promise, `TypeError$E )
</div>
◎
queue a global task on the DOM manipulation task source given global to reject promise with a TypeError,＼
</li>
					<li>
~RET
◎
and abort these steps.
</li>
				</ol>
			</li>
			<li>
`通知を示す$( %通知 )
◎
Run the notification show steps for notification.
</li>
			<li>
<p>
`大域~taskを~queueする$( `~DOM操作~task~source$, %大域~obj, 次の手続き )
</p>

<div class="algo">
手続きは
⇒
`~promiseを解決する$( %~promise )
</div>
◎
Queue a global task on the DOM manipulation task source given global to resolve promise with undefined.
</li>
		</ol>
	</li>
	<li>
~RET %~promise
◎
Return promise.
</li>
</ol>
</div>

<div class="algo">
<p>
`getNotifications(filter)@m
~method手続きは：
◎
The getNotifications(filter) method steps are:
</p>
<ol>
	<li>
%大域~obj ~LET コレに`関連な大域~obj$
◎
Let global be this’s relevant global object.
</li>
	<li>
%~realm ~LET コレに`関連な~realm$
◎
Let realm be this’s relevant Realm.
</li>
	<li>
%生成元 ~LET コレに`関連な設定群~obj$の`生成元$enV
◎
Let origin be this’s relevant settings object’s origin.
</li>
	<li>
%~promise ~LET `新たな~promise$( %~realm )
◎
Let promise be a new promise in realm.
</li>
	<li class="algo">
<p>
この段は`並列的$に走らす：
◎
Run these steps in parallel:
</p>
		<ol>
			<li>
%通知~群 ~LET 新たな`~list$
◎
↓</li>
			<li>
<p>
`通知~list$を成す
~EACH( %通知 )
に対し，作成~順序で：
</p>
				<ol>
					<li>
<p>
~IF［
~AND↓
］…
</p>
						<ul>
							<li>
( %通知 の`生成元$nT, %生成元 )
は`同一-生成元$である
</li>
							<li>
%通知 の`~sw登録$nT ~EQ コレ
</li>
							<li>
%filter[ "`tag$mGO" ] ~IN { 空~文字列, %通知 の`~tag$nT }
</li>
						</ul>
<p>
…ならば
⇒
%通知~群 に %通知 を`付加する$
</p>
					</li>
				</ol>
◎
Let tag be filter["tag"].
◎
Let notifications be a list of all notifications in the list of notifications whose origin is same origin with origin, whose service worker registration is this, and whose tag, if tag is not the empty string, is tag.
</li>
			<li>
<p>
`大域~taskを~queueする$( `~DOM操作~task~source$, %大域~obj, 次の手続き )
◎
Queue a global task on the DOM manipulation task source given global＼
</p>
<div class="algo">
<p>
手続きは：
◎
to run these steps:
</p>
				<ol>
					<li>
%~obj群 ~LET « »
◎
Let objects be a list.
</li>
					<li>
<p>
%通知~群 を成す
~EACH( %通知 )
に対し：
◎
For each notification in notifications, in creation order,＼
</p>
						<ol>
							<li>
%~obj ~LET %通知 を表現している`新たな~obj$( `Notification$I, %~realm )
◎
create a new Notification object with realm representing notification,＼
</li>
							<li>
%~obj群 に %~obj を`付加する$
◎
and append it to objects.
</li>
						</ol>
					</li>
					<li>
`~promiseを解決する$( %~promise, %~obj群 )
◎
Resolve promise with objects.
</li>
				</ol>
</div>
			</li>
		</ol>
	</li>
	<li>
~RET %~promise
◎
Return promise.
</li>
</ol>

<p class="note">注記：
この~methodは、
新たな `Notification$I ~objたち【で解決される~promise】を返す
— それらが表現する下層の`通知$には、
すでに存在する `Notification$I ~objが表現する`通知$と同じものもあるかもしれない。
◎
This method returns zero or more new Notification objects which might represent the same underlying notification of Notification objects already in existence.
</p>
</div>

<hr>

<div class="algo">
<p>
`~sw通知~eventを発火する@
~algoは、
所与の
( 名前 %名前, `通知$ %通知, 文字列 %動作 （省略時は空~文字列） )
に対し
⇒
`機能的~eventを発火する$( %通知 の`~sw登録$nT, %名前, `NotificationEvent$I )
— 次のように初期化して
⇒＃
`notification$mE 属性 ~SET %通知 を表現している`新たな~obj$( `Notification$I, 【~realmは指定されていない】 ),
`action$mE 属性 ~SET %動作
◎
To fire a service worker notification event named name given a notification notification, and an optional string action (default the empty string): run Fire Functional Event given name, NotificationEvent, notification’s service worker registration, and the following initialization:
◎
notification
• A new Notification object representing notification.
◎
action
• action
</p>
</div>

<div class="algo">
`notification$mE
取得子~手続きは、
初期化-時の値を返す。
◎
The notification getter steps are to return the value it was initialized to.
</div>

<div class="algo">
`action$mE
取得子~手続きは、
初期化-時の値を返す。
◎
The action getter steps are to return the value it was initialized to.
</div>

<p>
次に挙げる`~event~handler$（および対応する`~event~handler~event型$）は、
`ServiceWorkerGlobalScope$I ~objの属性として~supportするモノトスル：
◎
The following is the event handler (and its corresponding event handler event type) that must be supported as attribute by the ServiceWorkerGlobalScope object:
</p>

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

<tr><td>`onnotificationclick@m
<td>`notificationclick^et

<tr><td>`onnotificationclose@m
<td>`notificationclose^et
</table>

	</section>
	<section id="acknowledgments">
<h2 title="Acknowledgments">謝辞</h2>

`_acks1@

	</section>
	<section id="ipr">
<h2 title="Intellectual property rights">知的財産権</h2>

`_ipr1@

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

<div hidden>
<div lang="en" id="_acks1">
<p>
Thanks to
Addison Phillips,
Aharon (Vladimir) Lanin,
Alex Russell,
Anssi Kostiainen,
Arkadiusz Michalski,
Boris Zbarsky,
David Håsäther,
Doug Turner,
Drew Wilson,
Ehsan Akhgari,
Frederick Hirsch,
Ian Hickson,
Jake Archibald,
James Graham,
John Mellor,
Jon Lee,
Jonas Sicking,
Michael Cooper,
Michael Henretty,
Michael™ Smith,
Michael van Ouwerkerk,
Mike Taylor,
Nicolás Satragno,
Olli Pettay,
Peter Beverloo,
Philip Jägenstedt,
Reuben Morais,
Rich Tibbett,
Robert Bindar,
박상현 (Sanghyun Park),
Simon Pieters,
Theresa O’Connor,
timeless, and
triple-underscore
for being awesome.
</p>

<p lang="en">
This standard is written by <a href="https://annevankesteren.nl/" lang="nl">Anne van Kesteren</a> (<a href="https://www.apple.com/">Apple</a>, <a href="mailto:annevk@annevk.nl">annevk@annevk.nl</a>). An earlier iteration was written
by John Gregg (<a href="https://www.google.com/">Google</a>, <a href="mailto:johnnyg@google.com">johnnyg@google.com</a>).</p>

</div>

<div lang="en" id="_ipr1">
<p>
Copyright © WHATWG (Apple, Google, Mozilla, Microsoft). This work is licensed under a <a href="https://creativecommons.org/licenses/by/4.0/" rel="license">Creative Commons Attribution 4.0 International License</a>. To the extent portions of it are incorporated into source code, such
portions in the source code are licensed under the <a href="https://opensource.org/licenses/BSD-3-Clause" rel="license">BSD 3-Clause License</a> instead.
</p>

<p>
This is the Living Standard. Those interested in the patent-review version should view the <a href="https://notifications.spec.whatwg.org/review-drafts/2023-07/">Living Standard Review Draft</a>.
</p>
</div>

</div>