Issue 3363 - Implement IsDocumentWhitelisted and IsElemhideWhitelisted

include/AdblockPlus/FilterEngine.h

 /*
  * This file is part of Adblock Plus <https://adblockplus.org/>,
  * Copyright (C) 2006-2015 Eyeo GmbH
  *
  * Adblock Plus is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 3 as
  * published by the Free Software Foundation.
  *
  * Adblock Plus is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
@@ skipping 281 matching lines @@
      *        structure, e.g. because it is a proxy, it can be approximated
      *        using `ReferrerMapping`.
      * @return Matching filter, or a `null` if there was no match.
      * @throw `std::invalid_argument`, if an invalid `contentType` was supplied.
      */
     FilterPtr Matches(const std::string& url,
         ContentType contentType,
         const std::vector<std::string>& documentUrls) const;
 
     /**
-     * Checks if the supplied URL is whitelisted.
-     * @param url URL to match.
-     * @param documentUrls Chain of documents requesting the resource, starting
-     *        with the current resource's parent frame, ending with the
-     *        top-level frame.
+     * Checks whether the document at the supplied URL is whitelisted.
+     * @param url URL of the document.
+     * @param documentUrls Chain of document URLs requesting the document,
+     *        starting with the current document's parent frame, ending with
+     *        the top-level frame.
      *        If the application is not capable of identifying the frame
      *        structure, e.g. because it is a proxy, it can be approximated
      *        using `ReferrerMapping`.
      * @return `true` if the URL is whitelisted.
-     * @throw `std::invalid_argument`, if an invalid `contentType` was supplied.
      */
     bool IsDocumentWhitelisted(const std::string& url,
         const std::vector<std::string>& documentUrls) const;
 
     /**
-     * Checks if the element hidiing is whitelisted for the supplied URL.
-     * @param url URL to match.
-     * @param documentUrls Chain of documents requesting the resource, starting
-     *        with the current resource's parent frame, ending with the
-     *        top-level frame.
+     * Checks whether element hiding is disabled at the supplied URL.
+     * @param url URL of the document.
+     * @param documentUrls Chain of document URLs requesting the document,
+     *        starting with the current document's parent frame, ending with
+     *        the top-level frame.
      *        If the application is not capable of identifying the frame
      *        structure, e.g. because it is a proxy, it can be approximated
      *        using `ReferrerMapping`.
      * @return `true` if element hiding is whitelisted for the supplied URL.
-     * @throw `std::invalid_argument`, if an invalid `contentType` was supplied.
      */
     bool IsElemhideWhitelisted(const std::string& url,
         const std::vector<std::string>& documentUrls) const;
 
     /**
      * Retrieves CSS selectors for all element hiding filters active on the
      * supplied domain.
      * @param domain Domain to retrieve CSS selectors for.
      * @return List of CSS selectors.
      */
@@ skipping 95 matching lines @@
     void InitDone(JsValueList& params);
     FilterPtr CheckFilterMatch(const std::string& url,
                                ContentType contentType,
                                const std::string& documentUrl) const;
     void UpdateAvailable(UpdateAvailableCallback callback, JsValueList& params);
     void UpdateCheckDone(const std::string& eventName,
                          UpdateCheckDoneCallback callback, JsValueList& params);
     void FilterChanged(FilterChangeCallback callback, JsValueList& params);
     void ShowNotification(const ShowNotificationCallback& callback,
       const JsValueList& params);
-    std::string GetWhitelistingFilter(const std::string& url,
-      const std::string& parent, ContentType contentType) const;
-    std::string GetWhitelistingFilter(const std::string& urlArg,
-      const std::vector<std::string>& documentUrls,
-      ContentType contentType) const;
+    FilterPtr GetWhitelistingFilter(const std::string& url,
+      ContentType contentType, const std::string& documentUrl) const;
+    FilterPtr GetWhitelistingFilter(const std::string& url,
+      ContentType contentType,
+      const std::vector<std::string>& documentUrls) const;
   };
 }
 
 #endif