Launch Handler API
The LaunchParams interface of the Launch Handler API is used when implementing custom launch navigation handling in a PWA. When LaunchQueue.setConsumer is invoked to set up the launch navigation handling functionality, the callback function inside setConsumer() is passed a LaunchParams object instance.
Such custom navigation handling is initiated via Window.launchQueue when a PWA has been launched with a launch_handler client_mode value of focus-existing, navigate-new, or navigate-existing.
Instance properties
- LaunchParams.files
- : Returns a read-only array of FileSystemHandle objects representing any files passed along with the launch navigation via the
POSTmethod.
- : Returns a read-only array of FileSystemHandle objects representing any files passed along with the launch navigation via the
- LaunchParams.targetURL
- : 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.slice(1);
audio.play();
}
}
});
}
Specifications
Browser compatibility
See also
- Launch Handler API: Control how your app is launched
- Window.launchQueue
- Musicr 2.0 demo app
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
