Skip to content

Commit

Permalink
Update cross origin explainer (#908)
Browse files Browse the repository at this point in the history
updating the description of the install parameter based on #894

also, removing the part about adding to manifest's install_source as it no longer applies.
  • Loading branch information
htalat authored Nov 19, 2024
1 parent 79613e5 commit b610c20
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions WebInstall/explainer_cross_domain.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,9 +107,9 @@ If the `manifest_id` is the *what* to install, the `install_url` is the *where*

Unless the UA decides to [gate this functionality behind installation](#gating-capability-behind-installation), the behaviour between calling the `install` method on a tab or on an installed application should not differ. The install method can be used in two different ways.

1. `navigator.install(manifest_id, <install_url> [, <params>])`: This signature of the method requires the id of the application to be installed (`manifest_id`), and the installation location for the app (`install_url`). This is the most common API use case the API for cross-origin scenarios.
1. `navigator.install(manifest_id, <install_url> [, <params>])`: The method takes an id and install url and tries to install the web content at `install_url`. Installation will proceed if the following are true: a. The target web app links to a manifest. b. The target web app's manifest includes either an `id` or `start_url`. c. The `id` parameter matches the declared or resolved id of the target web app. This is the most common API use case the API for cross-origin scenarios.

This will prompt for installation of the app if the requesting origin has installation permissions (see [security section](#integration-with-the-permissions-api)) and the target application has specified this domain in its `install_sources` manifest field.
This will prompt for installation of the app if the requesting origin has installation permissions (see [security section](#integration-with-the-permissions-api)).

#### **Parameters**

Expand Down

0 comments on commit b610c20

Please sign in to comment.