QJSValue Class

Documentación de las funciones miembro

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

Construye un nuevo QJSValue con un value especial.

QJSValue::QJSValue(bool value)

Construye un nuevo QJSValue con un booleano value.

QJSValue::QJSValue(const QLatin1String &value)

Construye un nuevo QJSValue con una cadena value.

QJSValue::QJSValue(const QString &value)

Construye un nuevo QJSValue con una cadena value.

QJSValue::QJSValue(const char *value)

Construye un nuevo QJSValue con una cadena value.

QJSValue::QJSValue(double value)

Construye un nuevo QJSValue con un número value.

QJSValue::QJSValue(int value)

Construye un nuevo QJSValue con un número value.

QJSValue::QJSValue(uint value)

Construye un nuevo QJSValue con un número value.

QJSValue::QJSValue(const QJSValue &other)

Construye un nuevo QJSValue que es una copia de other.

Tenga en cuenta que si other es un objeto (es decir, isObject() devolvería true), entonces sólo 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 Move. Mueve de other a este objeto QJSValue.

[noexcept] QJSValue::~QJSValue()

Destruye este QJSValue.

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

Llama a este QJSValue como una función, pasando args como argumentos a la función, y usando el globalObject() como el objeto "this". Devuelve el valor devuelto por la función.

Si este QJSValue no es invocable, call() no hace nada y devuelve un QJSValue indefinido.

