| OLD | NEW |
| 1 /* | 1 /* |
| 2 * This file is part of Adblock Plus <https://adblockplus.org/>, | 2 * This file is part of Adblock Plus <https://adblockplus.org/>, |
| 3 * Copyright (C) 2006-2016 Eyeo GmbH | 3 * Copyright (C) 2006-2016 Eyeo GmbH |
| 4 * | 4 * |
| 5 * Adblock Plus is free software: you can redistribute it and/or modify | 5 * Adblock Plus is free software: you can redistribute it and/or modify |
| 6 * it under the terms of the GNU General Public License version 3 as | 6 * it under the terms of the GNU General Public License version 3 as |
| 7 * published by the Free Software Foundation. | 7 * published by the Free Software Foundation. |
| 8 * | 8 * |
| 9 * Adblock Plus is distributed in the hope that it will be useful, | 9 * Adblock Plus is distributed in the hope that it will be useful, |
| 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of | 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| (...skipping 132 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 143 * Main component of libadblockplus. | 143 * Main component of libadblockplus. |
| 144 * It handles: | 144 * It handles: |
| 145 * - Filter management and matching. | 145 * - Filter management and matching. |
| 146 * - Subscription management and synchronization. | 146 * - Subscription management and synchronization. |
| 147 * - Update checks for the application. | 147 * - Update checks for the application. |
| 148 */ | 148 */ |
| 149 class FilterEngine | 149 class FilterEngine |
| 150 { | 150 { |
| 151 public: | 151 public: |
| 152 // Make sure to keep ContentType in sync with FilterEngine::contentTypes | 152 // Make sure to keep ContentType in sync with FilterEngine::contentTypes |
| 153 // and with RegExpFilter.typeMap from filterClasses.js. |
| 153 /** | 154 /** |
| 154 * Possible resource content types. | 155 * Possible resource content types. |
| 155 */ | 156 */ |
| 156 enum ContentType {CONTENT_TYPE_OTHER, CONTENT_TYPE_SCRIPT, | 157 enum ContentType |
| 157 CONTENT_TYPE_IMAGE, CONTENT_TYPE_STYLESHEET, | 158 { |
| 158 CONTENT_TYPE_OBJECT, CONTENT_TYPE_SUBDOCUMENT, | 159 CONTENT_TYPE_OTHER = 1, |
| 159 CONTENT_TYPE_DOCUMENT, CONTENT_TYPE_XMLHTTPREQUEST, | 160 CONTENT_TYPE_SCRIPT = 2, |
| 160 CONTENT_TYPE_OBJECT_SUBREQUEST, CONTENT_TYPE_FONT, | 161 CONTENT_TYPE_IMAGE = 4, |
| 161 CONTENT_TYPE_MEDIA, CONTENT_TYPE_ELEMHIDE}; | 162 CONTENT_TYPE_STYLESHEET = 8, |
| 163 CONTENT_TYPE_OBJECT = 16, |
| 164 CONTENT_TYPE_SUBDOCUMENT = 32, |
| 165 CONTENT_TYPE_DOCUMENT = 64, |
| 166 CONTENT_TYPE_PING = 1024, |
| 167 CONTENT_TYPE_XMLHTTPREQUEST = 2048, |
| 168 CONTENT_TYPE_OBJECT_SUBREQUEST = 4096, |
| 169 CONTENT_TYPE_MEDIA = 16384, |
| 170 CONTENT_TYPE_FONT = 32768, |
| 171 CONTENT_TYPE_GENERICBLOCK = 0x20000000, |
| 172 CONTENT_TYPE_ELEMHIDE = 0x40000000, |
| 173 CONTENT_TYPE_GENERICHIDE = 0x80000000 |
| 174 }; |
| 175 |
| 176 /** |
| 177 * Bitmask of `ContentType` values. |
| 178 * The underlying type is signed 32 bit integer because it is actually used |
| 179 * in JavaScript where it is converted into 32 bit signed integer. |
| 180 */ |
| 181 typedef int32_t ContentTypeMask; |
| 162 | 182 |
| 163 /** | 183 /** |
| 164 * Callback type invoked when an update becomes available. | 184 * Callback type invoked when an update becomes available. |
| 165 * The parameter is the download URL of the update. | 185 * The parameter is the download URL of the update. |
| 166 */ | 186 */ |
| 167 typedef std::function<void(const std::string&)> UpdateAvailableCallback; | 187 typedef std::function<void(const std::string&)> UpdateAvailableCallback; |
| 168 | 188 |
| 169 /** | 189 /** |
| 170 * Callback type invoked when a manually triggered update check finishes. | 190 * Callback type invoked when a manually triggered update check finishes. |
| 171 * The parameter is an optional error message. | 191 * The parameter is an optional error message. |
| (...skipping 90 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 262 void SetShowNotificationCallback(const ShowNotificationCallback& value); | 282 void SetShowNotificationCallback(const ShowNotificationCallback& value); |
| 263 | 283 |
| 264 /** | 284 /** |
| 265 * Removes the callback invoked when a notification should be shown. | 285 * Removes the callback invoked when a notification should be shown. |
| 266 */ | 286 */ |
| 267 void RemoveShowNotificationCallback(); | 287 void RemoveShowNotificationCallback(); |
| 268 | 288 |
| 269 /** | 289 /** |
| 270 * Checks if any active filter matches the supplied URL. | 290 * Checks if any active filter matches the supplied URL. |
| 271 * @param url URL to match. | 291 * @param url URL to match. |
| 272 * @param contentType Content type of the requested resource. | 292 * @param contentTypeMask Content type mask of the requested resource. |
| 273 * @param documentUrl URL of the document requesting the resource. | 293 * @param documentUrl URL of the document requesting the resource. |
| 274 * Note that there will be more than one document if frames are | 294 * Note that there will be more than one document if frames are |
| 275 * involved, see | 295 * involved, see |
| 276 * Matches(const std::string&, const std::string&, const std::vector<
std::string>&) const. | 296 * Matches(const std::string&, const std::string&, const std::vector<
std::string>&) const. |
| 277 * @return Matching filter, or `null` if there was no match. | 297 * @return Matching filter, or `null` if there was no match. |
| 278 * @throw `std::invalid_argument`, if an invalid `contentType` was supplied. | 298 * @throw `std::invalid_argument`, if an invalid `contentType` was supplied. |
| 279 */ | 299 */ |
| 280 FilterPtr Matches(const std::string& url, | 300 FilterPtr Matches(const std::string& url, |
| 281 ContentType contentType, | 301 ContentTypeMask contentTypeMask, |
| 282 const std::string& documentUrl) const; | 302 const std::string& documentUrl) const; |
| 283 | 303 |
| 284 /** | 304 /** |
| 285 * Checks if any active filter matches the supplied URL. | 305 * Checks if any active filter matches the supplied URL. |
| 286 * @param url URL to match. | 306 * @param url URL to match. |
| 287 * @param contentType Content type of the requested resource. | 307 * @param contentTypeMask Content type mask of the requested resource. |
| 288 * @param documentUrls Chain of documents requesting the resource, starting | 308 * @param documentUrls Chain of documents requesting the resource, starting |
| 289 * with the current resource's parent frame, ending with the | 309 * with the current resource's parent frame, ending with the |
| 290 * top-level frame. | 310 * top-level frame. |
| 291 * If the application is not capable of identifying the frame | 311 * If the application is not capable of identifying the frame |
| 292 * structure, e.g. because it is a proxy, it can be approximated | 312 * structure, e.g. because it is a proxy, it can be approximated |
| 293 * using `ReferrerMapping`. | 313 * using `ReferrerMapping`. |
| 294 * @return Matching filter, or a `null` if there was no match. | 314 * @return Matching filter, or a `null` if there was no match. |
| 295 * @throw `std::invalid_argument`, if an invalid `contentType` was supplied. | 315 * @throw `std::invalid_argument`, if an invalid `contentType` was supplied. |
| 296 */ | 316 */ |
| 297 FilterPtr Matches(const std::string& url, | 317 FilterPtr Matches(const std::string& url, |
| 298 ContentType contentType, | 318 ContentTypeMask contentTypeMask, |
| 299 const std::vector<std::string>& documentUrls) const; | 319 const std::vector<std::string>& documentUrls) const; |
| 300 | 320 |
| 301 /** | 321 /** |
| 302 * Checks whether the document at the supplied URL is whitelisted. | 322 * Checks whether the document at the supplied URL is whitelisted. |
| 303 * @param url URL of the document. | 323 * @param url URL of the document. |
| 304 * @param documentUrls Chain of document URLs requesting the document, | 324 * @param documentUrls Chain of document URLs requesting the document, |
| 305 * starting with the current document's parent frame, ending with | 325 * starting with the current document's parent frame, ending with |
| 306 * the top-level frame. | 326 * the top-level frame. |
| 307 * If the application is not capable of identifying the frame | 327 * If the application is not capable of identifying the frame |
| 308 * structure, e.g. because it is a proxy, it can be approximated | 328 * structure, e.g. because it is a proxy, it can be approximated |
| (...skipping 113 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 422 | 442 |
| 423 private: | 443 private: |
| 424 JsEnginePtr jsEngine; | 444 JsEnginePtr jsEngine; |
| 425 bool initialized; | 445 bool initialized; |
| 426 bool firstRun; | 446 bool firstRun; |
| 427 int updateCheckId; | 447 int updateCheckId; |
| 428 static const std::map<ContentType, std::string> contentTypes; | 448 static const std::map<ContentType, std::string> contentTypes; |
| 429 | 449 |
| 430 void InitDone(JsValueList& params); | 450 void InitDone(JsValueList& params); |
| 431 FilterPtr CheckFilterMatch(const std::string& url, | 451 FilterPtr CheckFilterMatch(const std::string& url, |
| 432 ContentType contentType, | 452 ContentTypeMask contentTypeMask, |
| 433 const std::string& documentUrl) const; | 453 const std::string& documentUrl) const; |
| 434 void UpdateAvailable(UpdateAvailableCallback callback, JsValueList& params); | 454 void UpdateAvailable(UpdateAvailableCallback callback, JsValueList& params); |
| 435 void UpdateCheckDone(const std::string& eventName, | 455 void UpdateCheckDone(const std::string& eventName, |
| 436 UpdateCheckDoneCallback callback, JsValueList& params); | 456 UpdateCheckDoneCallback callback, JsValueList& params); |
| 437 void FilterChanged(FilterChangeCallback callback, JsValueList& params); | 457 void FilterChanged(FilterChangeCallback callback, JsValueList& params); |
| 438 void ShowNotification(const ShowNotificationCallback& callback, | 458 void ShowNotification(const ShowNotificationCallback& callback, |
| 439 const JsValueList& params); | 459 const JsValueList& params); |
| 440 FilterPtr GetWhitelistingFilter(const std::string& url, | 460 FilterPtr GetWhitelistingFilter(const std::string& url, |
| 441 ContentType contentType, const std::string& documentUrl) const; | 461 ContentTypeMask contentTypeMask, const std::string& documentUrl) const; |
| 442 FilterPtr GetWhitelistingFilter(const std::string& url, | 462 FilterPtr GetWhitelistingFilter(const std::string& url, |
| 443 ContentType contentType, | 463 ContentTypeMask contentTypeMask, |
| 444 const std::vector<std::string>& documentUrls) const; | 464 const std::vector<std::string>& documentUrls) const; |
| 445 }; | 465 }; |
| 446 } | 466 } |
| 447 | 467 |
| 448 #endif | 468 #endif |
| OLD | NEW |