En esta página

WebEngineScriptCollection QML Type

Gestiona una colección de scripts de usuario. Más...

Import Statement: import QtWebEngine
Since: QtWebEngine 6.2

Propiedades

  • collection : list<webEngineScript> (since QtWebEngine 6.2)

Métodos

  • void clear() (since QtWebEngine 6.2)
  • bool contains(webEngineScript script) (since QtWebEngine 6.2)
  • list<webEngineScript> find(string name) (since QtWebEngine 6.2)
  • void insert(list<webEngineScript> list) (since QtWebEngine 6.2)
  • void insert(webEngineScript script) (since QtWebEngine 6.2)
  • bool remove(webEngineScript script) (since QtWebEngine 6.2)

Descripción detallada

WebEngineScriptCollection gestiona una colección de scripts de usuario, que se inyecta en el motor JavaScript durante la carga del contenido web.

Utilice WebEgineView.userScripts y WebEngineProfile.userScripts para acceder a la colección de scripts asociados a una sola página o a varias páginas que compartan el mismo perfil.

La colección de objetos de script de usuario en QML puede crearse para un conjunto de objetos de script de usuario mediante una simple asignación a la propiedad WebEngineScriptCollection.collection o mediante métodos WebEngineScriptCollection.

Nota: El nuevo script de usuario puede instanciarse con diccionarios JavaScript cuando se utiliza la propiedad collection.

Vea los siguientes fragmentos de código que demuestran el uso:

  • propiedad collection con diccionarios JavaScript
    var scriptFoo = { name: "Foo",
                    sourceUrl: Qt.resolvedUrl("foo.js"),
                    injectionPoint: WebEngineScript.DocumentReady }
    
    webEngineView.userScripts.collection = [ scriptFoo, scriptBar ];
  • propiedad collection con objeto script de usuario como tipo de valor
    var script = WebEngine.script()
    script.name = "FOO"
    webEngineView.userScripts.collection = [ script ]
  • el método de inserción de la colección del script de usuario sólo se puede utilizar con un tipo de valor o una lista de tipos de valor
    var script = WebEngine.script()
    script.name = "FOO"
    webEngineView.userScripts.insert(script)
    
    var list = [ script ]
    webEngineView.userScripts.insert(list)

Véase también webEngineScript y WebEngineScriptCollection.

Documentación de propiedades

collection : list<webEngineScript> [since QtWebEngine 6.2]

Esta propiedad contiene una lista QML de valores de usuario webEngineScript. La lista puede tomar como valores el tipo de valor webEngineScript o un diccionario JavaScript.

Esta propiedad fue introducida en QtWebEngine 6.2.

Documentación del método

[since QtWebEngine 6.2] void clear()

Elimina todos los objetos script de esta colección.

Este método se introdujo en QtWebEngine 6.2.

[since QtWebEngine 6.2] bool contains(webEngineScript script)

Devuelve true si el script especificado está en la colección, false en caso contrario.

Este método se introdujo en QtWebEngine 6.2.

Véase también find().

[since QtWebEngine 6.2] list<webEngineScript> find(string name)

Devuelve una lista de todos los objetos script de usuario con la dirección name.

Este método fue introducido en QtWebEngine 6.2.

Véase también contains().

[since QtWebEngine 6.2] void insert(list<webEngineScript> list)

Inserta un list de valores webEngineScript en la colección de scripts de usuario.

Este método se introdujo en QtWebEngine 6.2.

Véase también remove().

[since QtWebEngine 6.2] void insert(webEngineScript script)

Inserta un único script en la colección.

Este método se introdujo en QtWebEngine 6.2.

Véase también remove().

[since QtWebEngine 6.2] bool remove(webEngineScript script)

Devuelve true si un script dado se elimina de la colección.

Este método se introdujo en QtWebEngine 6.2.

Véase también insert().

© 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.