Тип QML WebEngineProfile

Содержит настройки, скрипты и посещенные ссылки, общие для нескольких представлений веб-движка. Подробнее...

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

Свойства

• cachePath : строка
• downloadPath : строка
• httpAcceptLanguage : строка
• httpCacheMaximumSize : целое число
• httpCacheType : перечисление
• httpUserAgent : строка
• offTheRecord : логическое значение
• persistentCookiesPolicy : перечисление
• persistentStoragePath : строка
• spellCheckEnabled : логическое значение
• spellCheckLanguages : список<строка>
• storageName : строка
• useForGlobalCertificateVerification : логическое значение
• userScripts : список<WebEngineScript>

Сигналы

• downloadFinished(download)
• downloadRequested(download)
• presentNotification(notification)

Методы

• void clearHttpCache()

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

WebEngineProfile содержит настройки, скрипты и список посещенных ссылок, общих для всех представлений, принадлежащих профилю.

Информация о посещенных ссылках хранится вместе с постоянными cookie-файлами и другими постоянными данными в хранилище, определяемом свойством storageName. Постоянные данные хранятся в подкаталоге, определяемом свойством persistentStoragePath, а кэш — в подкаталоге, определяемом свойством cachePath. Свойство httpCacheType описывает тип кэша: в оперативной памяти или на диске. Если установлено только свойство storageName, другие значения генерируются автоматически на его основе. Если вы задаете какие-либо значения вручную, вы должны сделать это до создания каких-либо страниц, относящихся к профилю.

Профили могут использоваться для изоляции страниц друг от друга. Типичным примером использования является выделенный профиль в режиме инкогнито для режима частного просмотра. Профиль в режиме инкогнито заставляет cookie-файлы, кэш HTTP и другие обычно постоянные данные храниться только в оперативной памяти. Свойство offTheRecord указывает, является ли профиль профилем в режиме инкогнито.

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

Документация по свойствам

cachePath : строка

Путь к расположению, где хранятся кэши профиля, в частности кэш HTTP.

По умолчанию кэши хранятся ниже QStandardPaths::writableLocation(QStandardPaths::CacheLocation) в каталоге с именем, заданным с помощью storageName.

downloadPath : строка

Путь к расположению, где хранятся загруженные файлы.

Заменяет путь по умолчанию, используемый для местоположения загрузки.

Если установлено пустая строка, восстанавливается путь по умолчанию.

Примечание: По умолчанию путь к загрузке — QStandardPaths::DownloadLocation.

Это свойство было добавлено в QtWebEngine 1.9.

httpAcceptLanguage : строка

Значение поля заголовка HTTP Accept-Language.

Это свойство было добавлено в QtWebEngine 1.2.

httpCacheMaximumSize : целое число

Максимальный размер кэша HTTP. Если 0, размер будет управляться автоматически QtWebEngine. Значение по умолчанию — 0.
См. также httpCacheType.

httpCacheType : перечисление

Это перечисление описывает тип кэша HTTP:

httpUserAgent : строка

Строка user-agent, отправляемая с HTTP для идентификации браузера.

Примечание: В Windows 8.1 и более поздних версиях пользовательский агент по умолчанию всегда будет указывать «Windows NT 6.2» (Windows 8), если приложение не содержит манифеста, который объявляет поддержку более новых версий Windows.

offTheRecord : логическое значение

Указывает, является ли профиль веб-движка профилем в режиме инкогнито. Профиль в режиме инкогнито заставляет cookie-файлы, кэш HTTP и другие обычно постоянные данные храниться только в оперативной памяти.

persistentCookiesPolicy : перечисление

Это перечисление описывает политику сохранения cookie-файлов:

persistentStoragePath : строка

Путь к расположению, где хранятся постоянные данные браузера и веб-содержимого. Постоянные данные включают постоянные cookie-файлы, локальное хранилище HTML5 и посещенные ссылки.

По умолчанию хранилище находится ниже QStandardPaths::writableLocation(QStandardPaths::DataLocation) в каталоге с именем, заданным с помощью storageName.

spellCheckEnabled : логическое значение

Это свойство указывает, включен ли орфографический модуль веб-движка.

Это свойство было добавлено в QtWebEngine 1.4.

spellCheckLanguages : список<строка>

Это свойство содержит список языков, используемых орфографическим модулем. Каждый язык должен соответствовать имени .bdic словаря. Например, язык en-US загрузит файл словаря en-US.bdic.
См. документацию по функции орфографической проверки для получения информации о поиске файлов словарей.
Для получения дополнительной информации о том, как скомпилировать словари .bdic, см. Пример орфографической проверки.

Это свойство было добавлено в QtWebEngine 1.4.

storageName : строка

Имя хранилища, используемое для создания отдельных подкаталогов для каждого профиля, использующего диск для хранения постоянных данных и кэша.

См. также WebEngineProfile::persistentStoragePath и WebEngineProfile::cachePath.

useForGlobalCertificateVerification : bool

Это свойство указывает, используется ли этот профиль для загрузки и кеширования во время глобальной проверки сертификатов при использовании протокола статуса онлайн-сертификатов (OCSP), списков отзыва сертификатов (CRL) и доступа к информации об авторитетах (AIA), например.

Пока этот параметр включен в одном профиле, все остальные профили смогут использовать его для проверки сертификатов. Только один профиль за раз может иметь этот параметр включенным. Рекомендуется, чтобы профиль имел кэш HTTP-диска, чтобы избежать ненужной повторной загрузки.

По умолчанию этот параметр не включен ни в одном профиле.

В настоящее время влияет только на установки Linux/NSS, где наличие профиля с этой ролью активирует OCSP.

Это свойство было добавлено в QtWebEngine 1.9.

userScripts : list<WebEngineScript>

Возвращает коллекцию WebEngineScripts, которые встроены во все страницы, использующие этот профиль.

Это свойство было добавлено в Qt 1.5.

См. также WebEngineScript.

Документация сигналов

downloadFinished(download)

Этот сигнал испускается всякий раз, когда загрузка завершается, успешно, отменяется или прерывается (например, из-за потери подключения). Аргумент download содержит состояние завершенной загрузки.

downloadRequested(download)

Этот сигнал испускается всякий раз, когда запускается загрузка. Аргумент download содержит состояние загрузки. Загрузку необходимо явно принять с помощью WebEngineDownloadItem::accept(), в противном случае она будет отменена по умолчанию.

presentNotification(notification)

Этот сигнал испускается всякий раз, когда появляется новое пользовательское уведомление. Аргумент notification содержит экземпляр WebEngineNotification для запроса данных и взаимодействия.

Этот сигнал был добавлен в QtWebEngine 1.9.

Документация методов

void clearHttpCache()

Удаляет записи кэша профиля.

Этот метод был добавлен в QtWebEngine 1.3.

См. также WebEngineProfile::cachePath.