Skip to content

Technical review: Add doc for the scope_extensions manifest member#39649

Merged
chrisdavidmills merged 2 commits intomdn:mainfrom
chrisdavidmills:web-app-scope-extensions
Jun 4, 2025
Merged

Technical review: Add doc for the scope_extensions manifest member#39649
chrisdavidmills merged 2 commits intomdn:mainfrom
chrisdavidmills:web-app-scope-extensions

Conversation

@chrisdavidmills
Copy link
Copy Markdown
Contributor

Description

Chrome 138 supports the scope_extensions webapp manifest member; see https://chromestatus.com/feature/5746537956114432 for details.

This PR adds a reference page for the new member.

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner May 23, 2025 15:34
@chrisdavidmills chrisdavidmills requested review from pepelsbey and removed request for a team May 23, 2025 15:34
@github-actions github-actions bot added the Content:PWA Progressive Web Apps content label May 23, 2025
@chrisdavidmills chrisdavidmills changed the title Add doc for the scope_extensions manifest member Technical review: Add doc for the scope_extensions manifest member May 23, 2025
@github-actions github-actions bot added the size/m [PR only] 51-500 LoC changed label May 23, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented May 23, 2025

Preview URLs

External URLs (2)

URL: /en-US/docs/Web/Progressive_web_apps/Manifest/Reference/scope_extensions
Title: scope_extensions

(comment last updated: 2025-05-28 09:48:00)


The value of each property is an object containing a `scope` property with a value specifying the exact path that will be in-scope for the referencing web app.

EDITORIAL: I'M ASSUMING YOU CAN INCLUDE MULTIPLE FIELDS IN THE WELL-KNOWN FILE, TO OPT-IN TO THE SCOPE OF MULTIPLE WEB APPS, OR INCLUDE DIFFERENT SCOPES IN THE SCOPE OF A SINGLE WEB APP?
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is correct in the first part. Scenario:

  • Foo App at www.foo.com, manifest id of https://www.foo.com
  • Foo App Beta at beta.foo.com, manifest id of https://beta.foo.com
  • Both extend their scope to included https://help.foo.com, which is the help portal.
  • Thus, the help.foo.com's .well-known file will contain both manifest ids.

Since this is a dictionary, it's not possible to have multiple entries for the same manifest id.

@LuHuangMSFT to double check me

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @dmurph. This makes total sense, so I've updated the docs and removed the editorial note.

@LuHuangMSFT, please let me know if you have any further comments on this PR. Thanks!

Copy link
Copy Markdown
Member

@pepelsbey pepelsbey left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good! Thank you :)

```

> [!NOTE]
> See [Scope Extensions API Demo](https://main-pwa-origin-2.glitch.me/) for a working example.
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With the recent news from Glitch, I wonder if we should be using MDN’s GH pages-hosted demos instead.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm about to start doing an audit of all the glitch links/mentions we have on MDN, so we know what we've got and can figure out a migration plan for any demos we want to keep.

The Google Dev Rel folks are also working on this, so they should be moving their demos somewhere else.

I will merge this for now and then pick it up and fix it during the audit.

@chrisdavidmills chrisdavidmills merged commit 4fbd558 into mdn:main Jun 4, 2025
8 checks passed
@LuHuangMSFT
Copy link
Copy Markdown

LuHuangMSFT commented Jun 4, 2025

@chrisdavidmills Hi Chris. Sorry I'm late adding this comment. Everything in this PR looks good except for one thing - we decided to not implement the "array of strings" format in the manifest itself. Only object entries are accepted.

Also, the feature is currently spec'ed at https://wicg.github.io/manifest-incubations/#scope_extensions-member.

Thanks and great work!

@chrisdavidmills
Copy link
Copy Markdown
Contributor Author

@chrisdavidmills Hi Chris. Sorry I'm late adding this comment. Everything in this PR looks good except for one thing - we decided to not implement the "array of strings" format in the manifest itself. Only object entries are accepted.

Also, the feature is currently spec'ed at https://wicg.github.io/manifest-incubations/#scope_extensions-member.

Thanks and great work!

Hey, no worries; I'll open up a quick PR to fix that. Thx for the review!

@chrisdavidmills chrisdavidmills deleted the web-app-scope-extensions branch June 4, 2025 14:50
@chrisdavidmills
Copy link
Copy Markdown
Contributor Author

@chrisdavidmills Hi Chris. Sorry I'm late adding this comment. Everything in this PR looks good except for one thing - we decided to not implement the "array of strings" format in the manifest itself. Only object entries are accepted.

OK, so this one is fixed in #39794.

Also, the feature is currently spec'ed at https://wicg.github.io/manifest-incubations/#scope_extensions-member.

And the necessary data to generate the spec table is added in mdn/browser-compat-data#26983.

@pepelsbey, would you mind having a quick look at these ones, given that you've just looked at the original PR? ;-)

estelle pushed a commit that referenced this pull request Jun 6, 2025
…39649)

* Add doc for the scope_extensions manifest member

* Fix for dmurph review comment
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:PWA Progressive Web Apps content size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants