Skip to content

记录台

fang5566 edited this page Aug 29, 2019 · 35 revisions

uBlock Origin 附带了一个记录台,用户可以在此查看 uBlock 对网络请求和 DOM 元素所进行的操作、它们是否被屏蔽或允许,以及与之相匹配的过滤规则。这个记录台是 统一 的,意味着它会显示 uBlock 里所发生的 一切

你可以选择使用记录台来查看、了解、诊断和修复 uBlock 的各项功能。

点击 uBlock Origin 弹出界面中的 列表 图标即可进入网络请求记录台:

列表图标

网络请求记录台会在新标签页中(即整合到自己的窗口当中)打开:

记录台窗口

上图中某行的颜色可以提示你资源是如何过滤的:

  • 无颜色:该资源的请求未匹配任何规则,故已被放行。
  • 红色:该资源的请求有与之匹配的规则,故已被取消 (--)。
  • 绿色:该资源的请求有与之匹配的规则,且这条规则是用于忽略请求所匹配到的屏蔽规则,故已被放行 (++) 。
  • 黄色:
    • 被修饰规则屏蔽的 DOM 元素;
    • 或已屏蔽的该资源的请求被重定向 (<<) 到了一个本地替代资源。
    • 页面插入了一个 defuser 小脚本 (+js(...))

几个特殊列的说明:

  1. 事件的时间
  2. 对于屏蔽/允许/隐藏了的资源,该列会包含对应的过滤规则。对于重定向的资源,则会显示本地资源以替代屏蔽了的网络请求。
  3. uBlock Origin 所执行的操作:
    • -- 请求已被屏蔽
    • ++ 已被例外规则允许
    • << 已重定向到中立资源
  4. 规则估算对应的上下文标识符(即域名)
  5. 与主文档有关的网络请求属于 第几方_,及可选的,逗号之后,与嵌入的子文档有关的请求属于第几方
    • 1 是第一方请求
    • 3 是第三方请求
    • 0tabless(非标签页相关) 的请求(即后台请求)
  6. 请求的类型
  7. 生效规则对应的资源地址

时间、规则、上下文和第几方这几列可在设置窗口里隐藏。

请注意 uBlock Origin 的记录台是一个前视型记录台,它只记录打开以后才出现的请求。

从运行效率的角度出发,当且仅当 uBO 打开了记录台,它才会记录日志。否则 uBO 不会消耗任何 CPU 或内存资源。

提示

点击“打开控制台”图标的同时按住 Shift 键可以切换选择在新窗口或新标签页打开记录台。uBO 会记住你上次未按住 Shift 键时记录台打开的状态。



组成部分


页面选择菜单

页面选择下拉菜单

上图中的下拉菜单是用来显示与某个特定页面有关的日志记录条目,同时隐藏所有无关页面的条目。如果你选择 全部 这项,所有日志记录条目又会重新显示出来。

请注意上图名为 "Tabless" 的菜单项:选中这项允许你查看与标签页无关的网络请求,即记录台里那些有字体阴影效果并且“上下文”列(第五列)显示为 “0” 的请求。


重新载入

重新载入按钮

页面选择菜单旁的重新载入按钮是用来强制重新载入所选择的页面,只有特定的某个页面被选中的情况下这个按钮才可以使用。


DOM 查看器

代码图标

这是用于补充元素选择器功能的工具。

更多内容请查阅对应的页面:“DOM 查看器”


打开特定页面的弹出界面

uBO 图标

你可以点击该按钮打开特定页面的弹出界面。


展开

向下箭头图标

记录台的日志记录条目默认是折叠起来的,每条记录最多显示为一行,但有可能部分条目的信息因此而被截断。点击这个按钮可以垂直展开所有条目为多行(可在设置窗口设置,默认为 4)以便更好显示。


作废的记录条目

x 图标

当你在页面选择菜单里面选择“全部”时,如果你关闭了日志记录条目对应的标签页,那么这些条目会被标记为 作废,即淡出显示,表示这些条目对应的标签页已不存在。

点击工具栏上的 X 按钮将从记录台删除这些作废的条目。


清除

橡皮擦图标

点击按钮后将清空记录台并从选中或过滤出的上下文(本例中的 Ars Technica 标签页)中删除所有条目。

无标签页 的请求(淡出显示)可能也会显示在该页面的日志记录里。要清除此类条目,可以再次点击“清除”图标。


