QTest Namespace

Documentación de funciones

template <typename T> void QTest::addColumn(const char *name, T *dummy = 0)

Añade una columna de tipo T a los datos de prueba actuales. name es el nombre de la columna. dummy es una solución para los compiladores con errores y puede ignorarse.

Para rellenar la columna con valores, puede utilizarse newRow(). Utilice QFETCH() para obtener los datos en la prueba actual.

Ejemplo:

    QTest::addColumn<int>("intval");
    QTest::addColumn<QString>("str");
    QTest::addColumn<double>("dbl");
    QTest::newRow("row1") << 1 << "hello" << 1.5;

Véase Data Driven Testing para un ejemplo más extenso.

Véase también QTest::newRow(), QFETCH(), y QMetaType.

QTestData &QTest::addRow(const char *format, ...)

Añade una nueva fila a los datos de prueba actuales.

Los argumentos de la función se pasan a std:: snprintf () para formatearlos según format. Consulte la documentación de std::snprintf( ) para conocer las advertencias y limitaciones.

La salida de la prueba identificará la prueba ejecutada con estos datos de prueba utilizando el nombre resultante de este formateo.

Devuelve una referencia QTestData que puede utilizarse para introducir datos, un valor por cada columna de la tabla.

Ejemplo:

    QTest::addColumn<int>("input");
    QTest::addColumn<QString>("output");
    QTest::addRow("%d", 0) << 0 << QString("0");
    QTest::addRow("%d", 1) << 1 << QString("1");

Véase Data Driven Testing para un ejemplo más extenso.

Véase también newRow(), addColumn() y QFETCH().

const char *QTest::benchmarkMetricName(QTest::QBenchmarkMetric metric)

Devuelve el valor del enum metric como cadena de caracteres.

const char *QTest::benchmarkMetricUnit(QTest::QBenchmarkMetric metric)

Devuelve las unidades de medida para el metric especificado.

QPointingDevice *QTest::createTouchDevice(QInputDevice::DeviceType devType = QInputDevice::DeviceType::TouchScreen, QInputDevice::Capabilities caps = QInputDevice::Capability::Position)

Crea un dispositivo táctil ficticio de tipo devType con capacidades caps para la simulación de eventos táctiles.

El dispositivo táctil se registrará con la interfaz del sistema de ventanas Qt. Normalmente debería utilizar createTouchDevice() para inicializar una variable miembro QPointingDevice en su clase de caso de prueba, utilizar la misma instancia para todas las pruebas y eliminarla cuando ya no la necesite.

Véase también QTest::QTouchEventSequence y touchEvent().

const char *QTest::currentAppName()

Devuelve el nombre del binario que se está ejecutando actualmente.

const char *QTest::currentDataTag()

Devuelve el nombre de los datos de prueba actuales. Si la prueba no tiene ningún testdata asignado, la función devuelve nullptr.

[since 6.11] const char *QTest::currentGlobalDataTag()

Devuelve el nombre de los datos de prueba globales actuales. Si la prueba no tiene ningún testdata global asignado, la función devuelve nullptr.

Esta función se introdujo en Qt 6.11.

bool QTest::currentTestFailed()

Devuelve true si la función de prueba actual ha fallado, en caso contrario false.

Véase también QTest::currentTestResolved().

const char *QTest::currentTestFunction()

Devuelve el nombre de la función de prueba que se está ejecutando actualmente.

Ejemplo:

void MyTestClass::cleanup()
{
    if (qstrcmp(QTest::currentTestFunction(), "myDatabaseTest") == 0) {
        // clean up all database connections
        closeAllDatabases();
    }
}

[since 6.5] bool QTest::currentTestResolved()

Devuelve true si la función de prueba actual ha fallado o se ha saltado.

Se aplica si la prueba ha fallado o ha ejercido un salto. Cuando es verdadero, la función de prueba debe regresar pronto. En particular, las macros QTRY_* y el bucle de eventos de prueba terminan sus bucles antes de tiempo si se ejecutan durante la función de prueba (pero no su cleanup()). Después de que una prueba haya llamado a una función de ayuda que utiliza las macros de este módulo, puede utilizar esta función para comprobar si debe volver antes.

Esta función se introdujo en Qt 6.5.

Véase también QTest::currentTestFailed().

[since 6.3] void QTest::failOnWarning(const QRegularExpression &messagePattern)

Añade un fallo de prueba al registro de pruebas por cada advertencia que coincida con messagePattern.

La función de prueba continuará la ejecución cuando se añada un fallo. Para abortar la prueba en su lugar, puede comprobar currentTestFailed() y devolver antes de tiempo si es true.

