En esta página

SignalSpy QML Type

Permite la introspección de la emisión de señales. Más...

Import Statement: import QtTest
Inherits:

Item

Propiedades

Métodos

Descripción detallada

En el siguiente ejemplo, se instala un SignalSpy para supervisar la señal «clicked» en un tipo de botón definido por el usuario. Cuando se emite la señal, el valor de la propiedad count del spy aumentará.

Button {
    id: button
    SignalSpy {
        id: spy
        target: button
        signalName: "clicked"
    }
    TestCase {
        name: "ButtonClick"
        function test_click() {
            compare(spy.count, 0)
            button.clicked();
            compare(spy.count, 1)
        }
    }
}

Este tipo de prueba es adecuado para señales que se emiten de forma sincrónica. Para señales asincrónicas, se puede utilizar el método wait() para bloquear la prueba hasta que se produzca la señal (o hasta que expire el tiempo de espera).

Véase también TestCase y Prueba «Qt Quick ».

Documentación de la propiedad

count : int [read-only]

Esta propiedad define el número de veces que se ha emitido « signalName » desde « target » desde la última llamada a « clear()».

Véase también « target» , « signalName » y « clear()».

signalArguments : list [read-only]

Esta propiedad contiene una lista de los argumentos de las señales emitidas. Cada vez que se emita una señal, se añadirá un elemento a la lista, que contendrá los argumentos de dicha señal. Al conectarse a un nuevo target o a un nuevo signalName, o al llamar al método clear(), la propiedad signalArguments se restablecerá a vacía.

Véanse también signalName y clear().

signalName : string

Esta propiedad define el nombre de la señal en target que se va a escuchar.

Véase también target y count.

target : object

Esta propiedad define el objeto de destino que se utilizará para detectar las emisiones de la señal « signalName ».

Véase también « signalName » y « count ».

valid : bool [read-only]

Esta propiedad define el estado actual de la conexión de la señal. Tendrá el valor «true» cuando el « signalName » del « target » se haya conectado correctamente; en caso contrario, tendrá el valor «false».

Véase también count, target, signalName y clear().

Documentación del método

clear()

Borra count, 0 y signalArguments, dejándolos vacíos. No afecta a valid.

Véase también count y wait().

wait(timeout = 5000)

Espera a que se emita la señal « signalName » en « target », durante un máximo de « timeout » milisegundos. El caso de prueba fallará si no se emite la señal.

SignalSpy {
    id: spy
    target: button
    signalName: "clicked"
}

function test_async_click() {
    ...
    // do something that will cause clicked() to be emitted
    ...
    spy.wait()
    compare(spy.count, 1)
}

Hay dos situaciones posibles: que la señal ya se haya emitido cuando se llama a wait(), o que aún no se haya emitido. La función wait() gestiona la primera situación devolviendo inmediatamente un valor si la señal ya se ha producido.

El método clear() puede utilizarse para descartar la información sobre las señales que ya se han producido, con el fin de sincronizar wait() con futuras emisiones de señales.

Véase también clear() y TestCase::tryCompare().

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