mirror of
https://github.com/gorhill/uBlock.git
synced 2024-07-01 02:02:29 +02:00
Expression picker, alt text for images
gwarser
parent
220550faa0
commit
77cdbbd102
|
|
@ -4,11 +4,11 @@ The logger is the tool of choice to see, understand, diagnose and fix the functi
|
|||
|
||||
To access the logger, click on the _list_ icon of uBlock Origin's popup UI:
|
||||
|
||||
|
||||
|
||||
|
||||
The request logger will open in a new tab (which was moved to its own window below):
|
||||
|
||||
|
||||
|
||||
|
||||
The color of a row hints at how the resource was filtered:
|
||||
- No color: The request for the resource was allowed to go through because it matched no filter/rule.
|
||||
|
|
@ -52,7 +52,7 @@ Hold the <kbd>Shift</kbd> key while clicking the "Open the logger" icon to toggl
|
|||
|
||||
#### Page selector
|
||||
|
||||
|
||||
|
||||
|
||||
The drop-down selector is to display log entries which are related to a specific page. This will hide from view all log entries which are not related to the selected page. By selecting _All_ again, all log entries will be displayed again.
|
||||
|
||||
|
|
@ -62,7 +62,7 @@ Note in the figure above the entry named _"Tabless"_: selecting this entry allow
|
|||
|
||||
#### Reload
|
||||
|
||||
|
||||
|
||||
|
||||
The big reload button aside the page selector is to force a reload of the content of the selected page. This button is enabled only for when a specific page is selected.
|
||||
|
||||
|
|
@ -70,7 +70,7 @@ The big reload button aside the page selector is to force a reload of the conten
|
|||
|
||||
#### Dom inspector
|
||||
|
||||
|
||||
|
||||
|
||||
Complementary tool to the element picker.
|
||||
|
||||
|
|
@ -80,7 +80,7 @@ Please read more on dedicated page: ["DOM inspector"](./DOM-inspector)
|
|||
|
||||
#### Accessing popup UI of a specific page
|
||||
|
||||
|
||||
|
||||
|
||||
By clicking this button you can access the popup UI of a specific tab.
|
||||
|
||||
|
|
@ -88,7 +88,7 @@ By clicking this button you can access the popup UI of a specific tab.
|
|||
|
||||
#### Expand
|
||||
|
||||
|
||||
|
||||
|
||||
By default log entries in the logger are collapsed so as to take no more than one line. Some log entries however might be truncated as a result. This button is to force all those entries with truncated extraneous information to be fully visible.
|
||||
|
||||
|
|
@ -96,7 +96,7 @@ By default log entries in the logger are collapsed so as to take no more than on
|
|||
|
||||
#### Void log entries
|
||||
|
||||
|
||||
|
||||
|
||||
With "All" selected in "Page selector" if you close a tab for which there are entries in the logger, these entries will be marked as _void_, i.e. they will be faded out, to indicate the tab for these entries does not exist anymore.
|
||||
|
||||
|
|
@ -106,7 +106,7 @@ The `X` button in the toolbar allows you to remove those void entries from the l
|
|||
|
||||
#### Clear
|
||||
|
||||
|
||||
|
||||
|
||||
This is to clear the logger, to remove all entries from the selected/filtered context (Ars Technica tab in this example).
|
||||
|
||||
|
|
@ -114,17 +114,25 @@ This is to clear the logger, to remove all entries from the selected/filtered co
|
|||
|
||||
#### Pause the logger
|
||||
|
||||
|
||||
|
||||
TODO
|
||||
|
||||
|
||||
***
|
||||
|
||||
#### Filtering the logger output
|
||||
|
||||
|
||||
|
||||
|
||||
You can visually filter entries in the logger using filter expressions. Log entries which do not match _all_ filter expressions will be hidden from view. Syntax for a filter expression:
|
||||
You can visually filter entries in the logger using filter expressions. Expressions can be chosen from expression picker, available by hovering mouse cursor over filter input box. Log entries which do not match _all_ filter expressions will be hidden from view.
|
||||
|
||||
|
||||
|
||||
Clicking on arrow in the filtering input box deactivates expression picker.
|
||||
|
||||
|
||||
|
||||
Funnel icon toggles on/off current filter expression.
|
||||
|
||||
Filter can also be entered manually. Supported sytax:
|
||||
|
||||
- Enter `foo` to only show entries which have a string `foo`.
|
||||
- Enter `|foo` to only show entries which have a field starting with `foo`.
|
||||
|
|
@ -140,7 +148,7 @@ You can visually filter entries in the logger using filter expressions. Log entr
|
|||
- `xhr || other |http:` means display entries which match either `xhr` or `other` and have a field which starts with `http:`.
|
||||
- `!css || image` means display entries which do not match either `css` or `images` (equivalent to `!css !image` really).
|
||||
- Warning: With _or_'ed expressions, the _not_ (`!`) operator can only apply to the resulting _or_'ed expression.
|
||||
- A special keyword can be used to filter behind-the-scene requests: `bts`, or `|bts` for a stricter filtering.
|
||||
- Enclose expression in slash `/` characters to treat it as Regular Expression.
|
||||
|
||||
Examples:
|
||||
|
||||
|
|
@ -164,9 +172,9 @@ This is useful to be sure the logger does not unduly consume a huge amount of me
|
|||
|
||||
You can find out from which filter list(s) a static filter originates, by simply clicking on it:
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
When the filter list is rendered as a link, clicking on it will bring you to the support site for that list.
|
||||
|
||||
|
|
@ -174,7 +182,7 @@ When the filter list is rendered as a link, clicking on it will bring you to the
|
|||
|
||||
#### Creating filters
|
||||
|
||||
|
||||
|
||||
|
||||
Clicking on the 4th cell of a log entry will give you access to the filtering tools dialog (modal), from where you can easily create dynamic URL filtering rules or just standard static filters, and launch the element picker.
|
||||
|
||||
|
|
@ -182,7 +190,7 @@ Clicking on the 4th cell of a log entry will give you access to the filtering to
|
|||
|
||||
##### Dynamic URL filtering rules
|
||||
|
||||
|
||||
|
||||
|
||||
Point-and-click to create dynamic URL filtering rules. These rules are temporary by default, you need to click the padlock if you want them to be permanent. Useful to find out which network requests need to be blocked or allowed on a page in order, to fix a broken page, or to further block more useless resources from a page.
|
||||
|
||||
|
|
@ -192,7 +200,7 @@ See [_"Overview of uBlock's network filtering engine: details"_](./Overview-of-u
|
|||
|
||||
##### Static network filters
|
||||
|
||||
|
||||
|
||||
|
||||
This dialog will assist you in creating static filters compatible with [ABP filter syntax](https://adblockplus.org/filter-cheatsheet). Note that creating static filters incur a significant overhead relative to dynamic URL filtering rules. Typically, you will first use dynamic URL filtering rules to quickly diagnose which network requests need to be allowed/blocked.
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user