Тип QML WebEngineProfile

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

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

Свойства

• 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 : строка

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

Это свойство QML было добавлено в 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 : логическое значение

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

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

spellCheckLanguages : список<строка>

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

Qt WebEngine сначала проверяет подкаталог qtwebengine_dictionaries в локальном каталоге, а если его нет, то в каталоге установки Qt.

На macOS, в зависимости от того, как Qt WebEngine был сконфигурирован при построении, есть два варианта поиска данных для проверки орфографии:

• Словари Hunspell (по умолчанию) - используются словари .bdic, как и на других платформах
• Встроенные словари - используются API для проверки орфографии macOS (что означает, что результаты будут зависеть от установленных словарей ОС)

Таким образом, в случае использования Hunspell Qt WebEngine будет искать подкаталог qtwebengine_dictionaries, расположенный внутри пакета приложения Resources, а также в каталоге Resources внутри пакета Qt.

Подводя итог, в случае использования Hunspell, рассматриваются следующие пути:

• QCoreApplication::applicationDirPath()/qtwebengine_dictionaries или QCoreApplication::applicationDirPath()/../Contents/Resources/qtwebengine_dictionaries (на macOS)
• [QLibraryInfo::DataPath]/qtwebengine_dictionaries или путь/к/QtWebEngineCore.framework/Resources/qtwebengine_dictionaries (пакет Qt на macOS)

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

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

storageName : строка

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

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

userScripts : список<WebEngineScript>

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

Это свойство QML было добавлено в Qt 1.5.

См. также WebEngineScript.

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

downloadFinished(WebEngineDownloadItem download)

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

downloadRequested(WebEngineDownloadItem download)

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

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

void clearHttpCache()

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

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

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