Skip to content

Commit

Permalink
Update create-own-filters.md
Browse files Browse the repository at this point in the history
Added description for supported aliases #207
  • Loading branch information
SeverAnna committed Aug 16, 2023
1 parent 462f3d7 commit 57d07e7
Showing 1 changed file with 48 additions and 0 deletions.
48 changes: 48 additions & 0 deletions docs/general/ad-filtering/create-own-filters.md
Original file line number Diff line number Diff line change
Expand Up @@ -530,6 +530,12 @@ AdGuard will try to close the browser tab with any address that matches a blocki

#### **`$third-party`** {#third-party-modifier}

:::note

The `$3p` alias is also used.

:::

A restriction of third-party and own requests. A third-party request is a request from a different domain. For example, a request to `example.org` from `domain.com` is a third-party request.

:::note
Expand Down Expand Up @@ -612,6 +618,12 @@ There is a big difference in how AdGuard determines the content type on differen

#### **`$document`** {#document-modifier}

:::note

The `$doc` alias is also used.

:::

The rule corresponds to the main frame document requests, i.e. HTML documents that are loaded in the browser tab. It does not match iframes, there is a [`$subdocument` modifier](#subdocument-modifier) for these.

By default, AdGuard does not block the requests that are loaded in the browser tab (e.g. "main frame bypass"). The idea is not to prevent pages from loading as the user clearly indicated that they want this page to be loaded. However, if the `$document` modifier is specified explicitly, AdGuard does not use that logic and prevents the page load. Instead, it responds with a "blocking page".
Expand Down Expand Up @@ -663,10 +675,22 @@ The rule corresponds to script requests, e.g. javascript, vbscript.

#### **`$stylesheet`** {#stylesheet-modifier}

:::note

The `$css` alias is also used.

:::

The rule corresponds to CSS files requests.

#### **`$subdocument`** {#subdocument-modifier}

:::note

The `$frame` alias is also used.

:::

The rule corresponds to requests for built-in pages — HTML tags `frame` and `iframe`.

**Examples**
Expand All @@ -686,6 +710,12 @@ The rule applies only to WebSocket connections.

#### **`$xmlhttprequest`** {#xmlhttprequest-modifier}

:::note

The `$xhr` alias is also used.

:::

The rule applies only to ajax requests (requests sent via javascript object `XMLHttpRequest`).

:::info Compatibility
Expand Down Expand Up @@ -750,6 +780,12 @@ Disables [HTML filtering](#html-filtering-rules), [`$hls`](#hls-modifier), [`$re

#### **`$elemhide`** {#elemhide-modifier}

:::note

The `$ehide` alias is also used.

:::

Disables any [cosmetic rules](#cosmetic-rules) on the pages matching the rule.

**Examples**
Expand Down Expand Up @@ -901,6 +937,12 @@ Disables generic basic rules on pages that correspond to exception rule.

#### **`$generichide`** {#generichide-modifier}

:::note

The `$ghide` alias is also used.

:::

Disables all generic [cosmetic rules](#cosmetic-rules) on pages that correspond to the exception rule.

**Examples**
Expand All @@ -909,6 +951,12 @@ Disables all generic [cosmetic rules](#cosmetic-rules) on pages that correspond

#### **`specifichide`** {#specifichide-modifier}

:::note

The `$shide` alias is also used.

:::

Disables all specific element hiding and CSS rules, but not general ones. Has an opposite effect to [`$generichide`](#generichide-modifier).

**Examples**
Expand Down

0 comments on commit 57d07e7

Please sign in to comment.