暂停记录

暂停按钮


筛选显示日志记录

选择筛选表达式的下拉界面

你可以使用筛选表达式可视化筛选要显示的日志条目。鼠标指针悬停在筛选输入框时会显示一个表达式选择界面,你可以在此选择筛选表达式。与 全部 这条筛选表达式不匹配的条目将被隐藏。

选择筛选表达式的向上箭头

点击筛选输入框的箭头可隐藏表达式选择界面。

漏斗图标

点击漏斗图标可启用或禁用当前的筛选表达式。

筛选条件也可以手动输入,支持的语法包括:

  • 输入 foo 只显示包含 foo 字符串的条目。
  • 输入 |foo 只显示包含以 foo 打头的字符串的条目。
    • 提示:使用 |-- 则只显示被屏蔽的条目(-- 大多数情况下都可以正常使用,有时会出现错误的匹配条目)。
  • 输入 foo| 只显示包含以 foo 结尾的字符串的条目。
  • 输入 |foo| 只显示精确匹配 foo 字符串的条目。
  • 在任意表达式前面加上 ! 表示与该表达式相反的意思。
    • !foo 表示只显示不包含 foo 字符串的条目。
    • !|-- 表示只显示被屏蔽的条目。
  • 如果有一条以上过滤表达式出现,则默认表达式之间在逻辑上是 并且 的意思。
  • 你也可以在多条表达式之间表示 或者 的意思:
    • css || image 表示显示精确匹配 cssimage 的条目。
    • xhr || other |http: 表示显示精确匹配 xhr 或者 other,并且还要以 http: 打头的条目。
    • !css || image 表示显示不精确匹配 cssimages 的条目(实际上等同于 !css !image)。
    • 警告:对于表示 或者 的表达式,(!) 这个操作符只表示与整个 或者 表达式最后结果相反的意思。
  • 嵌套在 / 符号里的表达式会被视作正则表达式。

请看下面一些例子:

  • !|-- facebook:只显示包含 facebook 字符串的非屏蔽条目。
  • |xhr google:只显示包含 google 字符串的 XMLHttpRequest 类型条目。
  • !|image !|css:只显示既不是 image 类型,也不是 css 类型的条目。

过滤规则统计

图表图标

目前实现的是报告所有静态过滤规则的统计信息,我有意最大程度限制统计功能,所以请勿提交此类的 issue。新功能还开开发中,会比较慢,也要经过深思熟虑,而且还得时间允许。

暂停记录不会停止手机过滤规则命中数统计,所以我们可以暂停记录输出来减少日志记录的开销,而不会损失收集到的规则命中数。


导出窗口

剪贴板图标

导出窗口

该功能可便于导出日志记录到系统剪贴板,日志格式兼容各种讨论帖要求的格式。


设置窗口

齿轮图标

设置窗口


查找静态规则所属的规则列表

只要点击一下(或其他任意高亮的列),你就可以找到某条静态规则所属的规则列表:

鼠标移到活动列的日志记录

过滤规则详细信息窗口

  • 点击规则列表名可查看该列表的内容。
  • 点击列表名旁的主页图标可打开该列表的支持网站。

创建过滤规则

鼠标移到活动列的日志记录

点击日志记录的高亮单元格可以打开过滤工具模态窗口,在此你可以轻松创建动态 URL 过滤规则或标准静态规则。


动态 URL 过滤规则

详细信息窗口里的 URL 规则标签页

你可以通过鼠标指向并点击来创建动态 URL 过滤规则。这些规则默认是临时规则,如果你想把它们变为永久规则,你需要点击左上角的挂锁图标。这项功能适用于查找有哪些网络规则需要被屏蔽或允许以便于修复受损的页面,或进一步屏蔽页面当中更多无用的资源。

更多关于动态 URL过滤与整个过滤引擎关系的信息,参见"uBlock 网络过滤引擎详细说明 "


静态网络规则

详细窗口里的静态过滤规则标签页

这个窗口可以辅助你创建与 ABP 规则语法兼容的静态过滤规则。请注意相比创建动态 URL 过滤规则,创建静态过滤规则要花费很大的开销。

更多关于静态过滤与整个过滤引擎关系的信息,参见"uBlock 网络过滤引擎详细说明 "

Clone this wiki locally