Тип QML WebEngineScript

Позволяет программно встраивать скрипты в движок JavaScript. Подробнее...

Заявление импорта:	import QtWebEngine 1.10
С:	QtWebEngine 1.1
Создает:	QQuickWebEngineScript

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

Свойства

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

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

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

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

Поддерживаются следующие атрибуты Greasemonkey начиная с Qt 5.8: @exclude, @include, @name, @match, и @run-at.

Используйте свойство 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/qt-5.14/qml-qtwebengine-webenginescript.html