Тип QML WebEngineProfile

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

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

Свойства

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

Сигналы

• downloadFinished(WebEngineDownloadItem download)
• downloadRequested(WebEngineDownloadItem download)

Методы

• void clearHttpCache()

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

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

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

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

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

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

cachePath : строка

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

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

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 : логическое

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

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

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

persistentStoragePath : строка

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

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

spellCheckEnabled : логическое

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

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

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

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

См. документацию по функции Spellchecker для информации о поиске файлов словарей.

Для получения дополнительной информации о том, как скомпилировать .bdic словари, см. Пример орфографического модуля.

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

storageName : строка

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

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

userScripts : список<WebEngineScript>

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

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

См. также WebEngineScript.

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

downloadFinished(WebEngineDownloadItem download)

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

downloadRequested(WebEngineDownloadItem download)

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

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

void clearHttpCache()

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

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

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