IAdblockPlusSubscription

General notes

這個介面表示 Adblock Plus 中的一組偏好設定視窗,,它由 IAdblockPlus 回傳。所有的存取動作皆為唯獨。

備註:您不該保持一個對該物件的引用。如果您需要在稍後取得同個條件集的狀態,您應該再次傳送一個請求以便從 IAdblockPlus 取得正確的資訊。

Methods and properties


readonly boolean autoDownload

定義該條件集是否會自動更新。請注意這個屬性對於由外部管理的條件集與特殊群組而言是無意義的。


readonly boolean disabled

定義該條件集是否停用。若該屬性被設為 true 則該條件集的規則將不會生效。


readonly AString downloadStatus

最後一次嘗試下載的結果碼。有下列幾種值:


readonly boolean external

定義該條件集是否由外部管理。若該屬性被設為 true 則該條件集的規則將只會被某些呼叫 IAdblockPlus.updateExternalSubscription 的套件更新。


arrayof wstring getPatterns ( )

索取條件集的規則列表。請注意這個方法將不會對特殊群組回傳任何有用的東西。

Returns:
條件集規則的陣列

readonly long lastDownload

最後一次嘗試下載條件集的時間戳記 (回傳 new Date().getTime() 的值)。該值為 0 表示此條件集從未下載。


readonly AString lastModified

最後一次成功下載時接收的 Last-Modified HTTP 標頭。這個值尚未使用,所以始終留空。


readonly boolean special

定義條件集是否為包含使用者規則的特殊群組。目前有四種特殊群組,意即 fl (一般規則),wl (例外規則),eh (元素隱藏規則) 及 il (無效規則)。


readonly AString title

在偏好設定視窗中檢視的條件集標題


readonly AString url

條件集標示字元。任何由外部管理的條件集及特殊群組都可以是任意的字串,對其他的條件集而言則是它們更新的 URL 。