Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Editorial: use string literal for permission name #136

Merged
merged 2 commits into from
Feb 23, 2022
Merged

Editorial: use string literal for permission name #136

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4c2ca90
Editorial: use string literal for permission name
marcoscaceres Feb 23, 2022
11ee8c9
formatting
annevk Feb 23, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 9 additions & 10 deletions storage.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -462,28 +462,27 @@ is needed for <a href="https://github.com/whatwg/storage/issues/4">issue #4</a>

<p>A <a>local storage bucket</a> can only have its <a for="local storage bucket">mode</a> change to
"<code>persistent</code>" if the user (or user agent on behalf of the user) has granted permission
to use the "persistent-storage" <a>powerful feature</a>.
to use the "<code>persistent-storage</code>" <a>powerful feature</a>.

<p class="note">When granted to an <a for=/>origin</a>, the persistence permission can be used to
protect storage from the user agent's clearing policies. The user agent cannot clear storage marked
as persistent without involvement from the <a for=/>origin</a> or user. This makes it particularly
useful for resources the user needs to have available while offline or resources the user creates
locally.

<p>The "persistent-storage"
<a>powerful feature</a>'s permission-related algorithms, and types are defaulted, except for:
<p>The "<code>persistent-storage</code>" <a>powerful feature</a>'s permission-related algorithms,
and types are defaulted, except for:

<dl>
<dt><a>permission state</a>
<dd><p>"persistent-storage"'s <a>permission state</a> must have the same value
for all <a>environment settings objects</a> with a given
<a for="environment settings object">origin</a>.
<dd><p>"<code>persistent-storage</code>"'s <a>permission state</a> must have the same value for all
<a>environment settings objects</a> with a given <a for="environment settings object">origin</a>.

<dt><a>permission revocation algorithm</a>
<dd algorithm="permission-revocation">
<ol>
<li><p>If the result of <a>getting the current permission state</a> with
"persistent-storage" is "{{PermissionState/granted}}", then return.
"<code>persistent-storage</code>" is "{{PermissionState/granted}}", then return.

<li><p>Let <var>shelf</var> be the result of running <a>obtain a local storage shelf</a> with
<a>current settings object</a>.
Expand Down Expand Up @@ -511,8 +510,8 @@ available storage space on the device.

<div class=note>
<p>User agents are strongly encouraged to consider navigation frequency, recency of visits,
bookmarking, and <a href="#persistence">permission</a> for "persistent-storage"
when determining quotas.
bookmarking, and <a href="#persistence">permission</a> for "<code>persistent-storage</code>" when
determining quotas.

<p>Directly or indirectly revealing available storage space can lead to fingerprinting and leaking
information outside the scope of the <a for=/>origin</a> involved.
Expand Down Expand Up @@ -637,7 +636,7 @@ dictionary StorageEstimate {
<ol>
<li>
<p>Let <var>permission</var> be the result of <a>requesting permission to use</a>
"persistent-storage".
"<code>persistent-storage</code>".

<p class="note">User agents are encouraged to not let the user answer this question twice for
the same <a for=/>origin</a> around the same time and this algorithm is not equipped to handle
Expand Down