WorkerScript QML Type
Permite el uso de subprocesos en una aplicación « Qt Quick ». Más información...
| Import Statement: | import QtQml.WorkerScript |
Propiedades
Señales
- message(jsobject msg)
Métodos
- void sendMessage(jsobject message)
Descripción detallada
Utiliza WorkerScript para ejecutar operaciones en un nuevo hilo. Esto resulta útil para ejecutar operaciones en segundo plano, de modo que el hilo principal de la interfaz gráfica de usuario no quede bloqueado.
Se pueden intercambiar mensajes entre el nuevo hilo y el hilo principal mediante ` sendMessage()` y el controlador ` onMessage() `.
Un ejemplo:
import QtQuick
Rectangle {
width: 300; height: 300
Text {
id: myText
text: 'Click anywhere'
}
WorkerScript {
id: myWorker
source: "script.mjs"
onMessage: (messageObject)=> myText.text = messageObject.reply
}
MouseArea {
anchors.fill: parent
onClicked: (mouse)=> myWorker.sendMessage({ 'x': mouse.x, 'y': mouse.y })
}
}El script de trabajo anterior especifica un archivo JavaScript, «script.mjs», que se encarga de las operaciones que se van a realizar en el nuevo hilo. Aquí está script.mjs:
WorkerScript.onMessage = function(message) {
// ... long-running operations and calculations are done here
WorkerScript.sendMessage({ 'reply': 'Mouse is at ' + message.x + ',' + message.y })
}Cuando el usuario hace clic en cualquier punto dentro del rectángulo, se llama a ` sendMessage() `, lo que activa el controlador ` WorkerScript.onMessage() ` en ` script.mjs`. A su vez, este envía un mensaje de respuesta que luego recibe el controlador ` onMessage() ` de ` myWorker`.
El ejemplo utiliza un script que es un módulo ECMAScript, ya que tiene la extensión «.mjs». Puede utilizar sentencias de importación para acceder a la funcionalidad de otros módulos y se ejecuta en modo estricto de JavaScript.
Si, por el contrario, un script de worker tiene la extensión «.js», se considera que contiene instrucciones de JavaScript sin formato y se ejecuta en modo no estricto.
Nota: Cada elemento WorkerScript creará una instancia de un motor de JavaScript independiente para garantizar un aislamiento perfecto y la seguridad entre subprocesos. Si ello conlleva un consumo de memoria demasiado elevado para tu entorno, considera la posibilidad de compartir un elemento WorkerScript.
Restricciones
Dado que la función ` WorkerScript.onMessage() ` se ejecuta en un hilo independiente, el archivo JavaScript se evalúa en un contexto separado del motor QML principal. Esto significa que, a diferencia de un archivo JavaScript normal importado a QML, el ` script.mjs ` del ejemplo anterior no puede acceder a las propiedades, métodos u otros atributos del elemento QML, ni a ninguna propiedad de contexto establecida en el objeto QML mediante ` QQmlContext`.
Además, existen restricciones en cuanto a los tipos de valores que se pueden pasar desde y hacia el script de trabajo. Consulte la documentación de ` sendMessage()` para obtener más detalles.
Los scripts de trabajador que sean código fuente JavaScript sin formato no pueden utilizar la sintaxis .import. Los scripts que sean módulos ECMAScript pueden utilizar libremente las sentencias import y export.
Documentación de propiedades
ready : bool [read-only]
Esto es así independientemente de si el « WorkerScript » se ha inicializado y está listo para recibir mensajes a través de « WorkerScript.sendMessage() ».
source : url
Aquí se almacena la URL del archivo JavaScript que implementa el controlador « WorkerScript.onMessage() » para operaciones en subprocesos.
Si el componente del nombre de archivo de la URL termina en «.mjs», el script se analiza como un módulo ECMAScript y se ejecuta en modo estricto. De lo contrario, se considera un script simple.
Documentación de Signal
message(jsobject msg)
Esta señal se emite cuando se recibe un mensaje msg procedente de un script de trabajo en otro hilo mediante una llamada a sendMessage().
Nota: El controlador correspondiente es onMessage.
Documentación del método
void sendMessage(jsobject message)
Envía el objeto ` message ` especificado a un controlador de script de trabajo en otro hilo. El otro controlador de script de trabajo puede recibir este mensaje a través del controlador `onMessage()`.
El objeto ` message ` solo puede contener valores de los siguientes tipos:
- booleano, número, cadena
- objetos y matrices de JavaScript
- Objetos ListModel (no se permite ningún otro tipo de QObject*)
Todos los objetos y matrices se copian en el ` message`. A excepción de los objetos `ListModel`, cualquier modificación que realice el otro hilo en un objeto pasado en ` message ` no se reflejará en el objeto original.
© 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.