LaunchQueue: setConsumer() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental:This is anexperimental technology
Check theBrowser compatibility table carefully before using this in production.

ThesetConsumer() method of theLaunchQueue interface is used to declare the callback that will handle custom launch navigation handling in aprogressive web app (PWA). Such custom navigation is initiated viaWindow.launchQueue when a PWA has been launched with alaunch_handlerclient_mode value offocus-existing,navigate-new, ornavigate-existing.

Syntax

setConsumer(callback)

Parameters

callback: A callback function that handles custom navigation for the PWA. The callback is passed aLaunchParams object instance as a parameter.

Return value

undefined.

Examples

if ("launchQueue" in window) {  window.launchQueue.setConsumer((launchParams) => {    if (launchParams.targetURL) {      const params = new URL(launchParams.targetURL).searchParams;      // Assuming a music player app that gets a track passed to it to be played      const track = params.get("track");      if (track) {        audio.src = track;        title.textContent = new URL(track).pathname.slice(1);        audio.play();      }    }  });}