Класс QWebEngineScript

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

Этот класс был представлен в Qt 5.5.

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

Открытые типы

Открытые функции

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

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(const QWebEngineScript &other)

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

QWebEngineScript::QWebEngineScript()

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

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

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

QWebEngineScript::~QWebEngineScript()

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

QWebEngineScript::InjectionPoint QWebEngineScript::injectionPoint() const

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

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

bool QWebEngineScript::isNull() const

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

QString QWebEngineScript::name() const

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

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

bool QWebEngineScript::runsOnSubFrames() const

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

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

void QWebEngineScript::setInjectionPoint(QWebEngineScript::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 при выполнении этого скрипта.

Должно быть между 0 и 256.

См. также 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.

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

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