WebEngineScriptCollection QML Type

Manages a collection of user scripts. More...

• List of all members, including inherited members

Properties

• collection : list<WebEngineScript>

Methods

• void clear()
• void contains(WebEngineScript script)
• list<WebEngineScript> find(string name)
• void insert(WebEngineScript script)
• void insert(list<WebEngineScript> list)
• bool remove(WebEngineScript script)

Detailed Description

WebEngineScriptCollection handles a user scripts collection, which is injected in the JavaScript engine during the loading of web content.

Use WebEgineView.userScripts and WebEngineProfile.userScripts to access the collection of scripts associated with a single page or number of pages sharing the same profile.

The collection of user script objects in QML can be created for a set of user script objects by simple assignment to WebEngineScriptCollection.collection property or by WebEngineScriptCollection methods.

See the following code snippets demonstrating the usage:

• collection property with JavaScript dictionaries

  var scriptFoo = { name: "Foo",
                  sourceUrl: Qt.resolvedUrl("foo.js"),
                  injectionPoint: WebEngineScript.DocumentReady }
  
  webEngineView.userScripts.collection = [ scriptFoo, scriptBar ];

• collection property with user script object as value type

  var script = WebEngine.script()
  script.name = "FOO"
  webEngineView.userScripts.collection = [ script ]

• user script collection insert method can be used only with value type or list of value types

  var script = WebEngine.script()
  script.name = "FOO"
  webEngineView.userScripts.insert(script)
  
  var list = [ script ]
  webEngineView.userScripts.insert(list)

See also WebEngineScript and WebEngineScriptCollection.

Property Documentation

Method Documentation