Класс QWebEngineCookieStore

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

Этот класс был представлен в Qt 5.6.

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

Общественные типы

Общественные функции

Сигналы

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

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

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

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

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

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

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

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

[virtual] QWebEngineCookieStore::~QWebEngineCookieStore()

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

void QWebEngineCookieStore::deleteAllCookies()

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

Примечание: Эта операция асинхронна.

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

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

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

Примечание: Эта операция асинхронна.

void QWebEngineCookieStore::deleteSessionCookies()

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

Примечание: Эта операция асинхронна.

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

void QWebEngineCookieStore::loadAllCookies()

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

Примечание: Эта операция асинхронна.

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

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

Примечание: Если cookie указывает на QNetworkCookie::domain(), который не начинается с точки, точка автоматически добавляется перед ним. Чтобы ограничить куки до точного сервера, опустите QNetworkCookie::domain() и установите origin вместо этого.

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

Примечание: Эта операция асинхронна.

void QWebEngineCookieStore::setCookieFilter(const std::function<bool (const FilterRequest &)> &filterCallback)

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

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

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

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

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

Примечание: Фильтр куки также управляет другими функциями с возможностями отслеживания, аналогичными куки; включая IndexedDB, хранилище DOM, API файловой системы, рабочие потоки и AppCache.

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

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

void QWebEngineCookieStore::setCookieFilter(std::function<bool (const FilterRequest &)> &&filterCallback)

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

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