En esta página

QJSManagedValue Class

QJSManagedValue representa un valor del montón de JavaScript que pertenece a un QJSEngine. Más información...

Encabezado: #include <QJSManagedValue>
CMake: find_package(Qt6 REQUIRED COMPONENTS Qml)
target_link_libraries(mytarget PRIVATE Qt6::Qml)
qmake: QT += qml
Desde: Qt 6.1

Tipos públicos

enum Type { Undefined, Boolean, Number, String, Object, …, Function }

Funciones públicas

QJSManagedValue()
QJSManagedValue(QJSValue value, QJSEngine *engine)
QJSManagedValue(const QJSPrimitiveValue &value, QJSEngine *engine)
QJSManagedValue(const QString &string, QJSEngine *engine)
QJSManagedValue(const QVariant &variant, QJSEngine *engine)
QJSManagedValue(QJSManagedValue &&other)
~QJSManagedValue()
QJSValue call(const QJSValueList &arguments = {}) const
QJSValue callAsConstructor(const QJSValueList &arguments = {}) const
QJSValue callWithInstance(const QJSValue &instance, const QJSValueList &arguments = {}) const
bool deleteProperty(const QString &name)
bool deleteProperty(quint32 arrayIndex)
QJSEngine *engine() const
bool equals(const QJSManagedValue &other) const
bool hasOwnProperty(const QString &name) const
bool hasOwnProperty(quint32 arrayIndex) const
bool hasProperty(const QString &name) const
bool hasProperty(quint32 arrayIndex) const
bool isArray() const
bool isBoolean() const
bool isDate() const
bool isError() const
bool isFunction() const
bool isInteger() const
bool isNull() const
bool isNumber() const
bool isObject() const
bool isQMetaObject() const
bool isQObject() const
bool isRegularExpression() const
bool isString() const
bool isSymbol() const
bool isUndefined() const
bool isUrl() const
bool isVariant() const
QJSValue property(const QString &name) const
QJSValue property(quint32 arrayIndex) const
QJSManagedValue prototype() const
void setProperty(const QString &name, const QJSValue &value)
void setProperty(quint32 arrayIndex, const QJSValue &value)
void setPrototype(const QJSManagedValue &prototype)
bool strictlyEquals(const QJSManagedValue &other) const
bool toBoolean() const
QDateTime toDateTime() const
int toInteger() const
QJSValue toJSValue() const
double toNumber() const
QJSPrimitiveValue toPrimitive() const
const QMetaObject *toQMetaObject() const
QObject *toQObject() const
QRegularExpression toRegularExpression() const
QString toString() const
QUrl toUrl() const
QVariant toVariant() const
QJSManagedValue::Type type() const
QJSManagedValue &operator=(QJSManagedValue &&other)

Descripción detallada

La clase QJSManagedValue permite interactuar con valores de JavaScript de la misma forma en que se puede interactuar con ellos desde el propio JavaScript. Se pueden obtener y establecer propiedades y prototipos, y se puede acceder a matrices. Además, se puede transformar el valor en los equivalentes de Qt de los objetos de JavaScript. Por ejemplo, un objeto Url se puede transformar en un QUrl.

Un `QJSManagedValue` siempre está vinculado a un ` QJSEngine` concreto. No se puede utilizar de forma independiente. Esto significa que no es posible que un `QJSManagedValue` de un motor sea una propiedad o un prototipo de un `QJSManagedValue` de otro motor.

A diferencia de ` QJSValue`, casi todos los valores que contiene un `QJSManagedValue` residen en el montón de JavaScript. No hay almacenamiento en línea ni no gestionado. Por lo tanto, se puede obtener el prototipo de un valor primitivo, así como la propiedad ` length ` de una cadena.

Solo los QJSManagedValue construidos por defecto o trasladados desde otro lugar no contienen un valor en el montón de JavaScript. Representan a ` undefined`, que no tiene propiedades ni prototipos.

Además, a diferencia de QJSValue, QJSManagedValue no captura ninguna excepción de JavaScript. Si una operación sobre un QJSManagedValue provoca un error, por lo general devolverá un valor undefined y QJSEngine::hasError() devolverá true a continuación. A continuación, puedes capturar la excepción utilizando QJSEngine::catchError(), o pasarla hacia arriba en la pila, según tu criterio.

