rayankans / app-shortcuts

5 stars 1 forks source link

Define what is a document with a web app manifest #3

Open beaufortfrancois opened 4 years ago

beaufortfrancois commented 4 years ago

It is not clear to me when setting/getting dynamic app shortcuts will return an error. In other words, what does a document with a web app manifest mean? Does web app manifest has to be fetched and meet instability requirements? Does web page has to be installed yet? Does it work for non top-level frames?

rayankans commented 4 years ago

Explainers don't generally include that level of detail, those live in the spec.

But to answer your questions:

what does a document with a web app manifest mean?

A page with a rel="manifest" link

Does web app manifest has to be fetched and meet instability requirements?

There should be a valid manifest. Installability requirements are UA-specific considerations, so no you can use the API without meeting the criteria (i.e get/set should work). However the UA will still be able to decide on whether it should display the shortcuts or not.

Does web page has to be installed yet?

No, the UA will just store the info and use it when applicable.

Does it work for non top-level frames?

Manifest contexts only exist in top-level frames, so no.