Класс QWebEngineScript

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

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

Типы

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

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

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

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

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

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

Используйте 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, если скрипт нулевой; в противном случае возвращает 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() и QWebEngineScript::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.