Intent to Experiment: Web app launch handler

Skip to first unread message

Alan Cutter

Oct 27, 2021, 4:55:54 AM10/27/21
to blink-dev

Contact emails



Adds a "launch_handler" app manifest member that enables web apps to customise their launch behaviour across all types of app launch triggers. Example usage: { "name": "Example app", "start_url": "/index.html", "launch_handler": { "route_to": "existing", "navigate_existing_client": "always" } } This will cause all launches of the Example app to focus an existing app window and navigate it (if it exists) instead of always launching a new app window.

Blink component


Search tags

web apppwalink capturinglink handlinglaunch

TAG review

TAG review status



Interoperability and Compatibility

Gecko: No signal


Web developers: Strong positive signals on the Declarative Link Capturing origin trial which has overlapping behaviour with this API (which is replacing DLC).

Goals for experimentation

Replace the Declarative Link Capturing API experiment and gather feedback on the "navigate_existing_client": "never" behaviour as it gets an implementation.

Ongoing technical constraints

Overlap with the Declarative Link Capturing origin trial to enable existing clients to migrate over to this new API.

Will this feature be supported on all six Blink platforms (Windows, Mac, Linux, Chrome OS, Android, and Android WebView)?

Windows, Mac, Linux and Chrome OS.

Is this feature fully tested by web-platform-tests?

No, this requires browser tests.

Flag name


Requires code in //chrome?


Tracking bug

Launch bug

Estimated milestones


Link to entry on the Chrome Platform Status

Links to previous Intent discussions

Intent to prototype:

This intent message was generated by Chrome Platform Status.

Chris Harrelson

Nov 4, 2021, 3:16:21 PM11/4/21
to Alan Cutter, blink-dev
LGTM, but is this only in M97? Or did you want to run it for additional milestones?

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
To view this discussion on the web visit

Alan Cutter

Nov 9, 2021, 1:41:46 AM11/9/21
to Chris Harrelson, blink-dev
My mistake!
Requesting 6 month origin trial: M97 to M102 inclusive.

Chris Harrelson

Nov 9, 2021, 3:03:08 PM11/9/21
to Alan Cutter, blink-dev
Reply all
Reply to author
0 new messages