uBlock Origin Lite中header过滤条件的DNR规则转换实现

背景介绍

uBlock Origin Lite作为一款轻量级广告拦截扩展，在MV3环境下需要将传统过滤规则转换为Declarative Net Request(DNR)规则。其中header过滤条件的转换一直是个技术难点，直到最近浏览器开始支持responseHeaders条件后才得以解决。

技术挑战

传统uBlock Origin中的header过滤条件主要面临两个技术难题：

1. 正则表达式兼容性问题：大多数header过滤使用正则表达式，而DNR仅支持简单的通配符模式(*和?)
2. 浏览器支持度问题：responseHeaders条件在早期浏览器版本中未完全实现

解决方案实现

开发者通过以下方式实现了header过滤条件的DNR转换：

1. 语法扩展：使header=语法支持DNR的HeaderInfo规范，包括：

   • • 匹配任意数量字符
   • ? 匹配零或一个字符
   • 支持使用反斜杠转义(*和?)

2. 正则表达式转换：对于简单的正则表达式，自动转换为通配符模式。例如将/pattern-to-match/转换为pattern-to-match

3. 大小写处理：统一将header名称转换为小写，符合HTTP规范并避免重复规则

实际应用案例

以拦截propeller广告为例，转换后的DNR规则如下：

{
  "action": {"type": "block"},
  "condition": {
    "domainType": "thirdParty",
    "regexFilter": "^https?:\\/\\/[a-z]{8,15}\\.com\\/$",
    "requestDomains": ["com"],
    "requestMethods": ["head"],
    "resourceTypes": ["xmlhttprequest"],
    "responseHeaders": [{
      "header": "access-control-expose-headers",
      "values": ["*X-DirectionPartner-Id*"]
    }]
  }
}

兼容性考虑

为确保向后兼容，实现时特别注意了：

1. 旧版本浏览器不支持responseHeaders时的降级处理
2. 保留原有正则表达式支持，仅对简单模式进行自动转换
3. 大小写不敏感匹配以符合HTTP规范

最佳实践建议

开发者建议在日常规则编写中：

1. 尽量使用通配符模式而非正则表达式
2. 明确匹配范围(*前缀/后缀表示包含匹配)
3. 统一使用小写header名称

这项改进显著提升了uBlock Origin Lite在MV3环境下的广告拦截能力，特别是对于依赖header检测的复杂广告网络。通过合理的语法设计和兼容性处理，在保持功能完整性的同时满足了浏览器扩展的新规范要求。