Тип QML WebEngineProfile

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

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

Свойства

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

Сигналы

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

Методы

• void clearHttpCache()

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

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

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

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

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

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

cachePath : строка

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

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

[с версии QtWebEngine 1.9] downloadPath : строка

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

Переопределяет путь по умолчанию, используемый для расположения загрузок.

Если значение установлено в пустую строку, восстанавливается путь по умолчанию.

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

[с версии QtWebEngine 1.2] httpAcceptLanguage : строка

Значение поля Accept-Language заголовка HTTP запроса.

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

httpCacheMaximumSize : целое число

Максимальный размер кэша HTTP. Если 0, размер будет автоматически контролироваться QtWebEngine. Значение по умолчанию — 0.

См. также httpCacheType.

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

Это перечисление описывает тип кэша HTTP:

httpUserAgent : строка

Строка user-agent, отправляемая вместе с HTTP для идентификации браузера.

offTheRecord : логическое значение

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

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

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

persistentStoragePath : строка

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

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

[с версии QtWebEngine 1.4] spellCheckEnabled : логическое значение

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

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

[с версии QtWebEngine 1.4] spellCheckLanguages : список<строка>

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

См. документацию по функции орфографического проверяющего для получения информации о том, как ищутся файлы словарей.

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

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

storageName : строка

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

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

userScripts : list<WebEngineScript>

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

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

downloadFinished(WebEngineDownloadItem download)

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

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

downloadRequested(WebEngineDownloadItem download)

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

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

[since QtWebEngine 1.9] presentNotification(WebEngineNotification notification)

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

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

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

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

[since QtWebEngine 1.3] void clearHttpCache()

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

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

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