LaunchParams
LaunchParams 介面是 Launch Handler API 的一部分,在實現 PWA 的自定義啟動導航處理時使用。當呼叫 window.launchQueue.setConsumer() 來設定啟動導航處理功能時,`setConsumer()` 中的回撥函式會接收一個 `LaunchParams` 物件例項。
這種自定義導航處理是透過 Window.launchQueue 啟動的,前提是 PWA 在啟動時具有 `launch_handler` 的 `client_mode` 值,且該值為 `focus-existing`、`navigate-new` 或 `navigate-existing`。
例項屬性
LaunchParams.files只讀 實驗性-
返回一個只讀的
FileSystemHandle物件陣列,這些物件代表透過POST方法隨啟動導航一起傳遞的任何檔案。 LaunchParams.targetURL只讀 實驗性-
返回啟動的目標 URL。
示例
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.slice(1);
audio.play();
}
}
});
}
規範
| 規範 |
|---|
| Web 應用啟動處理程式 API # launchparams-interface |
瀏覽器相容性
載入中…