Llamar a call() puede causar que ocurra una excepción en el motor de script; en ese caso, call() devuelve el valor que fue lanzado (típicamente un objeto Error ). Puede llamar a isError() sobre el valor devuelto para determinar si se ha producido 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 el objeto `this' y pasando args como argumentos. Si el valor de retorno de la llamada al constructor es un objeto, entonces se devuelve dicho objeto; en caso contrario, se devuelve el objeto construido por defecto.

Si este QJSValue no es una función, callAsConstructor() no hace nada y devuelve un QJSValue indefinido.

Llamar a esta función puede causar que ocurra una excepción en el motor de script; en ese caso, el valor que fue lanzado (típicamente un objeto Error ) es devuelto. Puede llamar a isError() sobre el valor devuelto para determinar si se ha producido una excepción.

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

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

Llama a este QJSValue como una función, usando instance como el 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 hace nada y devuelve un QJSValue indefinido.

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

Llamar a call() puede causar una excepción en el motor de scripts; en ese caso, call() devuelve el valor que fue lanzado (típicamente un objeto Error ). Puede llamar a isError() sobre el valor devuelto para determinar si se ha producido una excepción.

Véase también call().

bool QJSValue::deleteProperty(const QString &name)

Intenta borrar la propiedad de este objeto de la dirección name. Devuelve true si la propiedad ha sido borrada, en caso contrario devuelve false.

El comportamiento de esta función es consistente con el operador delete de JavaScript. En particular:

• Las propiedades no configurables no pueden ser borradas.
• Esta función devolverá true incluso si este objeto no tiene una propiedad del tipo name (es decir, las propiedades inexistentes son "trivialmente borrables").
• Si este objeto no tiene una propiedad propia del name dado, pero un objeto de la cadena prototype() sí la tiene, la propiedad del objeto prototipo no se borra, y esta función devuelve true.

Véase 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, "Algoritmo abstracto de comparación de igualdad".

Esta función puede devolver verdadero 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 verdadero; comparar un valor indefinido con un valor nulo devuelve verdadero; comparar un objeto Number cuyo valor primitivo es 6 con un objeto String cuyo valor primitivo es "6" devuelve verdadero; y comparar el número 1 con el valor booleano true devuelve verdadero. Si desea realizar una comparación sin dicha conversión implícita de valores, utilice strictlyEquals().

Tenga en cuenta que si este QJSValue o el valor other son objetos, llamar a esta función tiene efectos secundarios en el motor de script, 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 (posiblemente provocando una excepción de script no capturada).

Véase también strictlyEquals().

QJSValue::ErrorType QJSValue::errorType() const

Devuelve el tipo de error que representa este QJSValue si es 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) del name dado, 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 del tipo name, 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.

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

bool QJSValue::isBool() const

Devuelve true si este QJSValue es del 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 del 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.

Tenga 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éase 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 borrado.

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 QJSValue es del tipo primitivo String; en caso contrario devuelve false.

Véase también toString().

bool QJSValue::isUndefined() const

Devuelve true si este QJSValue es del tipo primitivo Undefined o si el valor gestionado ha sido borrado (borrando el motor). En caso contrario devuelve false.

bool QJSValue::isUrl() const

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

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

Devuelve el valor de la propiedad de este QJSValue con el valor dado name. Si no existe tal propiedad, se devuelve undefined QJSValue.

Si la propiedad se implementa utilizando una función getter (es decir, tiene el indicador PropertyGetter activado), la llamada a property() tiene efectos secundarios en el motor de script, ya que se llamará a la función getter (posiblemente provocando 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 elementos de matriz, utilice 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 en la dirección arrayIndex.

Es posible acceder a los elementos de una matriz de dos maneras. La primera es 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();

Ambas aproximaciones consiguen el mismo resultado, excepto que la segunda:

• Es más fácil de usar (puede usar 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 llamara a property() con la representación de cadena de arrayIndex.

QJSValue QJSValue::prototype() const

Si este QJSValue es un objeto, devuelve el prototipo interno (__proto__ propiedad) de este objeto; en caso contrario devuelve un 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 con el name dado al value dado.

Si este QJSValue no es un objeto, esta función no hace nada.

Si este QJSValue no tiene ya una propiedad con el nombre name, se crea una nueva propiedad.

Para modificar elementos de un array, 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 en el arrayIndex dado al value dado.

Es posible modificar elementos de un array de dos formas. La primera es 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);

Ambas aproximaciones consiguen el mismo resultado, excepto que la segunda:

• Es más fácil de usar (puede usar 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 llamara a setProperty() con la representación de cadena de arrayIndex.

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 este objeto a prototype; si el QJSValue es nulo, establece el prototipo a nulo; en caso contrario no hace nada.

El prototipo interno no debe confundirse con la propiedad pública con nombre "prototype"; el prototipo público normalmente sólo se establece 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 QJSValue es igual a other usando 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, "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, como se muestra en la siguiente tabla:

Véase también equals().

bool QJSValue::toBool() const

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

Tenga 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 valueOf() del objeto (y posiblemente a toString()) en un intento de convertir el objeto en un valor primitivo (posiblemente provocando una excepción de script no capturada).

Véase también isBool().

QDateTime QJSValue::toDateTime() const

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

Véase también isDate().

qint32 QJSValue::toInt() const

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

Tenga en cuenta que si este QJSValue es un objeto, la llamada a esta función tiene efectos secundarios en el motor de script, 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 (posiblemente provocando una excepción de script no capturada).

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

double QJSValue::toNumber() const

Devuelve el valor numérico de este QJSValue, como se define en ECMA-262 sección 9.3, "ToNumber".

Tenga en cuenta que si este QJSValue es un objeto, la llamada a esta función tiene efectos secundarios en el motor de script, 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 (posiblemente provocando una excepción de script no capturada).

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

QJSPrimitiveValue QJSValue::toPrimitive() const

Convierte el valor en un QJSPrimitiveValue. Si el valor es de un tipo admitido por QJSPrimitiveValue, se copia el valor. De lo contrario, el valor se convierte en una cadena, y la cadena se almacena en QJSPrimitiveValue.

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 el QJSValue representa; en caso contrario, devuelve nullptr.

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

Véase también isQObject().

QString QJSValue::toString() const

Devuelve el valor de cadena de este QJSValue, como se define en ECMA-262 sección 9.8, "ToString".

Tenga en cuenta que si este QJSValue es un objeto, la llamada 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()) en un intento de convertir el objeto en un valor primitivo (posiblemente provocando una excepción de script no capturada).

Véase también isString().

quint32 QJSValue::toUInt() const

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

Tenga en cuenta que si este QJSValue es un objeto, la llamada a esta función tiene efectos secundarios en el motor de script, 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 (posiblemente provocando una excepción de script no capturada).

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; de lo contrario devuelve un QVariant inválido. Algunos tipos y objetos JavaScript tienen expresiones nativas en Qt. Estos se convierten a sus expresiones nativas. Por ejemplo

Para otros tipos, el parámetro behavior es relevante. Si se indica ConvertJSObjects, se intentará realizar una conversión con pérdidas. Los objetos JavaScript genéricos se convierten a QVariantMap. Las matrices de JavaScript se convierten a QVariantList. Cada propiedad o elemento se convierte a QVariant, recursivamente; no se siguen las referencias cíclicas. Los objetos de función JavaScript se descartan. Si se proporciona RetainJSObjects, QJSValue se envuelve en QVariant mediante QVariant::fromValue(). La conversión resultante no tiene pérdidas, pero la estructura interna de los objetos no es inmediatamente accesible.

Véase también isVariant().

QVariant QJSValue::toVariant() const

Devuelve toVariant(ConvertJSObjects).

Véase también isVariant().

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

Mueve-asigna other a este objeto QJSValue.

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

Asigna el valor other a este QJSValue.

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