En esta página

QJSValue Class

La clase QJSValue actúa como contenedor de los tipos de datos de Qt/JavaScript. Más información...

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

Tipos públicos

enum ErrorType { GenericError, RangeError, ReferenceError, SyntaxError, TypeError, URIError }
enum ObjectConversionBehavior { ConvertJSObjects, RetainJSObjects }
enum SpecialValue { UndefinedValue, NullValue }

Funciones públicas

QJSValue(QJSValue::SpecialValue value = UndefinedValue)
QJSValue(bool value)
QJSValue(const QLatin1String &value)
QJSValue(const QString &value)
QJSValue(const char *value)
QJSValue(double value)
QJSValue(int value)
QJSValue(uint value)
QJSValue(const QJSValue &other)
QJSValue(QJSValue &&other)
~QJSValue()
QJSValue call(const QJSValueList &args = QJSValueList()) const
QJSValue callAsConstructor(const QJSValueList &args = QJSValueList()) const
QJSValue callWithInstance(const QJSValue &instance, const QJSValueList &args = QJSValueList()) const
bool deleteProperty(const QString &name)
bool equals(const QJSValue &other) const
QJSValue::ErrorType errorType() const
bool hasOwnProperty(const QString &name) const
bool hasProperty(const QString &name) const
bool isArray() const
bool isBool() const
bool isCallable() const
bool isDate() const
bool isError() const
bool isNull() const
bool isNumber() const
bool isObject() const
bool isQMetaObject() const
bool isQObject() const
bool isRegExp() const
bool isString() const
bool isUndefined() const
bool isUrl() const
QJSValue property(const QString &name) const
QJSValue property(quint32 arrayIndex) const
QJSValue prototype() const
void setProperty(const QString &name, const QJSValue &value)
void setProperty(quint32 arrayIndex, const QJSValue &value)
void setPrototype(const QJSValue &prototype)
bool strictlyEquals(const QJSValue &other) const
bool toBool() const
QDateTime toDateTime() const
qint32 toInt() const
double toNumber() const
QJSPrimitiveValue toPrimitive() const
const QMetaObject *toQMetaObject() const
QObject *toQObject() const
QString toString() const
quint32 toUInt() const
QVariant toVariant(QJSValue::ObjectConversionBehavior behavior) const
QVariant toVariant() const
QJSValue &operator=(QJSValue &&other)
QJSValue &operator=(const QJSValue &other)

Descripción detallada

QJSValue admite los tipos definidos en el estándar ECMA-262: los tipos primitivos, que son Undefined, Null, Boolean, Number y String; y los tipos Object y Array. Además, se proporciona soporte integrado para tipos de Qt/C++ como QVariant y QObject.

Para los tipos basados en objetos (incluidos Date y RegExp), utiliza las funciones newT() de QJSEngine (por ejemplo, QJSEngine::newObject()) para crear un QJSValue del tipo deseado. Para los tipos primitivos, utiliza una de las sobrecargas del constructor de QJSValue. Para otros tipos, por ejemplo, los tipos de gadgets registrados como QPoint, puedes utilizar QJSEngine::toScriptValue.

Los métodos denominados isT() (p. ej., isBool(), isUndefined()) pueden utilizarse para comprobar si un valor es de un tipo determinado. Los métodos denominados toT() (p. ej., toBool(), toString()) pueden utilizarse para convertir un QJSValue a otro tipo. También puedes utilizar la función genérica qjsvalue_cast().

Los valores de tipo objeto tienen cero o más propiedades que, a su vez, son QJSValues. Utiliza setProperty() para establecer una propiedad de un objeto y llama a property() para recuperar el valor de una propiedad.

QJSEngine myEngine;
QJSValue myObject = myEngine.newObject();
QJSValue myOtherObject = myEngine.newObject();
myObject.setProperty("myChild", myOtherObject);
myObject.setProperty("name", "John Doe");

Si deseas iterar sobre las propiedades de un objeto de script, utiliza la clase ` QJSValueIterator `.

Los valores de objeto tienen una propiedad interna prototype, a la que se puede acceder mediante prototype() y setPrototype().

Los objetos de función (objetos para los que isCallable()) devuelve «true») pueden invocarse llamando a call(). Las funciones constructoras pueden utilizarse para crear nuevos objetos llamando a callAsConstructor().

