LaunchParams
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The LaunchParams
interface is used when implementing custom launch navigation handling in a PWA. When window.launchQueue.setConsumer()
is invoked to set up the launch navigation handling functionality, the callback function inside setConsumer()
is passed a LaunchParams
object instance.
Instance properties
LaunchParams.files
Read only Experimental-
Returns a read-only array of
FileSystemHandle
objects representing any files passed along with the launch navigation via thePOST
method. LaunchParams.targetURL
Read only Experimental-
Returns the target URL of the launch.
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.substr(1);
audio.play();
}
}
});
}
Specifications
Specification |
---|
Web App Launch Handler API # launchparams-interface |
Browser compatibility
BCD tables only load in the browser