BackgroundFetchRegistration: matchAll() 方法

語法

matchAll()
matchAll(request)
matchAll(request,options)

引數

request 可選

您嘗試查詢記錄的 Request。它可以是 Request 物件或 URL。如果省略此引數，則結果中包含所有記錄。

options 可選

一個設定 match 操作選項的物件。可用選項包括：

ignoreSearch 可選

一個布林值，指定是否忽略 URL 中的查詢字串。例如，如果設定為 true，在執行匹配時將忽略 http://foo.com/?value=bar 中的 ?value=bar 部分。預設值為 false。

ignoreMethod 可選

一個布林值。當設定為 true 時，會阻止匹配操作驗證 Request 的 http 方法。如果為 false（預設值），則只允許 GET 和 HEAD。

ignoreVary 可選

一個布林值。當設定為 true 時，表示應忽略 Vary 頭部。預設值為 false。

返回值

一個 Promise，它解析為一個包含所有匹配的 BackgroundFetchRecord 物件陣列。

異常

InvalidStateError DOMException

如果 recordsAvailable 標誌為 false，則返回此值，表示沒有進行中的獲取操作。

示例

使用不帶引數的 matchAll() 來返回後臺獲取中的所有記錄。

const records = await bgFetch.matchAll();
console.log(records); // an array of BackgroundFetchRecord objects

規範

瀏覽器相容性