Utiliza equals() o strictlyEquals() para comparar un QJSValue con otro.

Ten en cuenta que un QJSValue para el que isObject() devuelve «true» solo contiene una referencia a un objeto real; al copiar el QJSValue solo se copiará la referencia al objeto, no el objeto en sí. Si desea clonar un objeto (es decir, copiar las propiedades de un objeto a otro), puede hacerlo mediante la instrucción « for-in » en el código de script, o « QJSValueIterator » en C++.

Trabajar con matrices

Para crear una matriz utilizando QJSValue, utiliza QJSEngine::newArray():

// Assumes that this class was declared in QML.
QJSValue jsArray = engine->newArray(3);

Para establecer elementos individuales en la matriz, utiliza la sobrecarga setProperty(quint32 arrayIndex, const QJSValue &value). Por ejemplo, para rellenar la matriz anterior con números enteros:

for (int i = 0; i < 3; ++i) {
    jsArray.setProperty(i, QRandomGenerator::global().generate());
}

Para determinar la longitud del array, acceda a la propiedad ` "length" `. Para acceder a los elementos del array, utilice la sobrecarga ` property(quint32 arrayIndex)`. El siguiente código lee el array que hemos creado anteriormente y lo vuelve a introducir en una lista:

QList<int> integers;
const int length = jsArray.property("length").toInt();
for (int i = 0; i < length; ++i) {
    integers.append(jsArray.property(i).toInt());
}

Conversión a JSON

Es posible convertir un QJSValue a un tipo JSON. Por ejemplo, para convertirlo a un array, utiliza QJSEngine::fromScriptValue():

const QJsonValue jsonValue = engine.fromScriptValue<QJsonValue>(jsValue);
const QJsonArray jsonArray = jsonValue.toArray();

Véase también QJSEngine y QJSValueIterator.

Documentación sobre los tipos de miembros

enum QJSValue::ErrorType

Utiliza esta enumeración para los tipos de objetos Error específicos del lenguaje JavaScript.

Pueden resultar útiles cuando la emulación de características del lenguaje en C++ requiere el uso de tipos de excepción especializados. Además, pueden ayudar a comunicar con mayor claridad ciertas condiciones típicas, en lugar de lanzar una excepción genérica de JavaScript. Por ejemplo, en el código relacionado con redes y localizadores de recursos, puede resultar útil propagar errores relacionados con localizadores mal formados utilizando el tipo URIError.

ConstanteValorDescripción
QJSValue::GenericError1Un objeto Error genérico, pero no de un subtipo específico.
QJSValue::RangeError3Un valor no se ajusta al conjunto o rango esperado.
QJSValue::ReferenceError4Se ha hecho referencia a una variable que no existe.
QJSValue::SyntaxError5Se ha encontrado un token o una secuencia de tokens no válida que no se ajusta a la sintaxis del lenguaje.
QJSValue::TypeError6Un operando o argumento es incompatible con el tipo esperado.
QJSValue::URIError7Se ha utilizado incorrectamente una función de gestión de URI o la URI proporcionada tiene un formato incorrecto.

enum QJSValue::ObjectConversionBehavior

Esta enumeración se utiliza para especificar cómo deben tratarse los objetos y símbolos de JavaScript que no tienen un tipo nativo equivalente en Qt al convertirlos a QVariant.

ConstanteValorDescripción
QJSValue::ConvertJSObjects0Se intenta realizar una conversión «lo mejor posible», que puede conllevar pérdidas. Los símbolos se convierten a ` QString`.
QJSValue::RetainJSObjects1El valor se conserva como ` QJSValue ` envuelto en ` QVariant`.

enum QJSValue::SpecialValue

Esta enumeración se utiliza para especificar un tipo de valor único.

ConstanteValorDescripción
QJSValue::UndefinedValue1Un valor no definido.
QJSValue::NullValue0Un valor nulo.

Documentación de funciones de miembro

QJSValue::QJSValue(QJSValue::SpecialValue value = UndefinedValue)

Crea un nuevo objeto `QJSValue` con un ` value` especial.

QJSValue::QJSValue(bool value)

Crea un nuevo objeto `QJSValue` con un valor booleano ` value`.

QJSValue::QJSValue(const QLatin1String &value)

Crea un nuevo objeto QJSValue con la cadena « value ».

QJSValue::QJSValue(const QString &value)

