webappsec-permissions-request-ja.html

<!DOCTYPE html><html><head><meta charset="utf-8">
<title>Requesting Permissions（日本語訳）</title>

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

<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;

	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 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 = `#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 'l':
	text = `"<code class="literal">${key}</code>"`;
	break;
case 'U':
	text = `U+${key}`;
	break;
case 'en':
	text = `<span lang="en">${key}</span>`;
	break;
default:
}

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_title:Requesting Permissions
spec_date:2022-05-09
trans_update:2023-07-20
source_checked:220509
page_state_key:WEBAPPSEC
original_url:https://wicg.github.io/permissions-request/
	abbr_url:PERMISSION-REQUEST
spec_status:EDCG
ref_id_prefix:bib-
	site_nav:
	conformance:w3c
trans_1st_pub:2023-07-20


●●class_map
E:error
e:element
a:attr
et:event-type
U:code-point

●●tag_map
c:code
I:code
E:code
m:code
mb:code
dpO:code
fpO:code
et:code
e:code
a:code
sub:sub
U:span
i:i
cite:cite

●●ref_key_map

●●original_id_map

●●mdn_urls

●●link_map

	●IDL
object:~WEBIDL#idl-object
Promise:~WEBIDL#idl-promise

I.Permissions:~PERMISSIONS#dom-permissions
I.PermissionStatus:~PERMISSIONS#dom-permissionstatus
I.PermissionDescriptor:~PERMISSIONS#dom-permissiondescriptor

m.request:#dom-permissions-request
	mb.name:~PERMISSIONS#dom-permissiondescriptor-name → 識別される特能
l.prompt:~PERMISSIONS#dom-permissionstate-prompt

	●用語
許可~要請~algo:#permission-request-algorithm
既定の許可~要請~algo:#default-permission-request-algorithm

	●用語（外部
~IDL値に変換する:~WEBIDLjs#dfn-convert-javascript-to-idl-value
却下される~promise:~WEBIDLjs#a-promise-rejected-with
~promiseを却下する:~WEBIDLjs#reject
~promiseを解決する:~WEBIDLjs#resolve
新たな~promise:~WEBIDLjs#a-new-promise

並列的:~HTMLINFRA#in-parallel

強力な特能:~PERMISSIONS#dfn-powerful-feature
許可~記述子~型:~PERMISSIONS#dfn-permission-descriptor-type
許可~状態sを作成する:~PERMISSIONS#dfn-create-a-permissionstatus
許可~結果型:~PERMISSIONS#dfn-permission-result-type
既定の許可を~queryする~algo:~PERMISSIONS#dfn-default-permission-query-algorithm
利用する許可を要請する:~PERMISSIONS#dfn-request-permission-to-use
識別される特能:~PERMISSIONS#_powerful-feature-by-name

環境~設定群~obj:~WAPI#environment-settings-object
許可~registry:~PERMISSIONS#permissions-registry

●●words_table1
W3C-TYPES:w3c-standards-types-ja.html

●●words_table


	●処理
結果型:result type::~
持続的:persistent:~

	許可~状態s:PermissionStatus
	並列的:asynchronously
	%状態s:status
	%根~記述子:rootDesc
	%有型~記述子:typedDescriptor
	%許可~記述子:permissionDesc

	●仕様
機能:function:~
一様:uniform:~
例外的:exceptional:~
行程:track:~
学んで:learn:~
	伴わせる:conflate 〜 with
	まちまち:disparate

	●未分類
増やす:increaseする:~
	示す:show
	単に:merely
	指す:refer

●●ref_normative

[HTML]
    Anne van Kesteren; et al. ＜HTML Standard＞. Living Standard. URL: https://html.spec.whatwg.org/multipage/
[PERMISSIONS]
    Marcos Caceres; Mike Taylor. ＜Permissions＞. 11 March 2022. WD. URL: https://www.w3.org/TR/permissions/
[RFC2119]
    S. Bradner. ＜Key words for use in RFCs to Indicate Requirement Levels＞. March 1997. Best Current Practice. URL: https://datatracker.ietf.org/doc/html/rfc2119
[WEBIDL]
    Edgar Chen; Timothy Gu. ＜Web IDL Standard＞. Living Standard. URL: https://webidl.spec.whatwg.org/

●●ref_informative

[geolocation-API]
    Andrei Popescu. ＜Geolocation API Specification 2nd Edition＞. 8 November 2016. REC. URL: https://www.w3.org/TR/geolocation-API/
[NOTIFICATIONS]
    Anne van Kesteren. ＜Notifications API Standard＞. Living Standard. URL: https://notifications.spec.whatwg.org/


●●trans_metadata
<p>
~THIS_PAGEは、~W3Cにより Draft Community Group Report として公開された
<a href="~SPEC_URL">Requesting Permissions</a>
を日本語に翻訳したものです。
~PUB
</p>

●●spec_metadata

課題追跡
	https://github.com/jyasskin/permissions-request/issues/
編集
	<a href="mailto:engedy@google.com">Balazs Engedy</a> (Google Inc.)
前任編集者
	<a href="mailto:jyasskin@google.com">Jeffrey Yasskin</a> (Google Inc.)
テスト
	https://github.com/w3c/web-platform-tests/tree/master/permissions-request
テスト（進行中の作業）
	https://github.com/w3c/web-platform-tests/labels/permissions-request
Polyfills
	https://github.com/chromium/permissions.request
公表者
	<a href="https://www.w3.org/community/wicg/">Web Platform Incubator Community Group</a>
commit 履歴
	https://github.com/WICG/permissions-request/commits/main

●●copyright
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2022 the Contributors to the Requesting Permissions Specification, published by the <a href="https://www.w3.org/community/wicg/">Web Platform Incubator Community Group</a> under the <a href="https://www.w3.org/community/about/agreements/cla/">W3C Community Contributor License Agreement (CLA)</a>. A human-readable <a href="http://www.w3.org/community/about/agreements/cla-deed/">summary</a> is available.

</script>
</head>

<body>

<header>
	<hgroup>
<h1>許可の要請法 — Requesting Permissions</h1>
	</hgroup>
</header>

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

<p>
この仕様は、
`許可~API^cite `PERMISSIONS$r を拡張して，
`強力な特能$を`利用する許可を要請する$ための一様な機能を供する。
◎
This specification extends the Permissions API to provide a uniform function for requesting permission to use powerful features.
</p>

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

<p>
この仕様は
`Web Platform Incubator Community Group＠https://www.w3.org/community/wicg/$en
により公表されました。
これは、
~W3C標準でも`~W3C標準~化~行程＠~W3C-TYPES#standardtrack$でもありません。
`W3C Community Contributor License Agreement (CLA)＠https://www.w3.org/community/about/agreements/cla/$en
の下では、
opt-out は制限され，他の条件が適用されることに注意されたし。
`W3C Community and Business Groups＠http://www.w3.org/community/$en
について，もっと学んでください。
◎
This specification was published by the Web Platform Incubator Community Group. It is not a W3C Standard nor is it on the W3C Standards Track. Please note that under the W3C Community Contributor License Agreement (CLA) there is a limited opt-out and other conditions apply. Learn more about W3C Community and Business Groups.
</p>

	</section>

<main id="MAIN0">

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

<p>
この文書は、
~Web~platform上で`強力な特能$を利用する許可を要請するための機能を指定する。
◎
This document specifies a function to request permission to use powerful features on the Web platform.
</p>

