diff --git a/index.html b/index.html index e34e619..5f10fab 100644 --- a/index.html +++ b/index.html @@ -163,63 +163,6 @@

-
-

- Permissions and user prompts -

-

- The [[PERMISSIONS]] API provides a uniform way for websites to request - permissions from users and query which permissions they have. -

-

- A user agent can deny a wake lock of a - particular wake lock type for a particular {{Document}} by any - implementation-specific reason, such as platform setting or user - preference. -

-

- It is RECOMMENDED that a user agent show some form of unobtrusive - notification that informs the user when a wake lock is active, as well - as provides the user with the means to [=screen wake lock permission - revocation algorithm|block=] the ongoing operation, or simply dismiss - the notification. -

-
-

- The `"screen-wake-lock"` powerful feature -

-

- The `"screen-wake-lock"` powerful feature enables the - capability defined by this specification. -

-
-
-

- Permission algorithms -

-

- The `"screen-wake-lock"` powerful feature defines a [=powerful - feature/permission revocation algorithm=]. To invoke the Screen - Wake Lock permission revocation algorithm, run these steps: -

-
    -
  1. Let |document:Document| be the [=current global object=]'s - [=associated Document=]. -
    2. -
  2. Let |lockList| be - |document|.{{Document/[[ActiveLocks]]}}["`screen`"]. -
    3. -
  3. [=list/For each=] |lock:WakeLockSentinel| in |lockList|: -
      -
    1. Run release a wake lock with |document|, |lock|, and - {{WakeLockType/"screen"}}. -
      2. -
    -
    4. -
-
-

Concepts @@ -316,9 +259,8 @@

  • Let |document:Document| be [=this=]'s [=relevant global object=]'s [=associated Document=].
    • -
  • If - |document| is not [=allowed to use=] the [=policy-controlled +
  • + If |document| is not [=allowed to use=] the [=policy-controlled feature=] named "`screen-wake-lock`", return [=a promise rejected with=] a {{"NotAllowedError"}} {{DOMException}}.
    • @@ -327,81 +269,39 @@

    |document|, return [=a promise rejected with=] a {{"NotAllowedError"}} {{DOMException}}. -
  • If - |document| is not [=Document/fully active=], return [=a promise - rejected with=] with a {{"NotAllowedError"}} {{DOMException}}. -
  • If |document|'s [=Document/visibility state=] is "`hidden`", return [=a promise rejected with=] {{"NotAllowedError"}} {{DOMException}}.
  • Let |promise:Promise| be [=a new promise=].
    • -
  • Run the following steps in parallel: +
  • Return |promise| and run the following steps in [=in parallel=]:
      -
    1. Let |state:PermissionState| be the result of requesting - permission to use "`screen-wake-lock`". +
    2. Invoke acquire a wake lock with + {{WakeLockType/"screen"}}. + +
      3. +
    3. Let |lock:WakeLockSentinel| be a new {{WakeLockSentinel}} + object with its {{WakeLockSentinel/type}} attribute set to + |type|.
      4. -
    4. If |state| is - {{PermissionState/"denied"}}, then: -
        -
      1. - Queue a global task on the screen wake lock task - source given |document|'s relevant global object - to reject |promise| with a {{"NotAllowedError"}} - {{DOMException}}. -
        2. -
      2. Abort these steps. -
        3. -
      +
    5. [=List/Append=] |lock| to + |document|.{{Document/[[ActiveLocks]]}}["`screen`"].
      6. -
    6. - Queue a global task on the screen wake lock task - source given |document|'s relevant global object to - run these steps: -
        -
      1. If |document|'s [=Document/visibility state=] is - "`hidden`", then: -
          -
        1. Reject |promise| with a {{"NotAllowedError"}} - {{DOMException}}. -
          2. -
        2. Abort these steps. -
          3. -
        -
        2. -
      2. If |document|.{{Document/[[ActiveLocks]]}}["`screen`"] - [=list/is empty=], then invoke the following steps in - parallel: -
          -
        1. Invoke acquire a wake lock with - {{WakeLockType/"screen"}}. - -
          2. -
        -
        3. -
      3. Let |lock:WakeLockSentinel| be a new {{WakeLockSentinel}} - object with its {{WakeLockSentinel/type}} attribute set to - |type|. -
        4. -
      4. [=List/Append=] |lock| to - |document|.{{Document/[[ActiveLocks]]}}["`screen`"]. -
        5. -
      5. Resolve |promise| with |lock|. -
        6. -
      +
    7. [=Queue a global task=] on the [=screen wake lock task + source=] to [=resolve=] |promise| with |lock|.
    • -
  • Return |promise|. -

    • @@ -647,10 +547,6 @@

    Handling document loss of full activity

    -

    - When a {{Document}} |document:Document| becomes no longer - [=Document/fully active=], the user agent must run these steps: -

    1. [=list/For each=] |lock:WakeLockSentinel| in |document|.{{Document/[[ActiveLocks]]}}["`screen`"]: @@ -716,6 +612,14 @@

    2. Remove |lock| from |document|.{{Document/[[ActiveLocks]]}}[|type|].
      3. +
    3. [=Queue a task=] on the [=screen wake lock task source=] to: +
        +
      1. Set |lock|'s {{WakeLockSentinel/[[Released]]}} to `true`. +
        2. +
      2. [=Fire an event=] named "`release`" at |lock|. +
        3. +
      +
    4. If |document|.{{Document/[[ActiveLocks]]}}[|type|] [=list/is empty=], then run the following steps in parallel:
        @@ -723,13 +627,8 @@

        lock of type |type| and let |success:boolean| be `true` if the operation succeeded, or else `false`. -
      1. If |success| is `true` and |type| is `"screen"` run the - following: -
          -
        1. Reset the platform-specific inactivity timer after which - the screen is actually turned off. -
          2. -
        +
      2. If the operation succeeds, reset the platform-specific + inactivity timer after which the screen is actually turned off.