Nota: Dado que la referencia al valor en el montón de JavaScript debe liberarse al destruirse, no se puede mover un `QJSManagedValue` a otro hilo. La destrucción tendría lugar en el nuevo hilo, lo que crearía una condición de carrera con el recolector de basura del hilo original. Esto también significa que no se puede mantener un `QJSManagedValue` más allá de la vida útil de su motor.

La forma recomendada de trabajar con un `QJSManagedValue` es crearlo en la pila, posiblemente moviendo un ` QJSValue ` y añadiendo un motor, a continuación realizar las operaciones necesarias sobre él y, por último, volver a moverlo a un ` QJSValue ` para su almacenamiento. El traslado entre `QJSManagedValue` y ` QJSValue ` es rápido.

Documentación sobre los tipos de miembros

enum QJSManagedValue::Type

Esta enumeración representa los tipos nativos de JavaScript, tal y como se especifican en ECMA-262.

ConstanteValorDescripción
QJSManagedValue::Undefined0El tipo ` undefined `
QJSManagedValue::Boolean1El tipo ` boolean `
QJSManagedValue::Number2El tipo « number »
QJSManagedValue::String3El tipo « string »
QJSManagedValue::Object4El tipo « object »
QJSManagedValue::Symbol5El tipo « symbol »
QJSManagedValue::Function6El tipo « function »

Ten en cuenta que el valor « null » no es un tipo en sí mismo, sino más bien un tipo especial de objeto. Puedes consultar un objeto « QJSManagedValue » para ver si cumple esta condición utilizando el método « isNull()». Además, JavaScript no tiene un tipo entero, pero aplica un tratamiento especial a los números para permitir operaciones exclusivas con enteros. Se puede consultar un QJSManagedValue para averiguar si contiene el resultado de dicho tratamiento utilizando el método isInteger().

Documentación de funciones de miembro

[constexpr noexcept default] QJSManagedValue::QJSManagedValue()

Crea un objeto `QJSManagedValue` que representa el valor ` undefined ` de JavaScript. Este es el único valor que no se almacena en el montón de JavaScript. Si se llama a ` engine()` sobre un objeto `QJSManagedValue` creado de forma predeterminada, se devolverá `nullptr`.

QJSManagedValue::QJSManagedValue(QJSValue value, QJSEngine *engine)

Crea un objeto `QJSManagedValue` a partir de ` value`, utilizando el montón de ` engine`. Si ` value ` es en sí mismo un objeto gestionado y el motor al que pertenece no es ` engine`, el resultado es un valor ` undefined ` y se genera una advertencia.

QJSManagedValue::QJSManagedValue(const QJSPrimitiveValue &value, QJSEngine *engine)

Crea un objeto `QJSManagedValue` a partir de un ` value ` utilizando el montón de ` engine`.

QJSManagedValue::QJSManagedValue(const QString &string, QJSEngine *engine)

Crea un objeto `QJSManagedValue` a partir de un objeto ` string ` utilizando el montón de ` engine`.

QJSManagedValue::QJSManagedValue(const QVariant &variant, QJSEngine *engine)

Crea un objeto `QJSManagedValue` a partir de un objeto ` variant ` utilizando el montón de ` engine`.

QJSManagedValue::QJSManagedValue(QJSManagedValue &&other)

Crea un objeto `QJSManagedValue` a partir de ` other`. Esto deja a ` other ` en su estado de construcción por defecto, en el que representa un valor indefinido y no pertenece a ningún motor.

[noexcept] QJSManagedValue::~QJSManagedValue()

Destruye el objeto ` QJSManagedValue`.

Nota: Esto libera el espacio de memoria que ocupa en el montón de JavaScript. No debes destruir un ` QJSManagedValue ` desde un hilo distinto al que alberga el ` QJSEngine ` al que pertenece.

QJSValue QJSManagedValue::call(const QJSValueList &arguments = {}) const

Si este ` QJSManagedValue ` representa un `FunctionObject` de JavaScript, lo invoca con el ` arguments` proporcionado y devuelve el resultado. De lo contrario, devuelve un valor ` undefined ` de JavaScript.

El arguments debe ser un valor primitivo o pertenecer al mismo QJSEngine que este QJSManagedValue. De lo contrario, la llamada no se lleva a cabo y se devuelve un valor undefined de JavaScript.

QJSValue QJSManagedValue::callAsConstructor(const QJSValueList &arguments = {}) const

Si este QJSManagedValue representa un FunctionObject de JavaScript, lo invoca como constructor con el arguments proporcionado y devuelve el resultado. De lo contrario, devuelve un valor undefined de JavaScript.