Crea un nuevo objeto QJSValue con la cadena « value ».

QJSValue::QJSValue(const char *value)

Crea un nuevo objeto QJSValue con la cadena « value ».

QJSValue::QJSValue(double value)

Crea un nuevo objeto QJSValue con un número value.

QJSValue::QJSValue(int value)

Crea un nuevo objeto `QJSValue` con el número ` value`.

QJSValue::QJSValue(uint value)

Crea un nuevo objeto QJSValue con un número value.

QJSValue::QJSValue(const QJSValue &other)

Crea un nuevo objeto `QJSValue` que es una copia de ` other`.

Ten en cuenta que, si other es un objeto (es decir, si isObject() devolvería true), solo se copia una referencia al objeto subyacente en el nuevo valor de script (es decir, no se copia el objeto en sí).

QJSValue::QJSValue(QJSValue &&other)

Constructor de traslado. Traslada los datos de other a este objeto QJSValue.

[noexcept] QJSValue::~QJSValue()

Elimina esto: QJSValue.

QJSValue QJSValue::call(const QJSValueList &args = QJSValueList()) const

Llama a « QJSValue » como una función, pasando « args » como argumentos a la función y utilizando «globalObject()» como objeto «this». Devuelve el valor que devuelve la función.

Si este ` QJSValue ` no es invocable, `call()` no realiza ninguna acción y devuelve un ` QJSValue` indefinido.

La llamada a `call()` puede provocar que se produzca una excepción en el motor de scripts; en ese caso, `call()` devuelve el valor que se lanzó (normalmente un objeto ` Error `). Se puede llamar a ` isError()` sobre el valor devuelto para determinar si se produjo una excepción.

Véase también isCallable(), callWithInstance() y callAsConstructor().

QJSValue QJSValue::callAsConstructor(const QJSValueList &args = QJSValueList()) const

Crea un nuevo ` Object ` y llama a este ` QJSValue ` como constructor, utilizando el objeto creado como objeto `this` y pasando ` args ` como argumentos. Si el valor devuelto por la llamada al constructor es un objeto, se devuelve dicho objeto; en caso contrario, se devuelve el objeto construido por defecto.

Si este ` QJSValue ` no es una función, `callAsConstructor()` no realiza ninguna acción y devuelve un ` QJSValue` indefinido.

La llamada a esta función puede provocar que se produzca una excepción en el motor de scripts; en ese caso, se devuelve el valor que se lanzó (normalmente un objeto ` Error `). Se puede llamar a ` isError()` sobre el valor devuelto para determinar si se produjo una excepción.

Véase también call() y QJSEngine::newObject().

QJSValue QJSValue::callWithInstance(const QJSValue &instance, const QJSValueList &args = QJSValueList()) const

Llama a « QJSValue » como una función, utilizando « instance » como objeto «this» en la llamada a la función y pasando « args » como argumentos a la función. Devuelve el valor devuelto por la función.

Si este QJSValue no es una función, call() no realiza ninguna acción y devuelve un QJSValue indefinido.

Ten en cuenta que, si ` instance ` no es un objeto, se utilizará el objeto global (véase ` QJSEngine::globalObject()`) como objeto «this».

La llamada a ` call()` puede provocar que se produzca una excepción en el motor de scripts; en ese caso, ` call()` devuelve el valor que se lanzó (normalmente un objeto ` Error `). Puedes llamar a ` isError()` sobre el valor devuelto para determinar si se produjo una excepción.

Véase también call().

bool QJSValue::deleteProperty(const QString &name)

Intenta eliminar la propiedad de este objeto con el nombre « name » especificado. Devuelve «true» si se ha eliminado la propiedad; en caso contrario, devuelve «false».

El comportamiento de esta función es coherente con el operador «delete» de JavaScript. En concreto:

  • Las propiedades no configurables no se pueden eliminar.
  • Esta función devolverá «true» incluso si este objeto no tiene una propiedad con el nombre dado name (es decir, las propiedades inexistentes son «trivialmente eliminables»).
  • Si este objeto no tiene una propiedad propia con el name dado, pero sí la tiene un objeto de la cadena prototype(), la propiedad del objeto prototipo no se elimina y esta función devuelve «true».

Véanse también setProperty() y hasOwnProperty().

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

