diff --git a/index.html b/index.html index 092c9b6e..10d1322a 100644 --- a/index.html +++ b/index.html @@ -2433,6 +2433,15 @@

a new [=top-level browsing context=] with the manifest's members [=applied=].

+

+ At the discretion of the operating system or user agent, web + applications may be [=installed=] once or multiple times. +

+

Once a web application is [=installed=] it is known as a installed web application: That is, the manifest's @@ -2599,6 +2608,124 @@

+
+

+ API Definition +

+
+

+ Extensions to the `Navigator` interface +

+ + + 
+          partial interface Navigator {
+              [SecureContext, NewObject] Promise<undefined> install();
+          };
+
+

+ Internal Slots +

+

+ This API adds the following internal slot to the {{Navigator}} + interface. +

+
+
+ {{Promise}}? [[\installPromise]] +
+
+ The [=this=].{{Navigator/[[installPromise]]}} is a promise that + represents a user's current intent to install an application. It is + initialized to `null`. +
+
+

+ install() method +

+

+ When the {{Navigator/install()}} method is called, run the following + steps to [=install=] the website. +

+
    +
  1. Let |global:Window| be [=this=]'s [=relevant global object=]. +
    2. +
  2. Let |document:Document| be |global|'s [=associated Document=]. +
    3. +
  3. If |document| is not [=Document/fully active=], return [=a + promise rejected with=] an {{"InvalidStateError"}} {{DOMException}}. +
    4. +
  4. If [=this=].{{Navigator/[[installPromise]]}} is not `null`, + return [=a promise rejected with=] an {{"InvalidStateError"}} + {{DOMException}}. +
    5. +
  5. If |global| does not have [=transient activation=], return [=a + promise rejected with=] a {{"NotAllowedError"}} {{DOMException}}. +
    6. +
  6. [=Consume user activation=] of |global|. +
    7. +
  7. Set [=this=].{{Navigator/[[installPromise]]}} to be a new + promise. +
    8. +
  8. Return [=this=].{{Navigator/[[installPromise]]}} and in + parallel: +
      +
    1. [=Processing|Process=] the |document|'s [=manifest=]. +
      2. +
    2. If the |document|'s [=Document/processed manifest=] is null, + [=queue a global task=] on the [=user interaction task source=] + using |global| to: +
        +
      1. [=Reject=] [=this=].{{Navigator/[[installPromise]]}} with + an {{"DataError"}} {{DOMException}}. +
        2. +
      2. Set [=this=].{{Navigator/[[installPromise]]}} to `null`. +
        3. +
      3. Terminate this algorithm. +
        4. +
      +
      3. +
    3. Present an installation UI for the |document|'s + [=Document/processed manifest=]. + +
      4. +
    4. Wait for the user's choice. +
      5. +
    5. If the user chose to abort the install operation, or if + installing the application has failed, [=queue a global task=] on + the [=user interaction task source=] using |global| to: +
        +
      1. [=Reject=] [=this=].{{Navigator/[[installPromise]]}} with + an {{"AbortError"}} {{DOMException}}. +
        2. +
      2. Set [=this=].{{Navigator/[[installPromise]]}} to `null`. +
        3. +
      3. Terminate this algorithm. +
        4. +
      +
      6. +
    6. Otherwise, [=queue a global task=] on the [=user interaction + task source=] using |global| to: +
        +
      1. [=Resolve=] [=this=].{{Navigator/[[installPromise]]}} + with `undefined`. +
        2. +
      2. Set [=this=].{{Navigator/[[installPromise]]}} to `null`. +
        3. +
      +
      7. +
    +
    9. +
+
+
+