El arguments debe ser un valor primitivo o pertenecer al mismo QJSEngine que este QJSManagedValue. De lo contrario, la llamada no se lleva a cabo y se devuelve un valor de JavaScript undefined.

QJSValue QJSManagedValue::callWithInstance(const QJSValue &instance, const QJSValueList &arguments = {}) const

Si este ` QJSManagedValue ` representa un `FunctionObject` de JavaScript, lo invoca en ` instance ` con el ` arguments` proporcionado y devuelve el resultado. De lo contrario, devuelve un valor ` undefined ` de JavaScript.

El arguments y el instance deben ser valores primitivos o pertenecer al mismo QJSEngine que este QJSManagedValue. De lo contrario, la llamada no se lleva a cabo y se devuelve un valor undefined de JavaScript.

bool QJSManagedValue::deleteProperty(const QString &name)

Elimina la propiedad « name » de este « QJSManagedValue ». Devuelve « true » si la eliminación se ha realizado correctamente; en caso contrario, devuelve « false ».

bool QJSManagedValue::deleteProperty(quint32 arrayIndex)

Elimina el valor almacenado en arrayIndex de este QJSManagedValue. Devuelve true si la eliminación se ha realizado correctamente; en caso contrario, devuelve false.

QJSEngine *QJSManagedValue::engine() const

Devuelve el ` QJSEngine ` al que pertenece este ` QJSManagedValue `. Ten en cuenta que el motor siempre es válido, salvo que el ` QJSManagedValue ` se haya construido de forma predeterminada o se haya movido. En este último caso, se devuelve un `nullptr`.

bool QJSManagedValue::equals(const QJSManagedValue &other) const

Aplica el operador «==» de JavaScript a estas direcciones: QJSManagedValue y other, y devuelve el resultado.

Véase también strictlyEquals.

bool QJSManagedValue::hasOwnProperty(const QString &name) const

Devuelve « true » si este « QJSManagedValue » tiene una propiedad « name »; en caso contrario, devuelve « false ». No se tienen en cuenta las propiedades de la cadena de prototipos.

bool QJSManagedValue::hasOwnProperty(quint32 arrayIndex) const

Devuelve « true » si este « QJSManagedValue » tiene un índice de matriz « arrayIndex »; en caso contrario, devuelve « false ». No se tienen en cuenta las propiedades de la cadena de prototipos.

bool QJSManagedValue::hasProperty(const QString &name) const

Devuelve « true » si este « QJSManagedValue » tiene una propiedad « name »; en caso contrario, devuelve « false ». Se tienen en cuenta las propiedades de la cadena de prototipos.

bool QJSManagedValue::hasProperty(quint32 arrayIndex) const

Devuelve ` true ` si este ` QJSManagedValue ` tiene un índice de matriz ` arrayIndex`; en caso contrario, devuelve ` false`. Se tienen en cuenta las propiedades de la cadena de prototipos.

bool QJSManagedValue::isArray() const

Devuelve ` true ` si este valor representa un objeto `Array` de JavaScript; en caso contrario, devuelve ` false `.

bool QJSManagedValue::isBoolean() const

Devuelve « true » si el tipo de este « QJSManagedValue » es « boolean »; en caso contrario, devuelve « false ».

bool QJSManagedValue::isDate() const

Devuelve « true » si este valor representa un objeto Date de JavaScript; en caso contrario, devuelve « false ».

bool QJSManagedValue::isError() const

Devuelve ` true ` si este valor representa un objeto `Error` de JavaScript; en caso contrario, devuelve ` false `.

bool QJSManagedValue::isFunction() const

Devuelve « true » si el tipo de este « QJSManagedValue » es « function »; en caso contrario, devuelve « false ».

bool QJSManagedValue::isInteger() const

Devuelve ` true ` si este ` QJSManagedValue ` contiene un valor entero, o ` false ` en caso contrario. El formato de almacenamiento de un número no afecta al resultado de las operaciones que se realicen con él, pero si se almacena como entero, muchas operaciones se ejecutan más rápido.

bool QJSManagedValue::isNull() const

Devuelve ` true ` si este ` QJSManagedValue ` contiene el valor de JavaScript ` null `, o ` false ` en caso contrario.

bool QJSManagedValue::isNumber() const

Devuelve ` true ` si el tipo de este ` QJSManagedValue ` es ` number`; en caso contrario, devuelve ` false `.