Devuelve «true» si este QJSValue es igual a other; en caso contrario, devuelve «false». La comparación sigue el comportamiento descrito en la sección 11.9.3 de ECMA-262, «El algoritmo abstracto de comparación de igualdad».

Esta función puede devolver «true» incluso si el tipo de este QJSValue es diferente del tipo del valor other; es decir, la comparación no es estricta. Por ejemplo, comparar el número 9 con la cadena «9» devuelve «true»; comparar un valor indefinido con un valor nulo devuelve «true»; comparar un objeto Number cuyo valor primitivo es 6 con un objeto String cuyo valor primitivo es «6» devuelve «true»; y comparar el número 1 con el valor booleano true devuelve «true». Si deseas realizar una comparación sin dicha conversión implícita de valores, utiliza strictlyEquals().

Ten en cuenta que, si este QJSValue o el valor other son objetos, llamar a esta función tiene efectos secundarios en el motor de scripts, ya que el motor llamará a la función valueOf() del objeto (y posiblemente a toString()) en un intento de convertir el objeto en un valor primitivo (lo que podría dar lugar a una excepción de script no detectada).

Véase también strictlyEquals().

QJSValue::ErrorType QJSValue::errorType() const

Devuelve el tipo de error que representa este QJSValue si se trata de un objeto Error. En caso contrario, devuelve NoError."

Véase también isError() y QJSEngine - Script Exceptions.

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

Devuelve «true» si este objeto tiene una propiedad propia (no heredada del prototipo) con el valor name; en caso contrario, devuelve «false».

Véase también ` property()` y ` hasProperty()`.

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

Devuelve «true» si este objeto tiene una propiedad con el nombre « name » indicado; en caso contrario, devuelve «false».

Véase también ` property()` y ` hasOwnProperty()`.

bool QJSValue::isArray() const

Devuelve «true» si este ` QJSValue ` es un objeto de la clase `Array`; en caso contrario, devuelve «false».

Nota: Este método es equivalente a ` Array.isArray() ` en JavaScript. Puedes utilizarlo para identificar matrices de JavaScript, pero devolverá ` false ` para cualquier objeto similar a una matriz que no sea una matriz de JavaScript. Esto incluye los objetos de lista de QML, tanto para tipos de valor como para tipos de objeto, las matrices tipadas de JavaScript, los objetos `ArrayBuffer` de JavaScript y cualquier objeto personalizado similar a una matriz que puedas crear tú mismo. Sin embargo, todos ellos se comportan como matrices de JavaScript: por lo general, exponen los mismos métodos y se les puede aplicar el operador de subíndice. Por lo tanto, no es recomendable utilizar este método para determinar si un objeto podría utilizarse como una matriz.

Véase también ` QJSEngine::newArray()`.

bool QJSValue::isBool() const

Devuelve «true» si este QJSValue es de tipo primitivo «Boolean»; en caso contrario, devuelve «false».

Véase también toBool().

bool QJSValue::isCallable() const

Devuelve «true» si este QJSValue es una función; en caso contrario, devuelve «false».

Véase también call().

bool QJSValue::isDate() const

Devuelve «true» si este ` QJSValue ` es un objeto de la clase `Date`; en caso contrario, devuelve «false».

bool QJSValue::isError() const

Devuelve «true» si este ` QJSValue ` es un objeto de la clase `Error`; en caso contrario, devuelve «false».

Véase también ` errorType()` y ` QJSEngine - Script Exceptions`.

bool QJSValue::isNull() const

Devuelve «true» si este ` QJSValue ` es de tipo primitivo «Null»; en caso contrario, devuelve «false».

bool QJSValue::isNumber() const

Devuelve «true» si este QJSValue es del tipo primitivo «Number»; en caso contrario, devuelve «false».

Véase también toNumber().

bool QJSValue::isObject() const

Devuelve «true» si este « QJSValue » es de tipo «Object»; en caso contrario, devuelve «false».

Ten en cuenta que los valores de función, los valores de variante y los valores de « QObject » son objetos, por lo que esta función devuelve «true» para dichos valores.

Véase también QJSEngine::newObject().

bool QJSValue::isQMetaObject() const

Devuelve «true» si este ` QJSValue ` es un ` QMetaObject`; en caso contrario, devuelve «false».

Véanse también toQMetaObject() y QJSEngine::newQMetaObject().

bool QJSValue::isQObject() const

