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.
| Constante | Valor | Descripción |
|---|---|---|
QJSManagedValue::Undefined | 0 | El tipo ` undefined ` |
QJSManagedValue::Boolean | 1 | El tipo ` boolean ` |
QJSManagedValue::Number | 2 | El tipo « number » |
QJSManagedValue::String | 3 | El tipo « string » |
QJSManagedValue::Object | 4 | El tipo « object » |
QJSManagedValue::Symbol | 5 | El tipo « symbol » |
QJSManagedValue::Function | 6 | El 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.