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

最近一次成功下载时接收到的 HTTP 标头的 Last-Modified 属性值。这个值目前尚未使用,因此始终留空。


readonly boolean special

用来表示订阅是否属于一个包含用户自定义规则的特殊分组。目前支持四类的特殊分组,它们是 fl(普通规则)、wl(例外规则)、eh(元素隐藏规则)以及 il(无效规则)。


readonly AString title

在首选项对话框中显示的订阅列表标题


readonly AString url

订阅标识符。对于外部管理的订阅以及特殊分组这个标识符可以是任意字符串,而对于其他订阅这个标识符表示其更新的 URL。