En esta página

Cómo hacer que las aplicaciones sean programables

Qt ofrece soporte para la programación de aplicaciones mediante scripts con JavaScript. Las siguientes guías y referencias abarcan diversos aspectos de la programación con JavaScript y Qt.

Clases de scripts

Las siguientes clases añaden capacidades de scripting a las aplicaciones Qt.

QJSEngine

Entorno para evaluar código JavaScript

QJSPrimitiveValue

Opera con tipos primitivos según la semántica de JavaScript

QJSValue

Actúa como contenedor para los tipos de datos de Qt/JavaScript

QJSValueIterator

Iterador al estilo Java para QJSValue

Uso básico

Para evaluar código de script, se crea un objeto ` QJSEngine ` y se llama a su función `evaluate()`, pasando como argumento el código de script (texto) que se desea evaluar.

QJSEngine motor;
qDebug() << "the magic number is:" << engine.evaluate("1 + 2").toNumber();

El valor devuelto será el resultado de la evaluación (representado como un objeto ` QJSValue `); este se puede convertir a tipos estándar de C++ y Qt XML.

Las propiedades personalizadas pueden ponerse a disposición de los scripts registrándolas en el motor de scripts. La forma más sencilla de hacerlo es configurando las propiedades del objeto global del motor de scripts:

engine.globalObject().setProperty("foo", 123);
qDebug() << "foo times two is:" << engine.evaluate("foo * 2").toNumber();

Esto coloca las propiedades en el entorno de script, lo que permite que el código de script pueda acceder a ellas.

Cómo hacer que un QObject esté disponible para el motor de scripts

Cualquier instancia basada en ` QObject` puede ponerse a disposición para su uso con scripts.

Cuando se pasa un ` QObject ` a la función ` QJSEngine::newQObject()`, se crea un objeto envoltorio de Qt Script que puede utilizarse para que las señales, ranuras, propiedades y objetos hijos de ` QObject` estén disponibles para los scripts.

A continuación se muestra un ejemplo de cómo hacer que una instancia de una subclase de ` QObject ` esté disponible para el código de script con el nombre ` "myObject"`:

QJSEngine engine;
QObject *someObject = new MyObject;
QJSValue objectValue = engine.newQObject(someObject);
engine.globalObject().setProperty("myObject", objectValue);

Esto creará una variable global llamada « myObject » en el entorno de script. La variable actúa como un proxy del objeto C++ subyacente. Ten en cuenta que el nombre de la variable de script puede ser cualquiera; es decir, no depende de « QObject::objectName()».

Implicaciones para la seguridad de las aplicaciones

El modelo de seguridad de los scripts de aplicación con JavaScript sigue el mismo modelo que el del código C++: el usuario instala scripts en los que confía para ejecutarlos, del mismo modo que instala aplicaciones Qt.

Para mantener la confianza de los usuarios, los desarrolladores de aplicaciones no deben evaluar código JavaScript arbitrario. El entorno aislado (sandbox) del motor de JavaScript es solo una barrera semántica. El script se evalúa en el mismo proceso y con los mismos privilegios que el resto de la aplicación, y comparte la misma memoria. En consecuencia, se puede acceder a los objetos C++ expuestos a los scripts sin medidas de seguridad adicionales.

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