eric7/Documentation/Source/eric7.WebBrowser.CookieJar.CookieJar.html

branch
eric7
changeset 8372
e0227a7c850e
child 8596
d64760b2da50
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/eric7/Documentation/Source/eric7.WebBrowser.CookieJar.CookieJar.html	Mon May 24 11:19:57 2021 +0200
@@ -0,0 +1,604 @@
+<!DOCTYPE html>
+<html><head>
+<title>eric7.WebBrowser.CookieJar.CookieJar</title>
+<meta charset="UTF-8">
+<style>
+body {
+    background: #EDECE6;
+    margin: 0em 1em 10em 1em;
+    color: black;
+}
+
+h1 { color: white; background: #85774A; }
+h2 { color: white; background: #85774A; }
+h3 { color: white; background: #9D936E; }
+h4 { color: white; background: #9D936E; }
+    
+a { color: #BA6D36; }
+
+</style>
+</head>
+<body>
+<a NAME="top" ID="top"></a>
+<h1>eric7.WebBrowser.CookieJar.CookieJar</h1>
+
+<p>
+Module implementing a QNetworkCookieJar subclass with various accept policies.
+</p>
+<h3>Global Attributes</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Classes</h3>
+
+<table>
+
+<tr>
+<td><a href="#CookieJar">CookieJar</a></td>
+<td>Class implementing a QNetworkCookieJar subclass with various accept policies.</td>
+</tr>
+</table>
+<h3>Functions</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<hr />
+<hr />
+<a NAME="CookieJar" ID="CookieJar"></a>
+<h2>CookieJar</h2>
+
+<p>
+    Class implementing a QNetworkCookieJar subclass with various accept
+    policies.
+</p>
+<h3>Signals</h3>
+<dl>
+
+<dt>cookiesChanged()</dt>
+<dd>
+emitted after the cookies have been changed
+</dd>
+</dl>
+<h3>Derived from</h3>
+QNetworkCookieJar
+<h3>Class Attributes</h3>
+
+<table>
+<tr><td>AcceptAlways</td></tr><tr><td>AcceptMax</td></tr><tr><td>AcceptNever</td></tr><tr><td>AcceptOnlyFromSitesNavigatedTo</td></tr><tr><td>Allow</td></tr><tr><td>AllowForSession</td></tr><tr><td>Block</td></tr><tr><td>KeepMax</td></tr><tr><td>KeepUntilExit</td></tr><tr><td>KeepUntilExpire</td></tr>
+</table>
+<h3>Class Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+<h3>Methods</h3>
+
+<table>
+
+<tr>
+<td><a href="#CookieJar.__init__">CookieJar</a></td>
+<td>Constructor</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.__cookieAdded">__cookieAdded</a></td>
+<td>Private slot handling the addition of a cookie.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.__cookieFilter">__cookieFilter</a></td>
+<td>Private method to filter cookies.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.__cookieRemoved">__cookieRemoved</a></td>
+<td>Private slot handling the removal of a cookie.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.__isOnDomainList">__isOnDomainList</a></td>
+<td>Private method to check, if either the rule matches the domain exactly or the domain ends with ".rule".</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.__load">__load</a></td>
+<td>Private method to load the cookies settings.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.__matchDomain">__matchDomain</a></td>
+<td>Private method to check, if a URLs host matches a cookie domain according to RFC 6265.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.__rejectCookie">__rejectCookie</a></td>
+<td>Private method to test, if a cookie shall be rejected.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.__save">__save</a></td>
+<td>Private method to save the cookies settings.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.acceptPolicy">acceptPolicy</a></td>
+<td>Public method to get the accept policy.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.allowForSessionCookies">allowForSessionCookies</a></td>
+<td>Public method to return the list of allowed session cookie domains.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.allowedCookies">allowedCookies</a></td>
+<td>Public method to return the list of allowed domains.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.blockedCookies">blockedCookies</a></td>
+<td>Public method to return the list of blocked domains.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.clear">clear</a></td>
+<td>Public method to clear all cookies.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.close">close</a></td>
+<td>Public slot to close the cookie jar.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.cookieDomains">cookieDomains</a></td>
+<td>Public method to get a list of all domains used by the cookies.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.cookies">cookies</a></td>
+<td>Public method to get the cookies of the cookie jar.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.filterTrackingCookies">filterTrackingCookies</a></td>
+<td>Public method to get the filter tracking cookies flag.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.keepPolicy">keepPolicy</a></td>
+<td>Public method to get the keep policy.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.removeCookie">removeCookie</a></td>
+<td>Public method to remove a cookie.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.removeCookies">removeCookies</a></td>
+<td>Public method to remove a list of cookies.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.setAcceptPolicy">setAcceptPolicy</a></td>
+<td>Public method to set the accept policy.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.setAllowForSessionCookies">setAllowForSessionCookies</a></td>
+<td>Public method to set the list of allowed session cookie domains.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.setAllowedCookies">setAllowedCookies</a></td>
+<td>Public method to set the list of allowed domains.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.setBlockedCookies">setBlockedCookies</a></td>
+<td>Public method to set the list of blocked domains.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.setFilterTrackingCookies">setFilterTrackingCookies</a></td>
+<td>Public method to set the filter tracking cookies flag.</td>
+</tr>
+<tr>
+<td><a href="#CookieJar.setKeepPolicy">setKeepPolicy</a></td>
+<td>Public method to set the keep policy.</td>
+</tr>
+</table>
+<h3>Static Methods</h3>
+
+<table>
+<tr><td>None</td></tr>
+</table>
+
+<a NAME="CookieJar.__init__" ID="CookieJar.__init__"></a>
+<h4>CookieJar (Constructor)</h4>
+<b>CookieJar</b>(<i>parent=None</i>)
+
+<p>
+        Constructor
+</p>
+<dl>
+
+<dt><i>parent</i></dt>
+<dd>
+reference to the parent object (QObject)
+</dd>
+</dl>
+<a NAME="CookieJar.__cookieAdded" ID="CookieJar.__cookieAdded"></a>
+<h4>CookieJar.__cookieAdded</h4>
+<b>__cookieAdded</b>(<i>cookie</i>)
+
+<p>
+        Private slot handling the addition of a cookie.
+</p>
+<dl>
+
+<dt><i>cookie</i> (QNetworkCookie)</dt>
+<dd>
+cookie which was added
+</dd>
+</dl>
+<a NAME="CookieJar.__cookieFilter" ID="CookieJar.__cookieFilter"></a>
+<h4>CookieJar.__cookieFilter</h4>
+<b>__cookieFilter</b>(<i>request</i>)
+
+<p>
+        Private method to filter cookies.
+</p>
+<p>
+        Note: This method is used for Qt 5.11+ only.
+</p>
+<dl>
+
+<dt><i>request</i> (QWebEngineCookieStore.FilterRequest)</dt>
+<dd>
+reference to the cookie filter request object
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating cookie access is allowed
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+bool
+</dd>
+</dl>
+<a NAME="CookieJar.__cookieRemoved" ID="CookieJar.__cookieRemoved"></a>
+<h4>CookieJar.__cookieRemoved</h4>
+<b>__cookieRemoved</b>(<i>cookie</i>)
+
+<p>
+        Private slot handling the removal of a cookie.
+</p>
+<dl>
+
+<dt><i>cookie</i> (QNetworkCookie)</dt>
+<dd>
+cookie which was removed
+</dd>
+</dl>
+<a NAME="CookieJar.__isOnDomainList" ID="CookieJar.__isOnDomainList"></a>
+<h4>CookieJar.__isOnDomainList</h4>
+<b>__isOnDomainList</b>(<i>rules, domain</i>)
+
+<p>
+        Private method to check, if either the rule matches the domain exactly
+        or the domain ends with ".rule".
+</p>
+<dl>
+
+<dt><i>rules</i></dt>
+<dd>
+list of rules (list of strings)
+</dd>
+<dt><i>domain</i></dt>
+<dd>
+domain name to check (string)
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating a match (boolean)
+</dd>
+</dl>
+<a NAME="CookieJar.__load" ID="CookieJar.__load"></a>
+<h4>CookieJar.__load</h4>
+<b>__load</b>(<i></i>)
+
+<p>
+        Private method to load the cookies settings.
+</p>
+<a NAME="CookieJar.__matchDomain" ID="CookieJar.__matchDomain"></a>
+<h4>CookieJar.__matchDomain</h4>
+<b>__matchDomain</b>(<i>cookieDomain, siteDomain</i>)
+
+<p>
+        Private method to check, if a URLs host matches a cookie domain
+        according to RFC 6265.
+</p>
+<dl>
+
+<dt><i>cookieDomain</i> (str)</dt>
+<dd>
+domain of the cookie
+</dd>
+<dt><i>siteDomain</i> (str)</dt>
+<dd>
+domain or host of an URL
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating a match
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+bool
+</dd>
+</dl>
+<a NAME="CookieJar.__rejectCookie" ID="CookieJar.__rejectCookie"></a>
+<h4>CookieJar.__rejectCookie</h4>
+<b>__rejectCookie</b>(<i>cookie, cookieDomain</i>)
+
+<p>
+        Private method to test, if a cookie shall be rejected.
+</p>
+<dl>
+
+<dt><i>cookie</i> (QNetworkCookie)</dt>
+<dd>
+cookie to be tested
+</dd>
+<dt><i>cookieDomain</i> (str)</dt>
+<dd>
+domain of the cookie
+</dd>
+</dl>
+<dl>
+<dt>Return:</dt>
+<dd>
+flag indicating the cookie shall be rejected
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+bool
+</dd>
+</dl>
+<a NAME="CookieJar.__save" ID="CookieJar.__save"></a>
+<h4>CookieJar.__save</h4>
+<b>__save</b>(<i></i>)
+
+<p>
+        Private method to save the cookies settings.
+</p>
+<a NAME="CookieJar.acceptPolicy" ID="CookieJar.acceptPolicy"></a>
+<h4>CookieJar.acceptPolicy</h4>
+<b>acceptPolicy</b>(<i></i>)
+
+<p>
+        Public method to get the accept policy.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+current accept policy
+</dd>
+</dl>
+<a NAME="CookieJar.allowForSessionCookies" ID="CookieJar.allowForSessionCookies"></a>
+<h4>CookieJar.allowForSessionCookies</h4>
+<b>allowForSessionCookies</b>(<i></i>)
+
+<p>
+        Public method to return the list of allowed session cookie domains.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of allowed session cookie domains (list of strings)
+</dd>
+</dl>
+<a NAME="CookieJar.allowedCookies" ID="CookieJar.allowedCookies"></a>
+<h4>CookieJar.allowedCookies</h4>
+<b>allowedCookies</b>(<i></i>)
+
+<p>
+        Public method to return the list of allowed domains.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of allowed domains (list of strings)
+</dd>
+</dl>
+<a NAME="CookieJar.blockedCookies" ID="CookieJar.blockedCookies"></a>
+<h4>CookieJar.blockedCookies</h4>
+<b>blockedCookies</b>(<i></i>)
+
+<p>
+        Public method to return the list of blocked domains.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of blocked domains (list of strings)
+</dd>
+</dl>
+<a NAME="CookieJar.clear" ID="CookieJar.clear"></a>
+<h4>CookieJar.clear</h4>
+<b>clear</b>(<i></i>)
+
+<p>
+        Public method to clear all cookies.
+</p>
+<a NAME="CookieJar.close" ID="CookieJar.close"></a>
+<h4>CookieJar.close</h4>
+<b>close</b>(<i></i>)
+
+<p>
+        Public slot to close the cookie jar.
+</p>
+<a NAME="CookieJar.cookieDomains" ID="CookieJar.cookieDomains"></a>
+<h4>CookieJar.cookieDomains</h4>
+<b>cookieDomains</b>(<i></i>)
+
+<p>
+        Public method to get a list of all domains used by the cookies.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of domain names
+</dd>
+</dl>
+<dl>
+<dt>Return Type:</dt>
+<dd>
+list of str
+</dd>
+</dl>
+<a NAME="CookieJar.cookies" ID="CookieJar.cookies"></a>
+<h4>CookieJar.cookies</h4>
+<b>cookies</b>(<i></i>)
+
+<p>
+        Public method to get the cookies of the cookie jar.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+list of all cookies (list of QNetworkCookie)
+</dd>
+</dl>
+<a NAME="CookieJar.filterTrackingCookies" ID="CookieJar.filterTrackingCookies"></a>
+<h4>CookieJar.filterTrackingCookies</h4>
+<b>filterTrackingCookies</b>(<i></i>)
+
+<p>
+        Public method to get the filter tracking cookies flag.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+filter tracking cookies flag (boolean)
+</dd>
+</dl>
+<a NAME="CookieJar.keepPolicy" ID="CookieJar.keepPolicy"></a>
+<h4>CookieJar.keepPolicy</h4>
+<b>keepPolicy</b>(<i></i>)
+
+<p>
+        Public method to get the keep policy.
+</p>
+<dl>
+<dt>Return:</dt>
+<dd>
+keep policy
+</dd>
+</dl>
+<a NAME="CookieJar.removeCookie" ID="CookieJar.removeCookie"></a>
+<h4>CookieJar.removeCookie</h4>
+<b>removeCookie</b>(<i>cookie</i>)
+
+<p>
+        Public method to remove a cookie.
+</p>
+<dl>
+
+<dt><i>cookie</i> (QNetworkCookie)</dt>
+<dd>
+cookie to be removed
+</dd>
+</dl>
+<a NAME="CookieJar.removeCookies" ID="CookieJar.removeCookies"></a>
+<h4>CookieJar.removeCookies</h4>
+<b>removeCookies</b>(<i>cookies</i>)
+
+<p>
+        Public method to remove a list of cookies.
+</p>
+<dl>
+
+<dt><i>cookies</i> (list of QNetworkCookie)</dt>
+<dd>
+list of cookies to be removed
+</dd>
+</dl>
+<a NAME="CookieJar.setAcceptPolicy" ID="CookieJar.setAcceptPolicy"></a>
+<h4>CookieJar.setAcceptPolicy</h4>
+<b>setAcceptPolicy</b>(<i>policy</i>)
+
+<p>
+        Public method to set the accept policy.
+</p>
+<dl>
+
+<dt><i>policy</i></dt>
+<dd>
+accept policy to be set
+</dd>
+</dl>
+<a NAME="CookieJar.setAllowForSessionCookies" ID="CookieJar.setAllowForSessionCookies"></a>
+<h4>CookieJar.setAllowForSessionCookies</h4>
+<b>setAllowForSessionCookies</b>(<i>list_</i>)
+
+<p>
+        Public method to set the list of allowed session cookie domains.
+</p>
+<dl>
+
+<dt><i>list_</i></dt>
+<dd>
+list of allowed session cookie domains (list of strings)
+</dd>
+</dl>
+<a NAME="CookieJar.setAllowedCookies" ID="CookieJar.setAllowedCookies"></a>
+<h4>CookieJar.setAllowedCookies</h4>
+<b>setAllowedCookies</b>(<i>list_</i>)
+
+<p>
+        Public method to set the list of allowed domains.
+</p>
+<dl>
+
+<dt><i>list_</i></dt>
+<dd>
+list of allowed domains (list of strings)
+</dd>
+</dl>
+<a NAME="CookieJar.setBlockedCookies" ID="CookieJar.setBlockedCookies"></a>
+<h4>CookieJar.setBlockedCookies</h4>
+<b>setBlockedCookies</b>(<i>list_</i>)
+
+<p>
+        Public method to set the list of blocked domains.
+</p>
+<dl>
+
+<dt><i>list_</i></dt>
+<dd>
+list of blocked domains (list of strings)
+</dd>
+</dl>
+<a NAME="CookieJar.setFilterTrackingCookies" ID="CookieJar.setFilterTrackingCookies"></a>
+<h4>CookieJar.setFilterTrackingCookies</h4>
+<b>setFilterTrackingCookies</b>(<i>filterTrackingCookies</i>)
+
+<p>
+        Public method to set the filter tracking cookies flag.
+</p>
+<dl>
+
+<dt><i>filterTrackingCookies</i></dt>
+<dd>
+filter tracking cookies flag (boolean)
+</dd>
+</dl>
+<a NAME="CookieJar.setKeepPolicy" ID="CookieJar.setKeepPolicy"></a>
+<h4>CookieJar.setKeepPolicy</h4>
+<b>setKeepPolicy</b>(<i>policy</i>)
+
+<p>
+        Public method to set the keep policy.
+</p>
+<dl>
+
+<dt><i>policy</i></dt>
+<dd>
+keep policy to be set
+</dd>
+</dl>
+<div align="right"><a href="#top">Up</a></div>
+<hr />
+</body></html>
\ No newline at end of file

eric ide

mercurial