app/src/main/assets/en/guide_requests.html

   1 <!--
   2   Copyright 2018,2020,2022-2023 Soren Stoutner <soren@stoutner.com>.
   3
   4   This file is part of Privacy Browser Android <https://www.stoutner.com/privacy-browser-android>.
   5
   6   Privacy Browser Android is free software: you can redistribute it and/or modify
   7   it under the terms of the GNU General Public License as published by
   8   the Free Software Foundation, either version 3 of the License, or
   9   (at your option) any later version.
  10
  11   Privacy Browser Android is distributed in the hope that it will be useful,
  12   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14   GNU General Public License for more details.
  15
  16   You should have received a copy of the GNU General Public License
  17   along with Privacy Browser Android.  If not, see <http://www.gnu.org/licenses/>. -->
  18
  19 <html>
  20     <head>
  21         <meta charset="UTF-8">
  22
  23         <link rel="stylesheet" href="../css/theme.css">
  24
  25         <!-- Setting the color scheme instructs the WebView to respect `prefers-color-scheme` @media CSS. -->
  26         <meta name="color-scheme" content="light dark">
  27     </head>
  28
  29     <body>
  30         <h3><svg class="header"><use href="../shared_images/local_activity.svg#icon"/></svg> Resource Requests</h3>
  31
  32         <p>When a URL is loaded, it typically makes a number of resource requests for CCS, JavaScript, image, and other files. Details about these requests can be viewed in the Requests activity.
  33             The navigation drawer has a link to the Requests activity and also shows how many requests were blocked. Tapping on a request displays details about why it was allowed or blocked.</p>
  34
  35         <img class="center" src="images/request_details.png"/>
  36
  37         <p>Privacy Browser includes four <a href="https://easylist.to/">common filter lists</a> based on the <a href="https://adblockplus.org/filters">Adblock syntax</a>:
  38             EasyList, EasyPrivacy, Fanboy’s Annoyance List, and Fanboy’s Social Blocking List.
  39             These filter lists are processed by Privacy Browser into the following 22 sublists, which check resource requests in the order listed.</p>
  40
  41         <ol>
  42             <li>Main Allow List</li>
  43             <li>Final Allow List</li>
  44             <li>Domain Allow List</li>
  45             <li>Domain Initial Allow List</li>
  46             <li>Domain Final Allow List</li>
  47             <li>Third-Party Allow List</li>
  48             <li>Third-Party Domain Allow List</li>
  49             <li>Third-Party Domain Initial Allow List</li>
  50             <li>Main Block List</li>
  51             <li>Initial Block List</li>
  52             <li>Final Block List</li>
  53             <li>Domain Block List</li>
  54             <li>Domain Initial Block List</li>
  55             <li>Domain Final Block List</li>
  56             <li>Domain Regular Expression Block List</li>
  57             <li>Third-Party Block List</li>
  58             <li>Third-Party Initial Block List</li>
  59             <li>Third-Party Domain Block List</li>
  60             <li>Third-Party Domain Initial Block List</li>
  61             <li>Third-Party Regular Expression Block List</li>
  62             <li>Third-Party Domain Regular Expression Block List</li>
  63             <li>Regular Expression Block List</li>
  64         </ol>
  65
  66         <p>Initial lists check against the beginning of the URL. Final lists check against the end of the URL. Domain lists only check against certain domains.
  67             Third-party lists only apply if the root domain of the request is different than the root domain of the main URL.
  68             Regular expression lists follow the <a href="https://en.wikipedia.org/wiki/Regular_expression">regular expression syntax</a>. Each sublist item has one or more entry.
  69             In the case of domain sublists, the resource request is only checked against the item if the first entry matches the domain of the main URL.</p>
  70
  71         <p>Because of limitations in Android’s WebView, and to speed up processing of requests, Privacy Browser implements a simplified interpretation of the Adblock syntax.
  72             This can sometimes lead to false positives, where resources are allowed or blocked in ways that weren’t intended by the original entry.
  73             A more detailed description of how the filter list entries are processed is available at <a href="https://www.stoutner.com/privacy-browser-android/filter-lists/">stoutner.com</a>.</p>
  74
  75         <p>Privacy Browser has three additional filter lists.
  76             <a href="https://www.stoutner.com/privacy-browser-android/filter-lists/ultralist/">UltraList</a> and
  77             <a href="https://www.stoutner.com/privacy-browser-android/filter-lists/ultraprivacy/">UltraPrivacy</a>
  78             filters ads and trackers that EasyList and EasyPrivacy do not. The third blocks all third-party requests.
  79             A request is only considered third-party if the base domain of the request is different than the base domain of the URL.
  80             For example, if <code>www.website.com</code> loads a picture from <code>images.website.com</code>,
  81             this is not blocked as a third-party request because they both share the same base domain of <code>website.com</code>.
  82             Blocking all third-party requests increases privacy, but this filter list is disabled by default because it breaks a large number of websites.</p>
  83     </body>
  84 </html>