Тип QML WebEngineProfile

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

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

Свойства

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

Сигналы

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

Методы

• void clearHttpCache()

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

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

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

Профили могут использоваться для изоляции страниц друг от друга. Типичным случаем использования является выделенный профиль без учета истории для режима инкогнито. Профиль без учета истории заставляет куки, кэш 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 : логическое значение

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

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

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

persistentStoragePath : строка

Путь к расположению, где хранятся постоянные данные для браузера и веб-контента. Постоянные данные включают постоянные куки, локальное хранилище 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(WebEngineDownloadItem download)

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

Примечание: Соответствующий обработчик — onDownloadFinished.

downloadRequested(WebEngineDownloadItem download)

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

Примечание: Соответствующий обработчик — onDownloadRequested.

presentNotification(WebEngineNotification notification)

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

Примечание: Соответствующий обработчик — onPresentNotification.

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

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

void clearHttpCache()

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

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

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