Класс QWebEngineCookieStore

Класс QWebEngineCookieStore предоставляет доступ к cookie Chromium. Подробнее...

• Список всех членов, включая унаследованные

Типы public

Функции public

Сигналы

Подробное описание

Класс позволяет получить доступ к HTTP cookie Chromium для определенного профиля. Его можно использовать для синхронизации cookie Chromium и QNetworkAccessManager, а также для установки, удаления и перехвата cookie во время навигации. Поскольку операции с cookie асинхронны, пользователь может выбрать предоставление функции обратного вызова, чтобы получить уведомление об успешном выполнении операции. Обработчики сигналов для удаления и добавления не должны использоваться для выполнения ресурсоёмких задач, поскольку они могут заблокировать поток ввода-вывода в случае блокирующего подключения.

Используйте QWebEngineProfile::cookieStore() и QQuickWebEngineProfile::cookieStore() для доступа к объекту хранилища cookie для определенного профиля.

Документация по функциям-членам

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

Этот сигнал генерируется всякий раз, когда новое cookie добавляется в хранилище cookie.

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

Этот сигнал генерируется всякий раз, когда cookie удаляется из хранилища cookie.

[virtual] QWebEngineCookieStore::~QWebEngineCookieStore()

Удаляет этот объект QWebEngineCookieStore.

void QWebEngineCookieStore::deleteAllCookies()

Удаляет все cookie в хранилище cookie.

См. также loadAllCookies().

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

Удаляет cookie из хранилища cookie. Можно предоставить необязательный аргумент URL origin, чтобы ограничить область удаляемого cookie.

void QWebEngineCookieStore::deleteSessionCookies()

Удаляет все сеансовые cookie в хранилище cookie. Сеансовые cookie не имеют назначенной даты истечения.

См. также loadAllCookies().

void QWebEngineCookieStore::loadAllCookies()

Загружает все cookie в хранилище cookie. Сигнал cookieAdded() генерируется для каждого загруженного cookie. Cookie загружаются автоматически при инициализации хранилища, что в большинстве случаев происходит при загрузке первого URL. Однако вызов этой функции полезен, если cookie должны быть перечислены перед входом в веб-контент.

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

Добавляет cookie в хранилище cookie.

Предоставленный URL также должен включать схему.

[since 5.11] void QWebEngineCookieStore::setCookieFilter(const std::function<bool (const FilterRequest &)> &filterCallback)

Устанавливает фильтр cookie, который может предотвратить использование сайтами и ресурсами cookie. filterCallback должен быть лямбда-выражением или функтором, принимающим структуру FilterRequest. Если доступ к cookie должен быть разрешен, функция фильтра должна возвращать true; в противном случае она должна возвращать false.

Следующий фрагмент кода иллюстрирует, как установить фильтр cookie:

profile->cookieStore()->setCookieFilter(
    [&allowThirdPartyCookies](const QWebEngineCookieStore::FilterRequest &request)
    { return !request.thirdParty || allowThirdPartyCookies; }
);

Вы можете сбросить фильтр с аргументом nullptr.

Обратный вызов не должен использоваться для выполнения ресурсоёмких задач, поскольку он выполняется в потоке ввода-вывода и, следовательно, блокирует сеть Chromium.

Эта функция была введена в Qt 5.11.

См. также deleteAllCookies() и loadAllCookies().

[since 5.11] void QWebEngineCookieStore::setCookieFilter(std::function<bool (const FilterRequest &)> &&filterCallback)

Это перегруженная функция.

Эта функция была введена в Qt 5.11.