<p>
開発者が~Web~APIを利用する意図を通達する仕方は、
~APIごとに まちまちである：
◎
Different Web APIs have disparate ways to signal a developer’s intent to use them:
</p>
<ul>
	<li>
`notifications$r ~APIは、［
許可を要請すること，許可~状態sを明示的に検査すること
］を開発者に許容する。
◎
The [notifications] API allows developers to request a permission and check the permission status explicitly.
</li>
	<li>
`geolocation-API$r は、
許可~要請を所在~要請に伴わせる。
◎
The [geolocation-API] conflates the permission request with a location request.
</li>
</ul>

<p>
開発者にとっては、
すべての`強力な特能$が従うべき単独の~patternがあった方が，
自身の［
許可に関係する~code
］を設計することは もっと容易になる。
◎
It’s easier for developers to design their permission-related code if they have a single pattern to follow for all powerful features.
</p>

	</section>
	<section id="api">
<h2 title="Request API">2. 要請~API</h2>

<pre class="idl">
partial interface `Permissions$I {
  `Promise$&lt;`PermissionStatus$I&gt; `request$m(`object$ %permissionDesc);
};
</pre>

<div class="algo">
<p>
`request(permissionDesc)@m
~method手続きは：
◎
When the request(permissionDesc) method is invoked, the user agent MUST run the following algorithm, passing the parameter permissionDesc:
</p>
<ol>
	<li>
%記述子~obj ~LET %permissionDesc が指す【~JS】~obj
◎
↓</li>
	<li>
<p>
%根~記述子 ~LET `~IDL値に変換する$( %記述子~obj, `PermissionDescriptor$I )
</p>

<p>
例外が投出されたときは、
~catchして
⇒
~RET `却下される~promise$( その例外 )
</p>
◎
Let rootDesc be the object permissionDesc refers to, converted to an IDL value of type PermissionDescriptor. If this throws an exception, return a promise rejected with that exception and abort these steps.
</li>
	<li>
%特能 ~LET %根~記述子 で`識別される特能$
</li>
	<li>
<p>
%有型~記述子 ~LET `~IDL値に変換する$( %記述子~obj, %特能 の`許可~記述子~型$ )
</p>

<p>
例外が投出されたときは、
~catchして
⇒
~RET `却下される~promise$( その例外 )
</p>
◎
Let typedDescriptor be the object permissionDesc refers to, converted to an IDL value of rootDesc.name’s permission descriptor type. If this throws an exception, return a promise rejected with that exception and abort these steps.
</li>
	<li>
%~promise ~LET `新たな~promise$
◎
Let promise be a newly-created Promise.
</li>
	<li class="algo">
<p>
この段は`並列的$に遂行する：
◎
Return promise and continue the following steps asynchronously.
</p>
		<ol>
			<li>
%状態s ~LET `許可~状態sを作成する$( %有型~記述子 )
◎
Run the steps to create a PermissionStatus for typedDescriptor, and let status be the result.
</li>
			<li>
<p>
%特能 用の`許可~要請~algo$( %有型~記述子, %状態s )
◎
Run the permission request algorithm of the feature named typedDescriptor.name with typedDescriptor and status as arguments.
</p>

<p>
例外が投出されたときは、
~catchして
⇒＃
`~promiseを却下する$( %~promise, その例外 )；
~RET
◎
If the previous step threw an exception, reject promise with that exception.
</p>
			</li>
			<li>
`~promiseを解決する$( %~promise, %状態s )
◎
Otherwise resolve promise with status.
</li>
		</ol>
	</li>
	<li>
~RET %~promise
◎
↑</li>
</ol>
</div>

	</section>
	<section id="registry-additions">
<h2 title="Additional fields in the Permission Registry">3. 許可~registry内の追加的な~field</h2>

<p>
`許可~registry$を成す各`強力な特能$は、
`許可~要請~algo@
を追加的に定義してもヨイ
— それは：
◎
Powerful features in the Permission Registry additionally define a permission request algorithm:
</p>
<ul>
	<li>
( `許可~記述子~型$を成す~instance %記述子, `許可~結果型$の~instance %結果 )
を入力にとるとする。
~call元は、
%結果 に新たな~instanceを与えるとする。
【必要なら。この~algoは %結果 を改変し得るので。】
◎
Input
• An instance of the permission descriptor type
• A newly-created instance of the permission result type.
</li>
	<li>
次のように挙動するとする
⇒
%記述子 を`利用する許可を要請する$【！~PERMISSIONS#requesting-more-permission$】ことにより，もっと許可を増やすよう試行するために必要yな~promptを利用者に示した上で、
その結果に合致するよう %結果 を更新する
◎
Behavior
• Uses the algorithms in Requesting more permission to show the user any necessary prompt to try to increase permissions, and updates the instance of the permission result type to match.
</li>
	<li>
値を返さないとするが、
当の要請が例外的に失敗し得る場合には，例外を投出してもヨイ
（単に許可が否認されるだけでは、
例外的とは言えない）。
◎
Returns
• Nothing, but may throw an exception if the request can fail exceptionally. (Merely being denied permission is not exceptional.)
◎
↓↓ Example callers
• Permissions.request(permissionDesc)
</li>
	<li>
未指定な場合の既定は、
`既定の許可~要請~algo$になるとする。
◎
Default
• If unspecified, this defaults to the default permission request algorithm.
</li>
</ul>

<p>
`許可~要請~algo$は、
例えば，
`Permissions$I の `request()$m ~methodから~callされる。
◎
↑↑</p>

		<section id="default-request-algorithm">
<h3 title="Default request algorithm">3.1. 既定の要請~algo</h3>

<div class="algo">
<p>
`既定の許可~要請~algo@
は、
所与の
( `PermissionDescriptor$I %許可~記述子, `PermissionStatus$I %状態s )
に対し，
次の手続きを走らす：
◎
The default permission request algorithm, given a PermissionDescriptor permissionDesc and a PermissionStatus status, runs the following steps:
</p>
<ol>
	<li>
`既定の許可を~queryする~algo$( %許可~記述子, %状態s )
◎
Run the default permission query algorithm on permissionDesc and status.
</li>
	<li>
~IF［
%状態s[ "`state^c" ] ~NEQ `prompt$l
］
⇒
~RET
◎
If status.state is not "prompt", abort these steps.
</li>
	<li>
`利用する許可を要請する$( %許可~記述子 )
◎
Request permission to use permissionDesc.
</li>
	<li>
<p>
`既定の許可を~queryする~algo$( %許可~記述子, %状態s )
◎
Run the default permission query algorithm again on permissionDesc and status.
</p>

<p class="issue">
許可を`環境~設定群~obj$の中に持続的に格納しない~browser上では，
これは常に `prompt$l を返すことになるが、
それでも，利用者に不必要な~promptを示す。
それは，適切な~obj能力を決して返せないので、［
どの許可も`既定の許可~要請~algo$を利用するべきでない
］ことを意味するであろう。
◎
On browsers that don’t store permissions persistently within an environment settings object, this will always return "prompt", but still show the user an unnecessary prompt. That may mean that no permissions should use the default permission request algorithm, since it can never return an appropriate object-capability.
</p>
	</li>
</ol>
</div>

		</section>
	</section>
	<section id="security">
<h2 title="Security Considerations">4. ~securityの考慮点</h2>

<p>
~securityの考慮点として識別されたものは無い。
◎
No security considerations have been identified.
</p>

	</section>
	<section id="privacy">
<h2 title="Privacy Considerations">5. ~privacyの考慮点</h2>

<p>
~privacyの考慮点として識別されたものは無い。
◎
No privacy considerations have been identified.
</p>

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