Тип QML WebEngineProfile
Содержит настройки, скрипты и посещённые ссылки, общие для нескольких представлений веб-движка. Подробнее...
| Заявление об импорте: | import QtWebEngine 1.2 |
| С момента: | QtWebEngine 1.1 |
| Инициализирует: | QQuickWebEngineProfile |
Свойства
- cachePath : строка
- httpAcceptLanguage : строка
- httpCacheMaximumSize : целое число
- httpCacheType : перечисление
- httpUserAgent : строка
- offTheRecord : логическое значение
- persistentCookiesPolicy : перечисление
- persistentStoragePath : строка
- storageName : строка
Сигналы
- downloadFinished(WebEngineDownloadItem download)
- downloadRequested(WebEngineDownloadItem download)
Подробное описание
WebEngineProfile содержит настройки, скрипты и список посещённых ссылок, общие для всех представлений, принадлежащих профилю. Таким образом, профили могут использоваться для изоляции представлений друг от друга. Типичный пример использования — отдельный профиль для режима «инкогнито».
Каждое представление веб-движка имеет связанный с ним профиль. Представления, у которых не задан конкретный профиль, используют общий профиль по умолчанию.
Документация по свойствам
cachePath : строка
Путь к расположению, где хранятся кэши профиля, в частности, кэш HTTP.
По умолчанию кэши хранятся в каталоге ниже QStandardPaths::writableLocation(QStandardPaths::CacheLocation) в каталоге с именем, использующим storageName.
httpAcceptLanguage : строка
Значение поля Accept-Language заголовка HTTP-запроса.
Это свойство QML было добавлено в QtWebEngine 1.2.
httpCacheMaximumSize : целое число
Максимальный размер кэша HTTP. Если 0, размер будет управляться автоматически QtWebEngine. Значение по умолчанию — 0.
См. также httpCacheType.
httpCacheType : перечисление
Это перечисление описывает тип кэша HTTP:
| Константа | Описание |
|---|---|
WebEngineProfile.MemoryHttpCache |
Использует кэш в оперативной памяти. Это единственное возможное значение, если offTheRecord задано или persistentStoragePath недоступно. |
WebEngineProfile.DiskHttpCache |
Использует кэш на диске. Это значение по умолчанию. |
httpUserAgent : строка
Строка user-agent, отправляемая с HTTP для идентификации браузера.
offTheRecord : логическое значение
Определяет, является ли профиль веб-движка профилем «инкогнито». Профиль «инкогнито» принудительно сохраняет куки, кэш HTTP и другие обычно сохраняемые данные только в оперативной памяти.
persistentCookiesPolicy : перечисление
Это перечисление описывает политику сохранения куки:
| Константа | Описание |
|---|---|
WebEngineProfile.NoPersistentCookies |
Сеансовые и постоянные куки сохраняются в оперативной памяти. Это единственное возможное значение, если offTheRecord задано или persistentStoragePath недоступно. |
WebEngineProfile.AllowPersistentCookies |
Постоянные куки сохраняются на диске, а сеансовые — только для восстановления после сбоя. Это значение по умолчанию. |
WebEngineProfile.ForcePersistentCookies |
Сеансовые и постоянные куки сохраняются на диске. |
persistentStoragePath : строка
Путь к расположению, где хранятся постоянные данные браузера и веб-контента. К постоянным данным относятся постоянные куки, локальное хранилище HTML5 и посещённые ссылки.
По умолчанию хранилище расположено в каталоге ниже QStandardPaths::writableLocation(QStandardPaths::DataLocation) в каталоге с именем, использующим storageName.
storageName : строка
Имя хранилища, используемое для создания отдельных подкаталогов для каждого профиля, использующего диск для хранения постоянных данных и кэша.
См. также WebEngineProfile::persistentStoragePath и WebEngineProfile::cachePath.
Документация по сигналам
downloadFinished(WebEngineDownloadItem download)
Этот сигнал испускается всякий раз, когда загрузка завершается успешно, отменяется или прерывается (например, из-за потери подключения). Аргумент download содержит состояние завершённого экземпляра загрузки.
downloadRequested(WebEngineDownloadItem download)
Этот сигнал испускается всякий раз, когда инициируется загрузка. Аргумент download содержит состояние загрузки. Загрузка должна быть явно принята с помощью WebEngineDownloadItem::accept(), иначе загрузка будет отменена по умолчанию.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qml-qtwebengine-webengineprofile.html