Класс QWebEngineScript

Класс QWebEngineScript инкапсулирует программу JavaScript. Подробнее...

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

Типы публичного интерфейса

Публичные функции

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

Класс QWebEngineScript инкапсулирует программу JavaScript.

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

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

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

Используйте QWebEnginePage::scripts() и QWebEngineProfile::scripts() для доступа к коллекции скриптов, связанных с одной страницей или несколькими страницами, использующими один и тот же профиль.

Документация типов членов

перечисление QWebEngineScript::InjectionPoint

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

перечисление QWebEngineScript::ScriptWorldId

Это перечисление предоставляет предопределенные идентификаторы мира для изоляции пользовательских скриптов в разных мирах:

Документация функций-членов

QWebEngineScript::QWebEngineScript()

Создает нулевой скрипт.

QWebEngineScript::QWebEngineScript(const QWebEngineScript &other)

Создает пользовательский скрипт, используя содержимое other.

QWebEngineScript::~QWebEngineScript()

Удаляет скрипт.

InjectionPoint QWebEngineScript::injectionPoint() const

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

См. также setInjectionPoint().

bool QWebEngineScript::isNull() const

Возвращает true, если скрипт равен null; в противном случае возвращает false.

QString QWebEngineScript::name() const

Возвращает имя скрипта. Может быть полезно для извлечения определенного скрипта из QWebEngineScriptCollection.

См. также setName(), QWebEngineScriptCollection::findScript() и QWebEngineScriptCollection::findScripts().

bool QWebEngineScript::runsOnSubFrames() const

Возвращает true, если скрипт выполняется на каждой вкладке страницы, или false, если он выполняется только для основной вкладки.

См. также setRunsOnSubFrames().

void QWebEngineScript::setInjectionPoint(InjectionPoint p)

Устанавливает точку выполнения скрипта на p.

См. также injectionPoint() и InjectionPoint.

void QWebEngineScript::setName(const QString &scriptName)

Устанавливает имя скрипта на scriptName.

См. также name().

void QWebEngineScript::setRunsOnSubFrames(bool on)

Выполняет скрипт на подрамках дополнительно к основному фрейму, если on возвращает true.

См. также runsOnSubFrames().

void QWebEngineScript::setSourceCode(const QString &scriptSource)

Устанавливает исходный код скрипта на scriptSource.

См. также sourceCode().

void QWebEngineScript::setWorldId(quint32 id)

Устанавливает идентификатор мира изолированного мира на id при выполнении этого скрипта.

См. также worldId().

QString QWebEngineScript::sourceCode() const

Возвращает исходный код скрипта.

См. также setSourceCode().

void QWebEngineScript::swap(QWebEngineScript &other)

Меняет содержимое скрипта с содержимым other.

quint32 QWebEngineScript::worldId() const

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

См. также setWorldId().

bool QWebEngineScript::operator!=(const QWebEngineScript &other) const

Возвращает true если скрипт не равен other, в противном случае возвращает false.

QWebEngineScript &QWebEngineScript::operator=(const QWebEngineScript &other)

Присваивает other скрипту.

bool QWebEngineScript::operator==(const QWebEngineScript &other) const

Возвращает true если скрипт равен other, в противном случае возвращает false.