webEngineScript QML Value Type
Permite la inyección programática de scripts en el motor JavaScript. Más...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.1 |
| In C++: | QWebEngineScript |
Propiedades
- injectionPoint : enumeration
- name : string
- runsOnSubFrames : bool
- sourceCode : string
- sourceUrl : url
- worldId : enumeration
Descripción detallada
El tipo de valor webEngineScript permite la inyección programática de los llamados scripts de usuario en el motor JavaScript en diferentes puntos, determinados por injectionPoint, durante la carga de contenidos web.
Los scripts pueden ejecutarse en el mundo JavaScript principal, junto con el resto del JavaScript procedente de los contenidos web, o en su propio mundo aislado. Mientras que se puede acceder al DOM de la página desde cualquier mundo, las variables JavaScript de una función definida en un mundo no son accesibles desde otro diferente. La propiedad worldId proporciona algunos ID predefinidos para este propósito.
Se admiten los siguientes atributos de Greasemonkey: @exclude, @include, @name, @match, y @run-at.
Utilice WebEngineScriptCollection para acceder a una lista de scripts adjuntos a la vista web.
Documentación de propiedades
injectionPoint : enumeration
El punto del proceso de carga en el que se ejecutará el script. El valor por defecto es Deferred.
| Constante | Descripción |
|---|---|
WebEngineScript.DocumentCreation | El script se ejecutará tan pronto como se cree el documento. Esto no es adecuado para ninguna operación DOM. |
WebEngineScript.DocumentReady | El script se ejecutará tan pronto como el DOM esté listo. Esto es equivalente a la ejecución del evento DOMContentLoaded en JavaScript. |
WebEngineScript.Deferred | El script se ejecutará cuando finalice la carga de la página, o 500 ms después de que el documento esté listo, lo que ocurra primero. |
name : string
El nombre del script. Puede ser útil para recuperar un script concreto del método WebEngineScriptCollection.find.
runsOnSubFrames : bool
Establezca esta propiedad en true si el script se ejecuta en todos los fotogramas de la página, o en false si sólo se ejecuta en el fotograma principal. El valor por defecto es false.
sourceCode : string
Esta propiedad contiene el código fuente JavaScript del script de usuario.
Véase también sourceUrl.
sourceUrl : url
Esta propiedad contiene la ubicación de la fuente remota del script de usuario (si existe).
A diferencia de sourceCode, esta propiedad permite referirse a scripts de usuario que no están ya cargados en memoria, por ejemplo, cuando están almacenados en disco.
Si se establece esta propiedad, cambiará la dirección sourceCode del script.
Nota: En la actualidad, sólo se admiten fuentes basadas en archivos.
Véase también sourceCode.
worldId : enumeration
El ID del mundo que define en qué mundo aislado se ejecuta el script.
| Constante | Descripción |
|---|---|
WebEngineScript.MainWorld | El mundo utilizado por los contenidos web de la página. Puede ser útil para exponer funcionalidad personalizada a los contenidos web en determinados escenarios. |
WebEngineScript.ApplicationWorld | El mundo aislado por defecto utilizado para la funcionalidad a nivel de aplicación implementada en JavaScript. |
WebEngineScript.UserWorld | El primer mundo aislado que utilizarán los scripts establecidos por los usuarios si la aplicación no hace uso de más mundos. Como regla general, si esa funcionalidad está expuesta a los usuarios de la aplicación, cada script individual probablemente debería obtener su propio mundo aislado. |
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
