Тип QML WebEngineScript

Обеспечивает программную инъекцию скриптов в движок JavaScript. Подробнее...

Оператор импорта:	import QtWebEngine 1.2
С тех пор:	QtWebEngine 1.1

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

Свойства

injectionPoint : перечисление
name : строка
runOnSubframes : целое число
sourceCode : строка
sourceUrl : url
worldId : перечисление

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

Тип WebEngineScript позволяет программную инъекцию так называемых пользовательских скриптов в движок JavaScript в различные моменты, определяемые свойством injectionPoint, во время загрузки веб-контента.

Скрипты могут выполняться либо в основном JavaScript мире вместе с остальной частью JavaScript, полученной из веб-контента, либо в собственном изолированном мире. Хотя к DOM страницы можно получить доступ из любого мира, переменные JavaScript функции, определённые в одном мире, недоступны в другом. Свойство worldId предоставляет некоторые предопределённые идентификаторы для этой цели.

Примечание: Расширения Chromium, такие как @include, @match, и @exclude, не поддерживаются.

Используйте WebEngineView.userScripts для доступа к списку скриптов, присоединённых к веб-вью.

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

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

Точка в процессе загрузки, в которой будет выполняться скрипт. Значение по умолчанию — Deferred.

Постоянная	Описание
`WebEngineScript.DocumentCreation`	Скрипт будет выполнен сразу после создания документа. Это не подходит для любых операций с DOM.
`WebEngineScript.DocumentReady`	Скрипт будет выполнен, как только DOM будет готов. Это эквивалентно срабатыванию события `DOMContentLoaded` в JavaScript.
`WebEngineScript.Deferred`	Скрипт будет выполнен по завершении загрузки страницы или через 500 мс после готовности документа, в зависимости от того, что произойдёт раньше.

name : строка

Имя скрипта. Может быть полезно для извлечения определённого скрипта из WebEngineView.userScripts.

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

Установите это свойство в true если скрипт выполняется на каждой фрейме страницы или в false если он выполняется только для основной фреймы. Значение по умолчанию — false.

sourceCode : строка

Это свойство содержит исходный код JavaScript пользовательского скрипта.

См. также sourceUrl.

sourceUrl : url

Это свойство содержит удалённое местоположение источника пользовательского скрипта (если есть).

В отличие от sourceCode, это свойство позволяет ссылаться на пользовательские скрипты, которые ещё не загружены в память, например, хранящиеся на диске.

Установка этого свойства изменит sourceCode скрипта.

Примечание: В настоящее время поддерживаются только источники на основе файлов.

См. также sourceCode.

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

Идентификатор мира, определяющий, в каком изолированном мире выполняется скрипт.

Постоянная	Описание
`WebEngineScript.MainWorld`	Мир, используемый веб-контентом страницы. Он может быть полезен для экспонирования пользовательской функциональности веб-контенту в определённых сценариях.
`WebEngineScript.ApplicationWorld`	По умолчанию изолированный мир, используемый для функциональности на уровне приложения, реализованной на JavaScript.
`WebEngineScript.UserWorld`	Первый изолированный мир, который будут использовать скрипты, заданные пользователями, если приложение не использует больше миров. Как правило, если эта функциональность доступна пользователям приложения, каждому отдельному скрипту, вероятно, нужен свой изолированный мир.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qml-qtwebengine-webenginescript.html