Source code
Revision control
Copy as Markdown
Other Tools
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
#include "nsISupports.idl"
#include "nsIURI.idl"
/**
* nsIURLQueryStringStripper is responsible for stripping certain part of the
* query string of the given URI to address the bounce(redirect) tracking
* issues. It will strip every query parameter which matches the strip list
* defined in the pref 'privacy.query_stripping.strip_list'. Note that It's
* different from URLDecorationStripper which strips the entire query string
* from the referrer if there is a tracking query parameter present in the URI.
*
* TODO: Given that nsIURLQueryStringStripper and URLDecorationStripper are
* doing similar things. We could somehow combine these two modules into
* one. We will improve this in the future.
*/
[scriptable, uuid(6b42a890-2624-4560-99c4-b25380e8cd77)]
interface nsIURLQueryStringStripper : nsISupports {
// Strip the query parameters that are in the strip list. Return the amount of
// query parameters that have been stripped. Returns 0 if no query parameters
// have been stripped or the feature is disabled.
uint32_t strip(in nsIURI aURI, in boolean aIsPBM, out nsIURI aOutput);
// Strip the query parameters that are in the stripForCopy/Share strip list.
// Returns ether the stripped URI or null if no query parameters have been stripped
// Thorws NS_ERROR_NOT_AVAILABLE if the feature is disabled.
[must_use] nsIURI stripForCopyOrShare(in nsIURI aURI);
// Checks if there is any query parameter that can be stripped
// using Strip on share. Returns false if no query parameter that
// can be stripped
boolean canStripForShare(in nsIURI aURI);
// Test-only method to get the current strip list.
ACString testGetStripList();
};