Devuelve «true» si este QJSValue es un QObject; en caso contrario, devuelve «false».

Nota: Esta función devuelve «true» incluso si el « QObject » que envuelve este « QJSValue » ha sido eliminado.

Véase también ` toQObject()` y ` QJSEngine::newQObject()`.

bool QJSValue::isRegExp() const

Devuelve «true» si este ` QJSValue ` es un objeto de la clase `RegExp`; en caso contrario, devuelve «false».

bool QJSValue::isString() const

Devuelve «true» si este objeto ` QJSValue ` es del tipo primitivo `String`; en caso contrario, devuelve «false».

Véase también toString().

bool QJSValue::isUndefined() const

Devuelve «true» si este objeto « QJSValue » es de tipo primitivo «Undefined» o si el valor gestionado se ha borrado (al eliminar el motor). En caso contrario, devuelve «false».

bool QJSValue::isUrl() const

Devuelve «true» si este ` QJSValue ` es un objeto de la clase JavaScript `URL`; en caso contrario, devuelve «false».

Nota: Para un ` QJSValue ` que contenga un ` QUrl`, esta función devuelve `false`. Sin embargo, ` toVariant().value<QUrl>() ` funciona en ambos casos.

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

Devuelve el valor de la propiedad de este ` QJSValue` con el ` name` indicado. Si dicha propiedad no existe, se devuelve un valor indefinido ` QJSValue `.

Si la propiedad se implementa mediante una función getter (es decir, tiene activada la bandera PropertyGetter), llamar a property() tiene efectos secundarios en el motor de scripts, ya que se invocará la función getter (lo que podría provocar una excepción de script no capturada). Si se produce una excepción, property() devuelve el valor que se lanzó (normalmente un objeto Error ).

Para acceder a los elementos de una matriz, utiliza en su lugar la sobrecarga ` setProperty(quint32 arrayIndex, const QJSValue &value)`.

Véase también ` setProperty()`, ` hasProperty()` y ` QJSValueIterator`.

QJSValue QJSValue::property(quint32 arrayIndex) const

Devuelve la propiedad situada en la dirección dada arrayIndex.

Es posible acceder a los elementos de un array de dos formas. La primera consiste en utilizar el índice del array como nombre de la propiedad:

qDebug() << jsValueArray.property(QLatin1String("4")).toString();

La segunda es utilizar la sobrecarga que toma un índice:

qDebug() << jsValueArray.property(4).toString();

Ambos métodos dan el mismo resultado, salvo que el segundo:

  • Es más fácil de usar (se puede utilizar un entero directamente)
  • Es más rápido (no hay conversión a entero)

Si este ` QJSValue ` no es un objeto `Array`, esta función se comporta como si se hubiera llamado a `property()` con la representación como cadena de ` arrayIndex`.

Esta es una función sobrecargada.

QJSValue QJSValue::prototype() const

Si este QJSValue es un objeto, devuelve el prototipo interno (propiedad__proto__ ) de dicho objeto; en caso contrario, devuelve un valor indefinido QJSValue.

Véase también setPrototype() y isObject().

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

Establece el valor de la propiedad de este QJSValue, cuyo name es el indicado, en el value especificado.

Si este QJSValue no es un objeto, esta función no realiza ninguna acción.

Si este ` QJSValue ` aún no tiene una propiedad con el nombre ` name`, se crea una nueva propiedad.

Para modificar elementos de una matriz, utilice en su lugar la sobrecarga setProperty(quint32 arrayIndex, const QJSValue &value).

Véase también property() y deleteProperty().

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

Establece la propiedad de la dirección arrayIndex en el valor value.

Es posible modificar elementos de un array de dos maneras. La primera consiste en utilizar el índice del array como nombre de la propiedad:

jsValueArray.setProperty(QLatin1String("4"), value);

La segunda es utilizar la sobrecarga que toma un índice:

jsValueArray.setProperty(4, value);

Ambos métodos dan el mismo resultado, salvo que el segundo:

  • Es más fácil de usar (se puede utilizar un entero directamente)
  • Es más rápido (no hay conversión a entero)

Si este ` QJSValue ` no es un objeto `Array`, esta función se comporta como si se hubiera llamado a `setProperty()` con la representación como cadena de ` arrayIndex`.

Esta es una función sobrecargada.

