From c45fa9f65efb661fdbab4525da5054f734eeda18 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marcos=20C=C3=A1ceres?= Date: Fri, 8 Mar 2024 01:25:55 +0000 Subject: [PATCH] Editorial: define permission states consistently (#400) SHA: 75ef57e52d2734b98055ef9489bceb8d36867837 Reason: push, by marcoscaceres Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- index.html | 51 ++++++++++++++++++++++++++------------------------- 1 file changed, 26 insertions(+), 25 deletions(-) diff --git a/index.html b/index.html index 7dde37f..4d69ecd 100644 --- a/index.html +++ b/index.html @@ -183,7 +183,7 @@ .mdn .samsunginternet_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/samsung-internet/samsung-internet.svg)} .mdn .webview_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/android-webview/android-webview.png)} - + @@ -631,12 +631,12 @@

Permissions

states:

- Denied: + "denied":
The user, or the user agent on the user's behalf, has denied access to this powerful feature. The caller will can't use the feature.
- Granted: + "granted":
The user, or the user agent on the user's behalf, has given express permission to @@ -644,13 +644,13 @@

Permissions

user agent asking the user's permission.

- Prompt: + "prompt":
The user has not given express permission to use the feature (i.e., it's the same - as denied). It also means that if a caller attempts to use the feature, - the user agent will either be prompting the user for permission or access to the - feature will be denied. + as "denied"). It also means that if a caller attempts to use the + feature, the user agent will either be prompting the user for permission or access + to the feature will be "denied".

@@ -669,7 +669,7 @@

Permissions

Every permission has a lifetime, - which is the duration for which a particular permission remains granted + which is the duration for which a particular permission remains "granted" before it reverts back to its default state. A lifetime could be until a particular Realm is destroyed, until a particular top-level browsing context is destroyed, a particular amount of time, or be infinite. @@ -679,9 +679,9 @@

Permissions

Every permission has a default state (usually - prompt), which is the state that the permission is in when - the user has not yet given express permission to use the feature or it has been - reset because its lifetime has expired. + "prompt"), which is the state that the permission is in + when the user has not yet given express permission to use the feature or it has + been reset because its lifetime has expired.

3.2 @@ -788,8 +788,9 @@

Permissions

document is allowed to use a given feature. That is, a powerful feature can only request express permission from a user if the document has permission delegated to it via the corresponding policy-controlled feature (see example below). Subsequent - access to the feature is determined by the user having granted permission, - or by satisfying some criteria that is equivalent to a permission grant. + access to the feature is determined by the user having "granted" + permission, or by satisfying some criteria that is equivalent to a permission + grant.