Тип 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 и более поздних версиях строка user-agent по умолчанию всегда будет указывать "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 содержит экземпляр уведомления для запроса данных и взаимодействия.

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

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

void clearHttpCache()

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

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

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