Véase también property(quint32 arrayIndex) y Working With Arrays.

void QJSValue::setPrototype(const QJSValue &prototype)

Si este QJSValue es un objeto, establece el prototipo interno (propiedad__proto__ ) de dicho objeto en prototype; si QJSValue es nulo, establece el prototipo en nulo; en caso contrario, no realiza ninguna acción.

No debe confundirse el prototipo interno con la propiedad pública denominada «prototype»; el prototipo público suele establecerse únicamente en funciones que actúan como constructores.

Véase también prototype() y isObject().

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

Devuelve «true» si este valor QJSValue es igual a other mediante comparación estricta (sin conversión); en caso contrario, devuelve «false». La comparación sigue el comportamiento descrito en la sección 11.9.6 de ECMA-262, «El algoritmo de comparación de igualdad estricta».

Si el tipo de este ` QJSValue ` es diferente del tipo del valor ` other `, esta función devuelve `false`. Si los tipos son iguales, el resultado depende del tipo, tal y como se muestra en la siguiente tabla:

TipoResultado
Indefinidoverdadero
Nuloverdadero
Booleanoverdadero si ambos valores son verdaderos o falsos; falso en caso contrario
Númerofalso si alguno de los valores es NaN (Not-a-Number); verdadero si los valores son iguales; falso en caso contrario
Cadenaverdadero si ambos valores son exactamente la misma secuencia de caracteres; falso en caso contrario
Objetoverdadero si ambos valores hacen referencia al mismo objeto; falso en caso contrario

Véase también equals().

bool QJSValue::toBool() const

Devuelve el valor booleano de este ` QJSValue`, utilizando las reglas de conversión descritas en la sección 9.2 de ECMA-262, «ToBoolean».

Ten en cuenta que, si este QJSValue es un objeto, llamar a esta función tiene efectos secundarios en el motor de scripts, ya que el motor llamará a la función valueOf() del objeto (y posiblemente a toString()) para intentar convertir el objeto en un valor primitivo (lo que podría dar lugar a una excepción de script no detectada).

Véase también isBool().

QDateTime QJSValue::toDateTime() const

Devuelve una representación de tipo ` QDateTime ` de este valor, en hora local. Si este ` QJSValue ` no es una fecha, o si el valor de la fecha es `NaN` (Not-a-Number), se devuelve un ` QDateTime ` no válido.

Véase también isDate().

qint32 QJSValue::toInt() const

Devuelve el valor entero con signo de 32 bits de este ` QJSValue`, utilizando las reglas de conversión descritas en la sección 9.5 de ECMA-262, «ToInt32».

Ten en cuenta que, si este ` QJSValue ` es un objeto, llamar a esta función tiene efectos secundarios en el motor de scripts, ya que el motor llamará a la función `valueOf()` del objeto (y posiblemente a ` toString()`) en un intento de convertir el objeto en un valor primitivo (lo que podría dar lugar a una excepción de script no detectada).

Véanse también toNumber() y toUInt().

double QJSValue::toNumber() const

Devuelve el valor numérico de este ` QJSValue`, tal y como se define en la sección 9.3 de ECMA-262, «ToNumber».

Ten en cuenta que, si este ` QJSValue ` es un objeto, llamar a esta función tiene efectos secundarios en el motor de scripts, ya que el motor llamará a la función `valueOf()` del objeto (y posiblemente a ` toString()`) para intentar convertir el objeto en un valor primitivo (lo que podría dar lugar a una excepción de script no detectada).

Véanse también isNumber(), toInt() y toUInt().

QJSPrimitiveValue QJSValue::toPrimitive() const

Convierte el valor en un ` QJSPrimitiveValue`. Si el valor 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 lanzar una excepción. En concreto, los símbolos no pueden convertirse en cadenas, o bien un método personalizado ` toString()` puede lanzar una excepción. En este caso, el resultado es el valor indefinido y el motor registra un error tras la conversión.

const QMetaObject *QJSValue::toQMetaObject() const

* Si este QJSValue es un QMetaObject, devuelve el puntero QMetaObject * que representa el QJSValue; en caso contrario, devuelve nullptr. * *

Véase también isQMetaObject().

QObject *QJSValue::toQObject() const

Si este ` QJSValue ` es un ` QObject`, devuelve el puntero ` QObject ` que representa el ` QJSValue `; en caso contrario, devuelve ` nullptr`.

