diff -r 9f7bbfd6545d -r ed511d6b2547 Documentation/Source/eric6.WebBrowser.Network.NetworkUrlInterceptor.html --- a/Documentation/Source/eric6.WebBrowser.Network.NetworkUrlInterceptor.html Thu May 10 18:42:17 2018 +0200 +++ b/Documentation/Source/eric6.WebBrowser.Network.NetworkUrlInterceptor.html Thu May 10 18:44:19 2018 +0200 @@ -64,6 +64,21 @@ <td><a href="#NetworkUrlInterceptor.__loadSettings">__loadSettings</a></td> <td>Private method to load the Network Manager settings.</td> </tr><tr> +<td><a href="#NetworkUrlInterceptor.__potentiallyTrustworthy">__potentiallyTrustworthy</a></td> +<td>Private method to check, if the given URL is potentially trustworthy.</td> +</tr><tr> +<td><a href="#NetworkUrlInterceptor.__refererOrigin">__refererOrigin</a></td> +<td>Private method to generate an origin referer header URL.</td> +</tr><tr> +<td><a href="#NetworkUrlInterceptor.__sameOrigin">__sameOrigin</a></td> +<td>Private method to test the "same origin" policy.</td> +</tr><tr> +<td><a href="#NetworkUrlInterceptor.__setRefererHeader">__setRefererHeader</a></td> +<td>Private method to set the 'Referer' header depending on the configured rule set.</td> +</tr><tr> +<td><a href="#NetworkUrlInterceptor.__trimmedReferer">__trimmedReferer</a></td> +<td>Private method to generate the trimmed referer header URL.</td> +</tr><tr> <td><a href="#NetworkUrlInterceptor.installUrlInterceptor">installUrlInterceptor</a></td> <td>Public method to install an URL interceptor.</td> </tr><tr> @@ -96,7 +111,109 @@ <b>__loadSettings</b>(<i></i>) <p> Private method to load the Network Manager settings. -</p><a NAME="NetworkUrlInterceptor.installUrlInterceptor" ID="NetworkUrlInterceptor.installUrlInterceptor"></a> +</p><a NAME="NetworkUrlInterceptor.__potentiallyTrustworthy" ID="NetworkUrlInterceptor.__potentiallyTrustworthy"></a> +<h4>NetworkUrlInterceptor.__potentiallyTrustworthy</h4> +<b>__potentiallyTrustworthy</b>(<i>url</i>) +<p> + Private method to check, if the given URL is potentially trustworthy. +</p><dl> +<dt><i>url</i> (QUrl)</dt> +<dd> +URL to be checked +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating a potentially trustworthy URL +</dd> +</dl><dl> +<dt>Return Type:</dt> +<dd> +bool +</dd> +</dl><a NAME="NetworkUrlInterceptor.__refererOrigin" ID="NetworkUrlInterceptor.__refererOrigin"></a> +<h4>NetworkUrlInterceptor.__refererOrigin</h4> +<b>__refererOrigin</b>(<i>url</i>) +<p> + Private method to generate an origin referer header URL. +</p><dl> +<dt><i>url</i> (QUrl)</dt> +<dd> +URL to generate the header from +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +origin referer header URL +</dd> +</dl><dl> +<dt>Return Type:</dt> +<dd> +QByteArray or bytes +</dd> +</dl><a NAME="NetworkUrlInterceptor.__sameOrigin" ID="NetworkUrlInterceptor.__sameOrigin"></a> +<h4>NetworkUrlInterceptor.__sameOrigin</h4> +<b>__sameOrigin</b>(<i>url1, url2</i>) +<p> + Private method to test the "same origin" policy. +</p><dl> +<dt><i>url1</i> (QUrl)</dt> +<dd> +first URL for the test +</dd><dt><i>url2</i> (QUrl)</dt> +<dd> +second URL for the test +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +flag indicating that both URLs have the same origin +</dd> +</dl><dl> +<dt>Return Type:</dt> +<dd> +bool +</dd> +</dl><a NAME="NetworkUrlInterceptor.__setRefererHeader" ID="NetworkUrlInterceptor.__setRefererHeader"></a> +<h4>NetworkUrlInterceptor.__setRefererHeader</h4> +<b>__setRefererHeader</b>(<i>info</i>) +<p> + Private method to set the 'Referer' header depending on the configured + rule set. +</p><dl> +<dt><i>info</i> (QWebEngineUrlRequestInfo)</dt> +<dd> +URL request information +</dd> +</dl><dl> +<dt><b>See Also:</b></dt> +<dd> +<a href="https://wiki.mozilla.org/Security/Referrer"> Mozilla Referrer</a> +</dd> +<dd> +<a href="https://www.w3.org/TR/referrer-policy/"> W3C Referrer Policy</a> +</dd> +</dl><a NAME="NetworkUrlInterceptor.__trimmedReferer" ID="NetworkUrlInterceptor.__trimmedReferer"></a> +<h4>NetworkUrlInterceptor.__trimmedReferer</h4> +<b>__trimmedReferer</b>(<i>url</i>) +<p> + Private method to generate the trimmed referer header URL. +</p><dl> +<dt><i>url</i> (QUrl)</dt> +<dd> +URL to be trimmed as a referer header +</dd> +</dl><dl> +<dt>Returns:</dt> +<dd> +trimmed referer header URL +</dd> +</dl><dl> +<dt>Return Type:</dt> +<dd> +QByteArray or bytes +</dd> +</dl><a NAME="NetworkUrlInterceptor.installUrlInterceptor" ID="NetworkUrlInterceptor.installUrlInterceptor"></a> <h4>NetworkUrlInterceptor.installUrlInterceptor</h4> <b>installUrlInterceptor</b>(<i>interceptor</i>) <p>