IAdblockPlusSubscription

General notes

这个接口代表 Adblock Plus 首选项对话框中一个从 IAdblockPlus 返回的分组。对于这个接口的所有接入都是只读的。

注意：请勿保持一个指向该对象的引用。如果您需要在以后的某个时刻获取这个订阅列表的状态，请重新请求 IAdblockPlus 获取正确的信息。

readonly AString url

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

readonly boolean special

用来表示订阅是否属于一个包含用户自定义规则的特殊分组。目前支持四类的特殊分组，它们是 _fl（普通规则）、_wl（例外规则）、_eh（元素隐藏规则）以及 _il（无效规则）。

readonly AString title

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

readonly boolean autoDownload

用来表示订阅是否会自动更新。请注意对于外部管理的订阅以及特殊分组，这个属性无实际意义。

readonly boolean disabled

用来表示订阅是否已禁用。如果将这个属性设为 true，则所有订阅的过滤规则都无法生效。

readonly boolean external

用来表示是否是一个外部管理的订阅。如果将这个属性设为 true，则只有某个扩展调用 IAdblockPlus.updateExternalSubscription 后才能更新这个订阅。

readonly long lastDownload

表示最近一次尝试下载订阅的时间戳（返回的格式为new Date().getTime()）。值为 0 表示该订阅从未下载。

readonly AString downloadStatus

最近一次尝试下载的结果代码，主要有以下几个值：

readonly AString lastModified

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

arrayof wstring getPatterns ( )

获取一个订阅列表中的过滤规则。请注意这个类函数所返回的内容不适用于特殊分组。