Si el QObject que envuelve este QJSValue ha sido eliminado, esta función devuelve nullptr (es decir, es posible que toQObject() devuelva nullptr incluso cuando isQObject() devuelva verdadero).

Véase también isQObject().

QString QJSValue::toString() const

Devuelve el valor de cadena de este ` QJSValue`, tal y como se define en la sección 9.8 de ECMA-262, «ToString».

Ten en cuenta que, si este ` QJSValue ` es un objeto, llamar a esta función tiene efectos secundarios en el motor de script, ya que el motor llamará a la función `toString()` del objeto (y posiblemente a `valueOf()`) para intentar convertir el objeto en un valor primitivo (lo que podría dar lugar a una excepción de script no detectada).

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

quint32 QJSValue::toUInt() const

Devuelve el valor entero sin signo de 32 bits de este ` QJSValue`, utilizando las reglas de conversión descritas en la sección 9.6 de ECMA-262, «ToUint32».

Ten en cuenta que, si este ` QJSValue ` es un objeto, llamar a esta función tiene efectos secundarios en el motor de scripts, ya que el motor llamará a la función `valueOf()` del objeto (y posiblemente a ` toString()`) para intentar convertir el objeto en un valor primitivo (lo que podría dar lugar a una excepción de script no detectada).

Véase también ` toNumber()` y ` toInt()`.

QVariant QJSValue::toVariant(QJSValue::ObjectConversionBehavior behavior) const

Devuelve el valor « QVariant » de este « QJSValue », si se puede convertir a un « QVariant »; en caso contrario, devuelve un « QVariant » no válido. Algunos tipos y objetos de JavaScript tienen expresiones nativas en Qt. Estos se convierten a sus expresiones nativas. Por ejemplo:

Tipo de entradaResultado
IndefinidoUn QVariant no válido.
NuloUn objeto ` QVariant ` que contiene un puntero nulo (QMetaType::Nullptr).
BooleanoUn ` QVariant ` que contiene el valor del booleano.
NúmeroUn objeto ` QVariant ` que contiene el valor del número.
CadenaUn objeto ` QVariant ` que contiene el valor de la cadena.
QVariant ObjetoEl resultado es el valor de « QVariant » del objeto (sin conversión).
QVariantMap ObjetoUn ` QVariant ` que contiene el ` QVariantMap ` almacenado en el objeto (sin conversión).
QVariantHash ObjetoUn objeto ` QVariant ` que contiene el ` QVariantHash ` almacenado en el objeto (sin conversión).
QObject ObjetoUn objeto ` QVariant ` que contiene un puntero al ` QObject`.
Objeto de fechaUn objeto ` QVariant ` que contiene el valor de fecha (`toDateTime()`).
RegularExpression ObjetoUn objeto ` QVariant ` que contiene el valor de la expresión regular.

Para otros tipos, es relevante el parámetro ` behavior `. Si se proporciona ` ConvertJSObjects `, se intenta realizar una conversión con el máximo esfuerzo posible, aunque pueda producirse alguna pérdida de información. Los objetos genéricos de JavaScript se convierten en QVariantMap. Las matrices de JavaScript se convierten en QVariantList. Cada propiedad o elemento se convierte en un QVariant, de forma recursiva; no se siguen las referencias cíclicas. Los objetos de función de JavaScript se descartan. Si se proporciona RetainJSObjects, el QJSValue se envuelve en un QVariant mediante QVariant::fromValue(). La conversión resultante no presenta pérdidas, pero no se puede acceder inmediatamente a la estructura interna de los objetos.

Véase también isVariant().

QVariant QJSValue::toVariant() const

Devuelve toVariant(ConvertJSObjects).

Esta es una función sobrecargada.

Véase también isVariant().

QJSValue &QJSValue::operator=(QJSValue &&other)

Asigna mediante «move» el objeto ` other ` a este objeto ` QJSValue `.

QJSValue &QJSValue::operator=(const QJSValue &other)

Asigna el valor de ` other ` a este ` QJSValue`.

Ten en cuenta que, si other es un objeto (isObject() devuelve «true»), solo se asignará una referencia al objeto subyacente; el objeto en sí no se copiará.

Elementos no miembros relacionados

QJSValueList

Se trata de una definición de tipo (typedef) para un ` QList` <QJSValue>.

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