Para cada advertencia, el primer patrón que coincida provocará un fallo, y los patrones restantes se ignorarán.

Todos los patrones se borran al final de cada función de prueba.

void FileTest::loadFiles() { QTest::failOnWarning(QRegularExpression("^Failed to load")); // Cada uno de estos causará un fallo en la prueba:    qWarning() << "Failed to load image";
    qWarning() << "Failed to load video";
}

Para fallar cada prueba que dispara una advertencia dada, pase una expresión regular adecuada a esta función en init():

void FileTest::init()
{
    QTest::failOnWarning(
        QRegularExpression("QFile::.*: File(.*) already open"));
}

Para el caso común de fallar en cualquier advertencia no pase ningún parámetro:

void FileTest::init()
{
    QTest::failOnWarning();
}

Esta función se introdujo en Qt 6.3.

Ver también QTEST_FATAL_FAIL.

[since 6.8] void QTest::failOnWarning()

Añade un fallo de prueba al registro de pruebas si se emite alguna advertencia.

Esta función se introdujo en Qt 6.8.

Véase también failOnWarning(const char *).

[since 6.3] void QTest::failOnWarning(const char *message)

Añade un fallo de prueba al registro de pruebas si se muestra message.

Esta función se introdujo en Qt 6.3.

Véase también failOnWarning().

void QTest::ignoreMessage(QtMsgType type, const char *message)

Ignora los mensajes creados por qDebug(), qInfo() o qWarning(). Si se emite el mensaje message con el correspondiente type, se eliminará del registro de la prueba. Si la prueba ha finalizado y no se ha enviado el mensaje message, se añadirá un mensaje de error al registro de la prueba.

Ejemplo:

QDir dir;
QTest::ignoreMessage(QtWarningMsg, "QDir::mkdir: Empty or null file name(s)");
dir.mkdir("");

El ejemplo anterior prueba que QDir::mkdir() emite la advertencia correcta cuando se invoca con un nombre de archivo no válido.

void QTest::ignoreMessage(QtMsgType type, const QRegularExpression &messagePattern)

Ignora los mensajes creados por qDebug(), qInfo() o qWarning(). Si se emite el mensaje que coincida con messagePattern y el correspondiente type, se eliminará del registro de la prueba. Si la prueba ha finalizado y no se ha enviado el mensaje, se añadirá un fallo de prueba al registro de la prueba.

