LaunchParams: targetURL property

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The targetURL read-only property of the LaunchParams interface returns the target URL of the associated web app launch.

Value

A string.

Examples

js

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.substr(1);
        audio.play();
      }
    }
  });
}

Specifications

Specification
Web App Launch Handler API
# ref-for-dom-launchparams-targeturl-7

Browser compatibility

BCD tables only load in the browser

See also