bool QJSManagedValue::isObject() const

Devuelve « true » si el tipo de este « QJSManagedValue » es « object », o « false » en caso contrario.

bool QJSManagedValue::isQMetaObject() const

Devuelve ` true ` si este valor representa un puntero ` QMetaObject ` gestionado en el montón de JavaScript, o ` false ` en caso contrario.

bool QJSManagedValue::isQObject() const

Devuelve ` true ` si este valor representa un puntero ` QObject ` gestionado en el montón de JavaScript; en caso contrario, devuelve ` false `.

bool QJSManagedValue::isRegularExpression() const

Devuelve ` true ` si este valor representa un objeto de expresión regular de JavaScript; en caso contrario, devuelve ` false `.

bool QJSManagedValue::isString() const

Devuelve ` true ` si el tipo de este ` QJSManagedValue ` es ` string`; en caso contrario, devuelve ` false `.

bool QJSManagedValue::isSymbol() const

Devuelve « true » si el tipo de este « QJSManagedValue » es « symbol », o « false » en caso contrario.

bool QJSManagedValue::isUndefined() const

Devuelve « true » si el tipo de este « QJSManagedValue » es « undefined »; en caso contrario, devuelve « false ».

bool QJSManagedValue::isUrl() const

Devuelve « true » si este valor representa un objeto Url de JavaScript; en caso contrario, devuelve « false ».

bool QJSManagedValue::isVariant() const

Devuelve ` true ` si este valor representa un ` QVariant ` gestionado en el montón de JavaScript; en caso contrario, devuelve ` false `.

QJSValue QJSManagedValue::property(const QString &name) const

Devuelve la propiedad « name » de este « QJSManagedValue ». Si no se encuentra la propiedad en el objeto real, se busca en la cadena de prototipos.

Véase también ` setProperty()`.

QJSValue QJSManagedValue::property(quint32 arrayIndex) const

Devuelve la propiedad almacenada en ` arrayIndex ` de este ` QJSManagedValue`. Si la propiedad no se encuentra en el objeto real, se busca en la cadena de prototipos.

QJSManagedValue QJSManagedValue::prototype() const

Devuelve el prototipo de este QJSManagedValue. Esto funciona con cualquier valor. Por ejemplo, puedes recuperar el prototipo de JavaScript boolean a partir de un valor boolean.

Véase también setPrototype().

void QJSManagedValue::setProperty(const QString &name, const QJSValue &value)

Establece la propiedad « name » en « value » en este « QJSManagedValue ». Esto solo se puede hacer con valores de JavaScript del tipo « object ». Además, « value » debe ser un valor primitivo o pertenecer al mismo motor que este valor.

Véase también property().

void QJSManagedValue::setProperty(quint32 arrayIndex, const QJSValue &value)

Almacena el objeto ` value ` en ` arrayIndex ` en este ` QJSManagedValue`. Esto solo se puede hacer con valores de JavaScript del tipo ` object`, y no se recomienda si el valor no es una matriz. Además, ` value ` debe ser un valor primitivo o pertenecer al mismo motor que este valor.

void QJSManagedValue::setPrototype(const QJSManagedValue &prototype)

Establece el prototipo de este ` QJSManagedValue ` en ` prototype`. Una condición previa es que ` prototype ` pertenezca al mismo ` QJSEngine ` que este ` QJSManagedValue ` y sea un objeto (incluido `null`). Además, este ` QJSManagedValue ` también debe ser un objeto (excluido `null`), y no se pueden crear ciclos de prototipos.

Véase también prototype().

bool QJSManagedValue::strictlyEquals(const QJSManagedValue &other) const

Aplica el operador «===» de JavaScript a este QJSManagedValue y other, y devuelve el resultado.

Véase también equals.

bool QJSManagedValue::toBoolean() const

Convierte el valor gestionado en un valor booleano. Si el valor gestionado contiene un valor booleano, se devuelve ese valor. En caso contrario, se lleva a cabo una conversión a valor booleano según las reglas de JavaScript.

QDateTime QJSManagedValue::toDateTime() const

Si este objeto QJSManagedValue contiene un objeto Date de JavaScript, devuelve un objeto QDateTime equivalente. En caso contrario, devuelve uno no válido.

int QJSManagedValue::toInteger() const

