Тип QML WebEngineProfile
Содержит настройки, скрипты и посещенные ссылки, общие для нескольких представлений веб-движка. Подробнее...
| Заявление об импорте: | import QtWebEngine 1.7 |
| С момента: | QtWebEngine 1.1 |
| Создаёт экземпляр: | QQuickWebEngineProfile |
Свойства
- cachePath : строка
- httpAcceptLanguage : строка
- httpCacheMaximumSize : целое число
- httpCacheType : перечисление
- httpUserAgent : строка
- offTheRecord : логическое
- persistentCookiesPolicy : перечисление
- persistentStoragePath : строка
- spellCheckEnabled : логическое
- spellCheckLanguages : список<строка>
- storageName : строка
- userScripts : список<WebEngineScript>
Сигналы
- downloadFinished(WebEngineDownloadItem download)
- downloadRequested(WebEngineDownloadItem download)
Методы
- void clearHttpCache()
Подробное описание
WebEngineProfile содержит настройки, скрипты и список посещенных ссылок, общих для всех представлений, принадлежащих профилю. Таким образом, профили могут использоваться для изоляции представлений друг от друга. Типичный пример использования — выделенный профиль для режима «приватного просмотра».
Каждое представление веб-движка имеет связанный профиль. Представления, у которых нет установленного профиля, используют общий по умолчанию.
Документация по свойствам
cachePath : строка
Путь к расположению, где хранятся кэши профиля, в частности кэш HTTP.
По умолчанию, кэши хранятся под QStandardPaths::writableLocation(QStandardPaths::CacheLocation) в каталоге с именем, используемым storageName.
httpAcceptLanguage : строка
Значение поля заголовка HTTP Accept-Language.
Это свойство было добавлено в QtWebEngine 1.2.
httpCacheMaximumSize : целое число
Максимальный размер кэша HTTP. Если 0, размер будет автоматически контролироваться QtWebEngine. Значение по умолчанию — 0.
См. также httpCacheType.
httpCacheType : перечисление
Это перечисление описывает тип кэша HTTP:
| Константа | Описание |
|---|---|
WebEngineProfile.MemoryHttpCache |
Использует кэш в оперативной памяти. Это единственный возможный вариант, если offTheRecord установлен или persistentStoragePath недоступен. |
WebEngineProfile.DiskHttpCache |
Использует кэш на диске. Это значение по умолчанию. |
WebEngineProfile.NoCache |
Отключает кэширование. (Добавлено в 5.7) |
httpUserAgent : строка
Строка user-agent, отправляемая с HTTP для идентификации браузера.
Примечание: В Windows 8.1 и новее строка user-agent по умолчанию всегда будет указывать «Windows NT 6.2» (Windows 8), если приложение не содержит манифест, который объявляет поддержку более новых версий Windows.
offTheRecord : логическое
Указывает, является ли профиль веб-движка профилем «off-the-record». Профиль «off-the-record» принудительно хранит куки, кэш HTTP и другие обычно постоянные данные только в оперативной памяти.
persistentCookiesPolicy : перечисление
Это перечисление описывает политику сохранения куки:
| Константа | Описание |
|---|---|
WebEngineProfile.NoPersistentCookies |
Как сессионные, так и постоянные куки хранятся в оперативной памяти. Это единственный возможный вариант, если offTheRecord установлен или persistentStoragePath недоступен. |
WebEngineProfile.AllowPersistentCookies |
Постоянные куки сохраняются на диске и восстанавливаются с него, в то время как сессионные куки сохраняются на диске только для восстановления после сбоя. Это значение по умолчанию. |
WebEngineProfile.ForcePersistentCookies |
Как сессионные, так и постоянные куки сохраняются и восстанавливаются с диска. |
persistentStoragePath : строка
Путь к расположению, где хранятся постоянные данные браузера и веб-содержимого. К постоянным данным относятся постоянные куки, локальное хранилище HTML5 и посещенные ссылки.
По умолчанию, хранилище расположено под QStandardPaths::writableLocation(QStandardPaths::DataLocation) в каталоге с именем, используемым storageName.
spellCheckEnabled : логическое
Это свойство указывает, включен ли орфографический модуль веб-движка.
Это свойство было добавлено в QtWebEngine 1.4.
spellCheckLanguages : список<строка>
Это свойство содержит список языков, используемых орфографическим модулем. Каждый язык должен соответствовать имени .bdic словаря. Например, язык en-US загрузит файл словаря en-US.bdic.
См. документацию по функции Spellchecker для получения информации о том, как ищутся файлы словарей.
Дополнительную информацию о том, как скомпилировать словари .bdic, см. в примере Spellchecker.
Это свойство было добавлено в 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.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qml-qtwebengine-webengineprofile.html