void QTest::keyClick(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula el clic de key con un modifier opcional en un widget. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de hacer clic en la tecla.

Ejemplos:

QTest::keyClick(myWidget, Qt::Key_Escape);

QTest::keyClick(myWidget, Qt::Key_Escape, Qt::ShiftModifier, 200);

El primer ejemplo anterior simula el clic de la tecla escape sobre myWidget sin ningún modificador de teclado y sin retardo. El segundo ejemplo simula pulsar shift-escape en myWidget tras un retardo de 200 ms de la prueba.

Véase también QTest::keyClicks().

void QTest::keyClick(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula el clic de key con un modifier opcional en un widget. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de hacer clic en la tecla.

Ejemplo:

QTest::keyClick(myWidget, 'a');

El ejemplo anterior simula el clic de a sobre myWidget sin ningún modificador de teclado y sin retardo de la prueba.

Véase también QTest::keyClicks().

void QTest::keyClick(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula el clic de key con un modifier opcional en un window. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de hacer clic en la tecla.

Ejemplos:

QTest::keyClick(&myWindow, Qt::Key_Escape);
QTest::keyClick(&myWindow, Qt::Key_Escape, Qt::ShiftModifier, 200);

El primer ejemplo anterior simula el clic de la tecla escape sobre myWindow sin ningún modificador de teclado y sin retardo. El segundo ejemplo simula pulsar shift-escape en myWindow tras un retardo de 200 ms de la prueba.

Véase también QTest::keyClicks().

void QTest::keyClick(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula el clic de key con un modifier opcional en un window. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de hacer clic en la tecla.

Ejemplo:

QWidget myWindow;
QTest::keyClick(&myWindow, Qt::Key_Tab);

El ejemplo anterior simula el clic de a sobre myWindow sin ningún modificador de teclado y sin retardo de la prueba.

Véase también QTest::keyClicks().

void QTest::keyClicks(QWidget *widget, const QString &sequence, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la pulsación de un sequence de teclas en un widget. Opcionalmente, se puede especificar un teclado modifier así como un delay (en milisegundos) de la prueba antes de cada pulsación de tecla.

Ejemplo:

QTest::keyClicks(myWidget, "hello world");

El ejemplo anterior simula la pulsación de la secuencia de teclas que representa "hola mundo" en myWidget sin ningún modificador de teclado y sin retardo de la prueba.

Véase también QTest::keyClick().

void QTest::keyEvent(QTest::KeyAction action, QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Envía un evento de tecla Qt a widget con el key dado y un action asociado. Opcionalmente, se puede especificar un teclado modifier, así como un delay (en milisegundos) de la prueba antes de enviar el evento.

void QTest::keyEvent(QTest::KeyAction action, QWidget *widget, char ascii, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Envía un evento de tecla Qt a widget con la tecla dada ascii y un action asociado. Opcionalmente, se puede especificar un teclado modifier, así como un delay (en milisegundos) de la prueba antes de enviar el evento.

void QTest::keyEvent(QTest::KeyAction action, QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Envía un evento de tecla Qt a window con el key dado y un action asociado. Opcionalmente, se puede especificar un teclado modifier, así como un delay (en milisegundos) de la prueba antes de enviar el evento.

void QTest::keyEvent(QTest::KeyAction action, QWindow *window, char ascii, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Envía un evento de tecla Qt a window con la tecla dada ascii y un action asociado. Opcionalmente, se puede especificar un teclado modifier, así como un delay (en milisegundos) de la prueba antes de enviar el evento.

void QTest::keyPress(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la pulsación de un key con un modifier opcional en un widget. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de pulsar la tecla.

Véase también QTest::keyRelease() y QTest::keyClick().

void QTest::keyPress(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la pulsación de un key con un modifier opcional en un widget. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de pulsar la tecla.

Véase también QTest::keyRelease() y QTest::keyClick().

void QTest::keyPress(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la pulsación de un key con un modifier opcional en un window. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de pulsar la tecla.

Véase también QTest::keyRelease() y QTest::keyClick().

void QTest::keyPress(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la pulsación de un key con un modifier opcional en un window. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de pulsar la tecla.

Véase también QTest::keyRelease() y QTest::keyClick().

void QTest::keyRelease(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la liberación de una key con una modifier opcional en una widget. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de liberar la clave.

Véase también QTest::keyPress() y QTest::keyClick().

void QTest::keyRelease(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la liberación de un key con un modifier opcional en un widget. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de liberar la clave.

Véase también QTest::keyClick().

void QTest::keyRelease(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la liberación de un key con un modifier opcional en un window. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de liberar la clave.

Véase también QTest::keyPress() y QTest::keyClick().

void QTest::keyRelease(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

Simula la liberación de un key con un modifier opcional en un window. Si delay es mayor que 0, la prueba esperará delay milisegundos antes de liberar la clave.

Véase también QTest::keyClick().

void QTest::keySequence(QWidget *widget, const QKeySequence &keySequence)

Simula la introducción de keySequence en widget.

Véase también QTest::keyClick() y QTest::keyClicks().

void QTest::keySequence(QWindow *window, const QKeySequence &keySequence)

Simula la introducción de keySequence en window.

Véase también QTest::keyClick() y QTest::keyClicks().

void QTest::mouseClick(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Simula el clic de un ratón button con un modifier opcional en un widget. La posición del clic está definida por pos; la posición por defecto es el centro del widget. Si se especifica delay, la prueba esperará la cantidad especificada de milisegundos antes de pulsar y antes de soltar el botón.

Véase también QTest::mousePress() y QTest::mouseRelease().

void QTest::mouseClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Simula el clic de un ratón button con un modificador opcional stateKey en un window. La posición del clic está definida por pos; la posición por defecto es el centro de la ventana. Si se especifica delay, la prueba esperará la cantidad especificada de milisegundos antes de pulsar y antes de soltar el botón.

Véase también QTest::mousePress() y QTest::mouseRelease().

void QTest::mouseDClick(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Simula el doble clic de un ratón button con un modifier opcional en un widget. La posición del clic se define mediante pos; la posición por defecto es el centro del widget. Si se especifica delay, la prueba esperará la cantidad especificada de milisegundos antes de cada pulsación y liberación.

Véase también QTest::mouseClick().

void QTest::mouseDClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Simula el doble clic de un ratón button con un modificador opcional stateKey en un window. La posición del clic se define mediante pos; la posición por defecto es el centro de la ventana. Si se especifica delay, la prueba esperará la cantidad especificada de milisegundos antes de cada pulsación y liberación.

Véase también QTest::mouseClick().

void QTest::mouseMove(QWidget *widget, QPoint pos = QPoint(), int delay = -1)

Mueve el puntero del ratón a un widget. Si no se especifica pos, el puntero del ratón se mueve al centro del widget. Si se indica delay (en milisegundos), la prueba esperará antes de mover el puntero del ratón.

void QTest::mouseMove(QWindow *window, QPoint pos = QPoint(), int delay = -1)

Mueve el puntero del ratón a un window. Si no se especifica pos, el puntero del ratón se mueve al centro de la ventana. Si se indica delay (en milisegundos), la prueba esperará antes de mover el puntero del ratón.

void QTest::mousePress(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Simula la pulsación de un ratón button con un modifier opcional en un widget. La posición está definida por pos; la posición por defecto es el centro del widget. Si se especifica delay, la prueba esperará la cantidad especificada de milisegundos antes de la pulsación.

Véase también QTest::mouseRelease() y QTest::mouseClick().

void QTest::mousePress(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Simula la pulsación de un ratón button con un modificador opcional stateKey sobre un window. La posición está definida por pos; la posición por defecto es el centro de la ventana. Si se especifica delay, la prueba esperará la cantidad especificada de milisegundos antes de la pulsación.

Véase también QTest::mouseRelease() y QTest::mouseClick().

void QTest::mouseRelease(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Simula la liberación de un ratón button con un modifier opcional en un widget. La posición de la liberación está definida por pos; la posición por defecto es el centro del widget. Si se especifica delay, la prueba esperará la cantidad de milisegundos especificada antes de soltar el botón; de lo contrario, esperará la cantidad de tiempo predeterminada (1 ms), que puede anularse mediante argumentos de línea de comandos.

QSignalSpy doubleClickSpy(target, &TargetClass::doubleClicked);
const QPoint p(1, 2);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p);
QVERIFY(target.isPressed());
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.isPressed(), false);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.pressCount(), 2);
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(doubleClickSpy.count(), 1);

Véase también QTest::mousePress() y QTest::mouseClick().

void QTest::mouseRelease(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

Simula la liberación de un ratón button con un modificador opcional stateKey en window. La posición de la liberación está definida por pos; la posición por defecto es el centro de la ventana. Si se especifica delay, la prueba esperará la cantidad de milisegundos especificada antes de soltar el botón; de lo contrario, esperará una cantidad de tiempo predeterminada (1 ms), que puede anularse mediante argumentos de línea de comandos.

QSignalSpy doubleClickSpy(target, &TargetClass::doubleClicked);
const QPoint p(1, 2);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p);
QVERIFY(target.isPressed());
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.isPressed(), false);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.pressCount(), 2);
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(doubleClickSpy.count(), 1);

Véase también QTest::mousePress() y QTest::mouseClick().

QTestData &QTest::newRow(const char *dataTag)

Añade una nueva fila a los datos de prueba actuales.

La salida de la prueba identificará la ejecución de la prueba con estos datos de prueba utilizando el nombre dataTag.

Devuelve una referencia QTestData que puede utilizarse para introducir datos, un valor por cada columna de la tabla.

Ejemplo:

void MyTestClass::addSingleStringRows()
{
    QTest::addColumn<QString>("aString");
    QTest::newRow("just.hello") << QString("hello");
    QTest::newRow("a.null.string") << QString();
}

Véase Data Driven Testing para un ejemplo más extenso.

Véase también addRow(), addColumn() y QFETCH().

int QTest::qExec(QObject *testObject, int argc = 0, char **argv = nullptr)

Ejecuta las pruebas declaradas en testObject. Además, se ejecutan las ranuras privadas initTestCase(), cleanupTestCase(), init() y cleanup() si existen. Consulte Creación de una prueba para obtener más detalles.

Opcionalmente, se pueden proporcionar los argumentos de línea de comandos argc y argv. Para obtener una lista de los argumentos reconocidos, consulte Qt Test Argumentos de la línea de comandos.

El siguiente ejemplo ejecutará todas las pruebas en MyTestObject:

MyTestObject test1;
QTest::qExec(&test1);

Esta función devuelve 0 si no ha fallado ninguna prueba, o un valor distinto de 0 si han fallado una o más pruebas o en caso de excepciones no controladas. (Las pruebas omitidas no influyen en el valor de retorno).

Para aplicaciones de prueba independientes, puede utilizarse la macro QTEST_MAIN() para declarar una función main() que analiza los argumentos de la línea de comandos y ejecuta las pruebas, evitando la necesidad de llamar explícitamente a esta función.

El valor de retorno de esta función es también el código de salida de la aplicación de prueba cuando se utiliza la macro QTEST_MAIN().

En el caso de las aplicaciones de prueba independientes, esta función no debe invocarse más de una vez, ya que las opciones de la línea de comandos para registrar la salida de la prueba en archivos y ejecutar funciones de prueba individuales no se comportarán correctamente.

Si ha creado los argumentos mediante programación, en lugar de obtenerlos de los argumentos de main(), probablemente le interese utilizar QTest::qExec(QObject *, const QStringList &) ya que es seguro para Unicode.

Véase también QTEST_MAIN(), QTEST_GUILESS_MAIN(), y QTEST_APPLESS_MAIN().

int QTest::qExec(QObject *testObject, const QStringList &arguments)

Se comporta de forma idéntica a qExec(QObject *, int, char**) pero toma un QStringList de arguments en lugar de una lista char**.

QSharedPointer<QTemporaryDir> QTest::qExtractTestData(const QString &dirName)

Extrae un directorio de recursos al disco. El contenido se extrae recursivamente a una carpeta temporal. El contenido extraído se elimina automáticamente una vez que la última referencia al valor devuelto sale del ámbito.

dirName es el nombre del directorio a extraer de recursos.

Devuelve el directorio temporal donde se extrajeron los datos o null en caso de error.

[since 6.5] void QTest::qRegisterTestCase(const QString &name, QTest::TestEntryFunction entryFunction)

Registra la prueba name, con función de entrada entryFunction, en un registro central de casos de prueba para el binario actual.

name aparecerá en la lista cuando se ejecute el binario de prueba por lotes sin parámetros. Al ejecutar el binario de prueba con el argv[1] de name se llamará a entryFunction.

Esta función se introdujo en Qt 6.5.

[since 6.7] void QTest::qSleep(std::chrono::milliseconds msecs)

Sleeps para msecs, bloqueando la ejecución de la prueba.

Este método no procesará ningún evento y dejará la prueba sin respuesta. La comunicación de red puede agotarse durante la suspensión. Utilice QTest::qWait() para realizar la suspensión sin bloqueo.

msecs debe ser mayor que 0ms.

Ejemplo:

using namespace std::chrono_literals;
QTest::qSleep(250ms);

Esta función se introdujo en Qt 6.7.

Véase también QTest::qWait().

void QTest::qSleep(int ms)

Permanece inactivo durante ms milisegundos, bloqueando la ejecución de la prueba.

Equivale a llamar:

QTest::qSleep(std::chrono::milliseconds{ms});

[since 6.7] void QTest::qWait(std::chrono::milliseconds msecs)

Espera en msecs. Mientras espera, se procesarán los eventos y su prueba seguirá respondiendo a los eventos de la interfaz de usuario o de la comunicación de red.

Ejemplo:

    using namespace std::chrono_literals;
    int i = 0;
    while (myNetworkServerNotResponding() && i++ < 50)
        QTest::qWait(250ms);

El código anterior esperará hasta que el servidor de red responda un máximo de unos 12,5 segundos.

Las macros QTRY_* suelen ser una mejor opción que qWait(). qWait() siempre hace una pausa durante todo el tiempo de espera, lo que puede dejar la prueba inactiva y ralentizar la ejecución.

Las macros de QTRY_* sondean la condición hasta que tiene éxito o expira el tiempo de espera. De este modo, la prueba continúa lo antes posible y es más fiable. Si la condición sigue fallando, las macros duplican el tiempo de espera una vez e informan del nuevo valor para que puedas ajustarlo.

Por ejemplo, reescriba el código anterior como:

QTRY_VERIFY_WITH_TIMEOUT(!myNetworkServerNotResponding(), 12.5s);

Esta función se introdujo en Qt 6.7.

Véase también QTest::qSleep(), QSignalSpy::wait(), y QTRY_VERIFY_WITH_TIMEOUT().

void QTest::qWait(int msecs)

Espera a msecs. Equivale a llamar:

QTest::qWait(std::chrono::milliseconds{msecs});

[since 6.7] template <typename Functor> bool QTest::qWaitFor(Functor predicate, QDeadlineTimer deadline = QDeadlineTimer( defaultTryTimeout.load(std::memory_order_relaxed)))

Espera hasta que deadline haya expirado, o hasta que predicate devuelva verdadero, lo que ocurra primero.

Devuelve true si predicate devolvió verdadero en algún momento, de lo contrario devuelve false.

Ejemplo:

    MyObject obj;
    obj.startup();
    using namespace std::chrono_literals;
    const bool result = QTest::qWaitFor([&obj]() { return obj.isReady(); },
                                        QDeadlineTimer(3s));

El código anterior esperará a que el objeto esté listo, durante un máximo de tres segundos.

Esta función se introdujo en Qt 6.7.

template <typename Functor> bool QTest::qWaitFor(Functor predicate, int timeout)

Espera durante timeout milisegundos o hasta que predicate devuelva verdadero.

Esto es equivalente a llamar:

qWaitFor(predicate, QDeadlineTimer(timeout));

[since 6.10] bool QTest::qWaitForWindowActive(QWidget *widget, QDeadlineTimer timeout)

Devuelve true si widget está activo en timeout milisegundos. En caso contrario, devuelve false.

El método es útil en pruebas que llaman a QWidget::show() y dependen de que el widget esté realmente activo (es decir, que sea visible y tenga el foco) antes de continuar.

Esta función se introdujo en Qt 6.10.

Véase también qWaitForWindowExposed() y QWidget::isActiveWindow().

[since 6.10] bool QTest::qWaitForWindowActive(QWindow *window, QDeadlineTimer timeout)

Devuelve true, si window está activo dentro de timeout. En caso contrario devuelve false.

El método es útil en pruebas que llaman a QWindow::show() y dependen de que la ventana esté realmente activa (es decir, que sea visible y tenga el foco) antes de continuar.

Esta función se introdujo en Qt 6.10.

Ver también qWaitForWindowExposed(), qWaitForWindowFocused(), y QWindow::isActive().

[since 6.10] bool QTest::qWaitForWindowActive(QWidget *widget)

Esta función utiliza el tiempo de espera por defecto de 5 segundos.

Esta función se introdujo en Qt 6.10.

[since 6.10] bool QTest::qWaitForWindowActive(QWindow *window)

Esta función utiliza el tiempo de espera por defecto de 5 segundos.

Esta función se introdujo en Qt 6.10.

bool QTest::qWaitForWindowActive(QWidget *widget, int timeout)

La dirección timeout está en milisegundos.

bool QTest::qWaitForWindowActive(QWindow *window, int timeout)

La dirección timeout está en milisegundos.

[since 6.10] bool QTest::qWaitForWindowExposed(QWidget *widget, QDeadlineTimer timeout)

Devuelve true si widget se expone en timeout milisegundos. En caso contrario, devuelve false.

El método es útil en pruebas que llaman a QWidget::show() y dependen de que el widget esté realmente visible antes de continuar.

Esta función se introdujo en Qt 6.10.

Véase también qWaitForWindowActive(), QWidget::isVisible(), y QWindow::isExposed().

[since 6.10] bool QTest::qWaitForWindowExposed(QWindow *window, QDeadlineTimer timeout)

Devuelve true, si window está expuesta dentro de timeout. En caso contrario devuelve false.

El método es útil en pruebas que llaman a QWindow::show() y dependen de que la ventana sea realmente visible antes de continuar.

Esta función se introdujo en Qt 6.10.

Véase también qWaitForWindowActive() y QWindow::isExposed().

[since 6.10] bool QTest::qWaitForWindowExposed(QWidget *widget)

Esta función utiliza el tiempo de espera por defecto de 5 segundos.

Esta función se introdujo en Qt 6.10.

[since 6.10] bool QTest::qWaitForWindowExposed(QWindow *window)

Esta función utiliza el tiempo de espera por defecto de 5 segundos.

Esta función se introdujo en Qt 6.10.

bool QTest::qWaitForWindowExposed(QWidget *widget, int timeout)

La dirección timeout está en milisegundos.

bool QTest::qWaitForWindowExposed(QWindow *window, int timeout)

La dirección timeout está en milisegundos.

[since 6.7] bool QTest::qWaitForWindowFocused(QWidget *widget, QDeadlineTimer timeout)

Devuelve true, si widget es la ventana de foco dentro de timeout. En caso contrario devuelve false.

El método es útil en pruebas que llaman a QWidget::show() y dependen de que el widget tenga el foco (para recibir eventos de teclado, por ejemplo) antes de continuar.

Esta función se introdujo en Qt 6.7.

Ver también qWaitForWindowExposed(), qWaitForWindowActive(), y QGuiApplication::focusWindow().

[since 6.7] bool QTest::qWaitForWindowFocused(QWindow *window, QDeadlineTimer timeout)

Devuelve true, si window es la ventana de foco dentro de timeout. En caso contrario devuelve false.

El método es útil en pruebas que llaman a QWindow::show() y dependen de que la ventana tenga el foco (para recibir eventos de teclado, por ejemplo) antes de continuar.

Esta función se introdujo en Qt 6.7.

Ver también qWaitForWindowExposed(), qWaitForWindowActive(), y QGuiApplication::focusWindow().

[since 6.10] bool QTest::qWaitForWindowFocused(QWidget *widget)

Esta función utiliza el tiempo de espera por defecto de 5 segundos.

Esta función se introdujo en Qt 6.10.

[since 6.10] bool QTest::qWaitForWindowFocused(QWindow *window)

Esta función utiliza el tiempo de espera por defecto de 5 segundos.

Esta función se introdujo en Qt 6.10.

void QTest::setBenchmarkResult(qreal result, QTest::QBenchmarkMetric metric)

Establece el resultado del benchmark para esta función de prueba en result.

Utilice esta función si desea informar de los resultados del benchmark sin utilizar la macro QBENCHMARK. Utilice metric para especificar cómo Qt Test debe interpretar los resultados.

El contexto para el resultado será el nombre de la función de prueba y cualquier etiqueta de datos de la función _data. Esta función sólo puede invocarse una vez en cada función de prueba; las llamadas posteriores sustituirán a los resultados anteriores.

Tenga en cuenta que el argumento de línea de comandos -iterations no tiene ningún efecto en las funciones de prueba sin la macro QBENCHMARK.

[noexcept, since 6.8] void QTest::setThrowOnFail(bool enable)

Habilita (enable = true) o deshabilita ( enable = false) el lanzamiento en fallos de QCOMPARE()/QVERIFY() (en lugar de limitarse a volver del contexto de la función inmediatamente circundante).

La función se cuenta por referencias: Si llamas a esta función N veces con true, necesitas llamarla N veces con false para volver a donde empezaste.

Esta llamada no tiene efecto cuando la macro C++ QTEST_THROW_ON_FAIL está definida.

Esta función se introdujo en Qt 6.8.

Ver también setThrowOnSkip(), ThrowOnFailEnabler, ThrowOnFailDisabler, y QTEST_THROW_ON_FAIL.

[noexcept, since 6.8] void QTest::setThrowOnSkip(bool enable)

Habilita (enable = true) o deshabilita ( enable = false) el lanzamiento en QSKIP() (en lugar de simplemente volver del contexto de la función inmediatamente circundante).

La función se cuenta por referencias: Si llama a esta función N veces con true, necesita llamarla N veces con false para volver a donde empezó.

Esta llamada no tiene efecto cuando la macro C++ QTEST_THROW_ON_SKIP está definida.

Esta función se introdujo en Qt 6.8.

Ver también setThrowOnFail(), ThrowOnSkipEnabler, ThrowOnSkipDisabler, y QTEST_THROW_ON_SKIP.

char *QTest::toHexRepresentation(const char *ba, qsizetype length)

Devuelve un puntero a una cadena que es la cadena ba representada como una secuencia de caracteres hexadecimales separados por espacios. Si la entrada se considera demasiado larga, se trunca. Una trucación se indica en la cadena devuelta como una elipsis al final. El llamante tiene la propiedad del puntero devuelto y debe asegurarse de que se pasa posteriormente al operador delete[].

length es la longitud de la cadena ba.

char *toString(QSizePolicy sp)

Devuelve una representación textual de la política de tamaño sp.

template <typename T> char *QTest::toString(const T &value)

Devuelve una representación textual de value. Esta función es utilizada por QCOMPARE() para mostrar información detallada en caso de fallo de la prueba.

Puede añadir especializaciones o sobrecargas de esta función a su prueba para habilitar la salida detallada.

Ejemplo de especialización (Qt ≤ 5.4):

namespace QTest {
    template<>
    char *toString(const MyPoint &point)
    {
        const QByteArray ba("MyPoint("
                            + QByteArray::number(point.x()) + ", "
                            + QByteArray::number(point.y()) + ')');
        return qstrdup(ba.data());
    }
}

El ejemplo anterior define una especialización toString() para una clase llamada MyPoint. Siempre que falle una comparación de dos instancias de MyPoint, QCOMPARE() llamará a esta función para mostrar el contenido de MyPoint en el registro de pruebas.

Mismo ejemplo, pero con sobrecarga (Qt ≥ 5.5):

namespace {
    char *toString(const MyPoint &point)
    {
        return QTest::toString("MyPoint(" +
                               QByteArray::number(point.x()) + ", " +
                               QByteArray::number(point.y()) + ')');
    }
}

Véase también QCOMPARE().

char *toString(QSizePolicy::ControlType ct)

Devuelve una representación textual del tipo de control ct.

char *toString(QSizePolicy::ControlTypes cts)

Devuelve una representación textual de los tipos de control cts.

char *toString(QSizePolicy::Policy p)

Devuelve una representación textual de la política p.

char *QTest::toString(const QByteArray &ba)

Devuelve una representación textual de la matriz de bytes ba.

Véase también QTest::toHexRepresentation().

char *QTest::toString(const QCborError &c)

Devuelve una representación textual del error CBOR dado c.

char *QTest::toString(const QChar &character)

Devuelve una representación textual de la dirección character.

char *QTest::toString(const QDate &date)

Devuelve una representación textual de la dirección date.

char *QTest::toString(const QDateTime &dateTime)

Devuelve una representación textual de la fecha y hora especificadas por dateTime.

[since 6.5] char *QTest::toString(const QKeySequence &ks)

Devuelve una representación textual de la secuencia de teclas ks.

Esta función se introdujo en Qt 6.5.

char *QTest::toString(const QLatin1StringView &string)

Devuelve una representación textual de la dirección string.

char *QTest::toString(const QPoint &point)

Devuelve una representación textual de la dirección point.

char *QTest::toString(const QPointF &point)

Devuelve una representación textual de la dirección point.

char *QTest::toString(const QRect &rectangle)

Devuelve una representación textual de la dirección rectangle.

char *QTest::toString(const QRectF &rectangle)

Devuelve una representación textual de la dirección rectangle.

char *QTest::toString(const QSize &size)

Devuelve una representación textual de la dirección size.

char *QTest::toString(const QSizeF &size)

Devuelve una representación textual de la dirección size.

char *QTest::toString(const QString &string)

Devuelve una representación textual de la dirección string.

char *QTest::toString(const QStringView &string)

Devuelve una representación textual de la dirección string.

char *QTest::toString(const QTime &time)

Devuelve una representación textual de la dirección time.

char *QTest::toString(const QUrl &url)

Devuelve una representación textual de la dirección url.

char *QTest::toString(const QUuid &uuid)

Devuelve una representación textual de la dirección uuid.

char *QTest::toString(const QVariant &variant)

Devuelve una representación textual de la dirección variant.

char *QTest::toString(const QVector2D &v)

Devuelve una representación textual del vector 2D v.

char *QTest::toString(const QVector3D &v)

Devuelve una representación textual del vector 3D v.

char *QTest::toString(const QVector4D &v)

Devuelve una representación textual del vector 4D v.

template <typename T1, typename T2> char *QTest::toString(const std::pair<T1, T2> &pair)

Devuelve una representación textual de pair.

template <typename... Types> char *QTest::toString(const std::tuple<Types...> &tuple)

Devuelve una representación textual de la dirección tuple.

char *QTest::toString(std::nullptr_t)

Devuelve una cadena que contiene nullptr.

QTest::QTouchEventWidgetSequence QTest::touchEvent(QWidget *widget, QPointingDevice *device, bool autoCommit = true)

Crea y devuelve un QTouchEventSequence para el device para simular eventos para widget.

Al añadir eventos táctiles a la secuencia, widget también se utilizará para traducir la posición proporcionada a coordenadas de pantalla, a menos que se proporcione otro widget en las respectivas llamadas a press(), move(), etc.

Los eventos táctiles se registran en el sistema de eventos cuando se llama al destructor de QTouchEventSequence (es decir, cuando el objeto devuelto sale del ámbito), a menos que autoCommit sea falso. Cuando autoCommit es falso, commit() tiene que ser llamado manualmente.

createTouchDevice() puede ser llamado para crear un dispositivo táctil de prueba para su uso con esta función.

QTest::QTouchEventSequence QTest::touchEvent(QWindow *window, QPointingDevice *device, bool autoCommit = true)

Crea y devuelve un QTouchEventSequence para el device para simular eventos para window.

Al añadir eventos táctiles a la secuencia, window también se utilizará para traducir la posición proporcionada a coordenadas de pantalla, a menos que se proporcione otra ventana en las respectivas llamadas a press(), move(), etc.

Los eventos táctiles se registran en el sistema de eventos cuando se llama al destructor de QTouchEventSequence (es decir, cuando el objeto devuelto sale del ámbito), a menos que autoCommit sea falso. Cuando autoCommit es falso, commit() tiene que ser llamado manualmente.

createTouchDevice() puede ser llamado para crear un dispositivo táctil de prueba para su uso con esta función.

[since 6.8] void QTest::wheelEvent(QWindow *window, QPointF pos, QPoint angleDelta, QPoint pixelDelta = QPoint(0, 0), Qt::KeyboardModifiers stateKey = Qt::NoModifier, Qt::ScrollPhase phase = Qt::NoScrollPhase)

Simula un evento de rueda dentro de window en la posición pos en coordenadas locales de la ventana. angleDelta contiene el ángulo de rotación de la rueda. Un valor positivo significa rotación hacia delante, y uno negativo hacia atrás. pixelDelta contiene la distancia de desplazamiento en píxeles en pantalla. Este valor puede ser nulo. Los estados del teclado en el momento del evento se especifican en stateKey. La fase de desplazamiento del evento se especifica en phase.

Esta función se introdujo en Qt 6.8.