Web-Facing Change PSA: Navigations can now be captured into an installed PWA

143 views
Skip to first unread message

Dibyajyoti Pal

unread,
Apr 2, 2025, 5:33:17 PM4/2/25
to blink-dev, pwa-dev

Contact emails

diby...@chromium.org

pwa...@chromium.org


Design Doc

https://bit.ly/pwa-navigation-capturing


Developer Documentation

https://bit.ly/pwa-navigation-management

https://youtu.be/OFH9TfrqZCY


Chrome Status Entry

https://chromestatus.com/feature/5183927385587712


Platforms

Windows, Mac, Linux

ChromeOS will be upgraded from its current link capturing behavior to this version in the near future.

Summary

Web links now direct users to installed web apps to align with users’ installed app expectations. Users have the option of turning the behavior off or on from the installed web app’s settings page. Developers can control the behavior by using the launch_handler manifest property.

A version of feature is launched on ChromeOS today but is off by default (and has key differences that break web platform experiences, see https://bit.ly/pwa-navigation-capturing for more information) 

Today, only installed web apps having the launch_handler field specified in the manifest are automatically opted into this behavior. Once partner testing is complete, this behavior will be enabled by default for all installed web apps.

Blink components

Blink > AppManifest

Chrome components

UI > Browser > WebAppInstalls > Desktop

Tracking Bug

crbug.com/267495181

crbug.com/324435093 (Windows, Mac and Linux)

crbug.com/366547977 (ChromeOS)


Estimated milestone

M134: Launched, enabled by default for installed PWAs that specify a launch_handler

M135: Planned launch to enable by default for all installed PWAs


Nate Chapin

unread,
Jun 24, 2026, 6:49:45 PM (6 days ago) Jun 24
to Dibyajyoti Pal, blink-dev, pwa-dev
Follow-up PSA: We're fixing a bug in our implementation of capturing a navigation to an installed PWA.

When https://crrev.com/c/7963209 lands (for Chrome 151), we will allow a PWA to capture the creation of new auxiliary browsing contexts (e.g., window.open(url, '_blank')) if: (1) the new window creation is triggered from within a PWA, and (2) the target url is in the PWA's scope. This means that PWAs can window.open() into that PWA's preferred window/tab type based on the PWA's display mode, rather than opening in a non-PWA browser tab.

Feel free to reach out to pwa-dev@chromium.org if you have any questions or concerns!
~Nate


--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.
To view this discussion visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CA%2BODhFip0kktQ-JF3%3DPHSfFRZLKAu1PS%3Dd%2BaZ7rSsCp%3DG4mVDA%40mail.gmail.com.
Reply all
Reply to author
Forward
0 new messages