Convierte el valor gestionado en un entero. Para ello, primero convierte el valor en un número según las reglas de toNumber(), y a continuación lo limita al rango de los enteros siguiendo las reglas establecidas para convertir los argumentos de los operadores de desplazamiento de bits de JavaScript en enteros de 32 bits.

Internamente, es posible que el valor ya esté almacenado como un entero, en cuyo caso se sigue una ruta rápida.

Nota: La conversión de un valor gestionado a un número puede lanzar una excepción. En concreto, los símbolos no pueden coercionarse a números, o un método `valueOf()` personalizado podría lanzar una excepción. En este caso, el resultado es 0 y el motor mantiene un error tras la conversión.

Nota: Las reglas de JavaScript para convertir números en enteros de 32 bits no son intuitivas.

QJSValue QJSManagedValue::toJSValue() const

Copia este QJSManagedValue en un nuevo QJSValue. Esto es menos eficiente que crear mediante «move» un QJSValue a partir de un QJSManagedValue, pero conserva el QJSManagedValue.

double QJSManagedValue::toNumber() const

Convierte el valor gestionado en un número. Si el valor gestionado contiene un número, se devuelve ese número. De lo contrario, se lleva a cabo una conversión a número según las reglas de JavaScript.

Nota: La conversión de un valor gestionado a un número puede provocar una excepción. En concreto, los símbolos no pueden transformarse en números, o bien un método `valueOf()` personalizado puede provocar una excepción. En este caso, el resultado es 0 y el motor registra un error tras la conversión.

QJSPrimitiveValue QJSManagedValue::toPrimitive() const

Convierte el valor gestionado en un ` QJSPrimitiveValue`. Si el valor gestionado es de un tipo compatible con ` QJSPrimitiveValue`, se copia el valor. De lo contrario, el valor se convierte en una cadena y dicha cadena se almacena en ` QJSPrimitiveValue`.

Nota: La conversión de un valor gestionado a una cadena puede provocar una excepción. En concreto, los símbolos no se pueden convertir a cadenas, o bien un método personalizado toString() puede provocar una excepción. En este caso, el resultado es el valor «undefined» y el motor registra un error tras la conversión.

const QMetaObject *QJSManagedValue::toQMetaObject() const

Si este objeto ` QJSManagedValue ` contiene un puntero ` QMetaObject `, lo devuelve. En caso contrario, devuelve `nullptr`.

QObject *QJSManagedValue::toQObject() const

Si este objeto ` QJSManagedValue ` contiene un puntero ` QObject `, lo devuelve. En caso contrario, devuelve `nullptr`.

QRegularExpression QJSManagedValue::toRegularExpression() const

Si este objeto QJSManagedValue contiene un objeto de expresiones regulares de JavaScript, devuelve un objeto equivalente QRegularExpression. En caso contrario, devuelve uno no válido.

QString QJSManagedValue::toString() const

Convierte el valor gestionado en una cadena. Si el valor gestionado contiene una cadena, se devuelve esa misma cadena. De lo contrario, se lleva a cabo una conversión a cadena según las reglas de JavaScript.

Nota: La conversión de un valor gestionado a una cadena puede provocar una excepción. En concreto, los símbolos no pueden convertirse en cadenas, o bien un método toString() personalizado podría provocar una excepción. En este caso, el resultado es una cadena vacía y el motor registra un error tras la conversión.

QUrl QJSManagedValue::toUrl() const

Si este objeto ` QJSManagedValue ` contiene un objeto `URL` de JavaScript, devuelve un objeto ` QUrl` equivalente. En caso contrario, devuelve uno no válido.

QVariant QJSManagedValue::toVariant() const

Copia este QJSManagedValue en un nuevo QVariant. Esto también crea un QVariant muy útil si QJSManagedValue::isVariant() devuelve «false». QVariant puede contener todos los tipos compatibles con QJSManagedValue.

QJSManagedValue::Type QJSManagedValue::type() const

Devuelve el tipo JavaScript de este ` QJSManagedValue`.

QJSManagedValue &QJSManagedValue::operator=(QJSManagedValue &&other)

Asigna mediante «move» un objeto ` QJSManagedValue ` procedente de other. Esto deja a other en su estado de construcción por defecto, en el que representa «undefined» y no pertenece a ningún motor.

Nota: Esto libera el espacio de memoria que ocupa este ` QJSManagedValue ` en el montón de JavaScript. No debes realizar una asignación por movimiento de un ` QJSManagedValue ` en un hilo distinto al que alberga el ` QJSEngine ` al que pertenece.

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