Configuración del motor de JavaScript
La ejecución del código JavaScript puede verse afectada por algunas variables de entorno, en concreto:
| Variable de entorno | Descripción |
|---|---|
QV4_JIT_CALL_THRESHOLD | El motor de JavaScript incluye un compilador «Just-In-Time» (JIT). El JIT compila las funciones de JavaScript que se ejecutan con frecuencia en código máquina para que se ejecuten más rápido. Esta variable de entorno determina la frecuencia con la que debe ejecutarse una función para que se tenga en cuenta para la compilación JIT. El valor por defecto es 3 veces. |
QV4_FORCE_INTERPRETER | Al configurar esta variable de entorno, todas las funciones y expresiones se ejecutan a través del intérprete. El JIT nunca se utiliza, independientemente de la frecuencia con la que se llame a una función o expresión. Las funciones y expresiones pueden seguir compilándose por adelantado mediante qmlcachegen o qmlsc, pero en tiempo de ejecución solo se utiliza el código de bytes generado. Se ignora cualquier código C++ generado y el código máquina resultante del mismo. |
QV4_FAIL_ON_INVALID_AOT | El código QML compilado a C++ se valida en tiempo de ejecución. Si esta validación falla, por defecto, el código se interpreta en lugar de ejecutarse como código nativo. Con esta variable de entorno configurada, un fallo de validación provoca la finalización del programa. Esto puede resultar útil para garantizar que todo el código que puede ejecutarse como código nativo lo haga. |
QV4_SKIP_AOT_VALIDATION | Esta variable de entorno omite la validación en tiempo de ejecución del código C++ generado para el código QML compilado. Esto puede utilizarse para evitar la sobrecarga que supone la propia validación. Ten en cuenta que esto solo omite la validación. No impedirá que qmlcachegen genere el código de validación en sí. Para ello, utiliza la opción « NO_GENERATE_AOT_VALIDATION » de qt_add_qml_module. |
QV4_JS_MAX_STACK_SIZE | El motor de JavaScript reserva un área de memoria especial a modo de pila para ejecutar JavaScript. Esta pila es independiente de la pila de C++. Normalmente, esta área tiene un tamaño de 4 MB. Si esta variable de entorno contiene un número, el motor de JavaScript lo interpreta como el tamaño, en bytes, del área de memoria que se asignará como pila de JavaScript. |
QV4_GC_MAX_STACK_SIZE | Además de la pila habitual de JavaScript, el motor de JavaScript mantiene otra pila para el recolector de basura, que suele ocupar 2 MB de memoria. Si el recolector de basura necesita gestionar un número excesivo de objetos al mismo tiempo, esta pila podría desbordarse. Si contiene un número, esta variable de entorno se interpreta como el tamaño, en bytes, del área de memoria que se asignará como pila para el recolector de basura. |
QV4_STACK_SOFT_LIMIT | Cuando se establece esta variable de entorno, el motor de JavaScript lanzará una excepción «RangeError: Se ha superado el tamaño máximo de la pila de llamadas» una vez que el uso de la pila de llamadas alcance el límite blando definido. Si la variable no está establecida, el motor utiliza por defecto los límites detectados en tiempo de ejecución o los predefinidos por Qt, dependiendo del sistema operativo. |
QV4_CRASH_ON_STACKOVERFLOW | Normalmente, el motor de JavaScript intenta detectar desbordamientos de pila de C++ causados por código JavaScript excesivamente recursivo y genera una condición de error no fatal. Existen comprobaciones de recursividad distintas para la compilación y la ejecución de JavaScript. Un desbordamiento de pila durante la compilación de JavaScript indica que el código contiene objetos y funciones profundamente anidados. Un desbordamiento de pila en tiempo de ejecución indica que el código da lugar a un programa profundamente recursivo. La comprobación de esto solo está relacionada indirectamente con el tamaño de la pila de JavaScript mencionado anteriormente, ya que cada llamada a una función de JavaScript consume espacio de pila tanto en la pila de C++ como en la de JavaScript. El código que comprueba la recursión excesiva es necesariamente conservador, ya que el tamaño de pila disponible depende de muchos factores y, a menudo, puede ser personalizado por el usuario. Con esta variable de entorno configurada, el motor de JavaScript no comprueba si se producen desbordamientos de pila al compilar o ejecutar JavaScript y no generará excepciones por ellos. En su lugar, cuando la pila se desborda, el programa intenta un acceso a memoria no válido. Lo más probable es que esto provoque la terminación del programa. A su vez, el programa llega a agotar todo el espacio de pila que el sistema operativo puede proporcionar. Advertencia: el códigomalicioso podría eludir la terminación del programa y acceder a ubicaciones de memoria inesperadas de esta forma. |
QV4_MAX_CALL_DEPTH | Los desbordamientos de pila al ejecutar (a diferencia de al compilar) JavaScript se evitan controlando la profundidad de llamada: el número de invocaciones de funciones anidadas. Por defecto, se genera una excepción si la profundidad de llamada supera un número máximo ajustado al tamaño de pila predeterminado de la plataforma. Si la variable de entorno QV4_MAX_CALL_DEPTH contiene un número, este se utiliza como profundidad máxima de llamada. Ten en cuenta que el límite de recursión al compilar JavaScript no se ve afectado. La profundidad máxima de llamada por defecto es 1234 en la mayoría de las plataformas. En QNX es 640, ya que en QNX el tamaño predeterminado de la pila es menor que en la mayoría de las plataformas. |
| Este valor se utiliza para indicar al motor cuánto tiempo debe dedicar a cada paso de la recolección de basura incremental. Puede ser un número positivo, que especifica el límite de tiempo en milisegundos, o 0. Si el valor es 0, la recolección de basura deja de ser incremental. |
QV4_MM_AGGRESSIVE_GC | Al configurar esta variable de entorno, se ejecuta el recolector de basura antes de cada asignación de memoria. Esto supone un gran coste en tiempo de ejecución, pero permite detectar rápidamente muchos errores de gestión de memoria, como, por ejemplo, la eliminación manual desde C++ de un objeto que pertenece al motor QML. |
QV4_MM_CROSS_VALIDATE_INCREMENTAL_GC | Al configurar esta variable de entorno, se ejecutan pasos de depuración adicionales para detectar casos en los que el recolector de basura incremental no funciona correctamente, comparando su comportamiento con el del recolector de basura no incremental. |
QV4_PROFILE_WRITE_PERF_MAP | En Linux, se puede utilizar la utilidad perf para perfilar programas. Para analizar funciones JavaScript compiladas mediante JIT, es necesario conocer sus nombres y ubicaciones en memoria. Para proporcionar esta información, existe una convención que consiste en crear un archivo especial llamado perf-<pid>.map en /tmp, que luego lee perf. Esta variable de entorno, si se establece, hace que el JIT genere este archivo. |
QV4_SHOW_BYTECODE | Muestra en la consola el código de bytes IR generado por Qt. Debe combinarse con « QML_DISABLE_DISK_CACHE »; de lo contrario, no se mostrará el código de bytes ya almacenado en caché. |
QV4_DUMP_BASIC_BLOCKS | Muestra los bloques básicos de cada función compilada por adelantado. Los detalles de los bloques se imprimen en la consola. Además, se generan gráficos de flujo de control con el código de bytes de cada bloque en formato DOT para cada función compilada. El valor de ` QV4_DUMP_BASIC_BLOCKS ` se utiliza como ruta a la carpeta donde deben generarse los archivos DOT. Si la ruta es cualquiera de las siguientes: [«-», «1», «true»], o si no se pueden abrir los archivos, los gráficos se envían a la salida estándar (stdout) en su lugar. |
QV4_VALIDATE_BASIC_BLOCKS | Realiza comprobaciones en los bloques básicos de una función compilada previamente para validar su estructura y coherencia. Si la validación falla, se muestra un mensaje de error en la consola. |
La caché de disco de QML admite otras variables de entorno que permiten ajustar su comportamiento. En concreto, QML_DISABLE_DISK_CACHE puede resultar útil para la depuración.
© 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.