webRequest.RequestFilter

描述應用於 webRequest 事件的過濾器的物件。

型別

此型別的值是物件。它們包含以下屬性:

URLs

array of string。一個包含 匹配模式 的陣列。監聽器將僅為目標匹配任何給定模式的請求呼叫。只有使用 HTTP 或 HTTPS 發出的請求才會觸發事件,模式匹配支援的其他協議(如 data: 和 file:)不會觸發事件。view-source: 請求可以根據其內部 URL 進行匹配。

types 可選

array of webRequest.ResourceType。一個資源型別列表(例如,樣式表、影像、指令碼)。監聽器將僅為請求這些給定型別之一的資源時呼叫。

tabId 可選

integer。監聽器將僅為 ID 為此的 tab 發出的請求呼叫。

windowId 可選

integer。監聽器將僅為 ID 為此的 window 發出的請求呼叫。

incognito 可選

boolean。如果提供,則會過濾掉不匹配隱私瀏覽狀態(truefalse)的請求。

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.webRequest API。本文件源自 Chromium 程式碼中的 web_request.json