Qt 5.7 | Qt WebEngine | C++ Classes | QWebEngineCookieStore

Qt 5.7.1 Reference Documentation

# QWebEngineCookieStore Class

The QWebEngineCookieStore class provides access to Chromium's cookies. More...

Header: | #include <QWebEngineCookieStore>
Since: | Qt 5.6

- List of all members, including inherited members

## Public Functions

virtual | ~QWebEngineCookieStore()
void | deleteAllCookies()
void | deleteCookie(const QNetworkCookie &cookie, const QUrl &origin = QUrl())
void | deleteSessionCookies()
void | loadAllCookies()
void | setCookie(const QNetworkCookie &cookie, const QUrl &origin = QUrl())

## Signals

void | cookieAdded(const QNetworkCookie &cookie)
void | cookieRemoved(const QNetworkCookie &cookie)

## Detailed Description

The QWebEngineCookieStore class provides access to Chromium's cookies.

The class allows to access HTTP cookies of Chromium for a specific profile. It can be used to synchronize cookies of Chromium and the QNetworkAccessManager, as well as to set, delete, and intercept cookies during navigation. Because cookie operations are asynchronous, the user can choose to provide a callback function to get notified about the success of the operation. The signal handlers for removal and addition should not be used to execute heavy tasks, because they might block the IO thread in case of a blocking connection.

Use QWebEngineProfile::cookieStore() and QQuickWebEngineProfile::cookieStore() to access the cookie store object for a specific profile.

## Member Function Documentation

### `[virtual]` QWebEngineCookieStore::~QWebEngineCookieStore()

Destroys this QWebEngineCookieStore object.

### `[signal]` void QWebEngineCookieStore::cookieAdded(const QNetworkCookie &cookie)

This signal is emitted whenever a new cookie is added to the cookie store.

### `[signal]` void QWebEngineCookieStore::cookieRemoved(const QNetworkCookie &cookie)

This signal is emitted whenever a cookie is deleted from the cookie store.

### void QWebEngineCookieStore::deleteAllCookies()

Deletes all the cookies in the cookie store.

Note: This operation is asynchronous.

See also loadAllCookies().

### void QWebEngineCookieStore::deleteCookie(const QNetworkCookie &cookie, const QUrl &origin = QUrl())

Deletes cookie from the cookie store. It is possible to provide an optional origin URL argument to limit the scope of the cookie to be deleted.

Note: This operation is asynchronous.

### void QWebEngineCookieStore::deleteSessionCookies()

Deletes all the session cookies in the cookie store. Session cookies do not have an expiration date assigned to them.

Note: This operation is asynchronous.

See also loadAllCookies().

### void QWebEngineCookieStore::loadAllCookies()

Loads all the cookies into the cookie store. The cookieAdded() signal is emitted on every loaded cookie. Cookies are loaded automatically when the store gets initialized, which in most cases happens on loading the first URL. However, calling this function is useful if cookies should be listed before entering the web content.

Note: This operation is asynchronous.

### void QWebEngineCookieStore::setCookie(const QNetworkCookie &cookie, const QUrl &origin = QUrl())

Adds cookie to the cookie store. It is possible to provide an optional origin URL argument to limit the scope of the cookie. The provided URL should also include the scheme.

Note: This operation is asynchronous.