QTest Namespace

함수 문서

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

현재 테스트 데이터에 ` T ` 유형의 열을 추가합니다. ` name `은 열의 이름입니다. ` dummy `은 버그가 있는 컴파일러를 위한 임시 해결책이므로 무시해도 됩니다.

이 열에 값을 채우려면 newRow()을 사용할 수 있습니다. 실제 테스트에서 데이터를 가져오려면 QFETCH()을 사용하십시오.

예시:

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

더 자세한 예제는 ‘데이터 주도 테스트’를 참조하십시오.

QTest::newRow(), QFETCH(), QMetaType도 참조하십시오 .

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

현재 테스트 데이터에 새로운 행을 추가합니다.

이 함수의 인수는 format 에 따라 서식을 지정하기 위해 std::snprintf()로 전달됩니다. 주의사항 및 제한 사항에 대해서는 std::snprintf() 문서를 참조하십시오.

테스트 출력에서는 이 서식 지정 결과로 생성된 이름을 사용하여 이 테스트 데이터로 수행된 테스트 실행을 식별합니다.

테이블의 각 열에 대해 하나의 값씩 데이터를 스트리밍하는 데 사용할 수 있는 QTestData 참조를 반환합니다.

예시:

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

더 자세한 예제는 데이터 주도 테스트를 참조하십시오.

newRow(), addColumn(), QFETCH()도 참조하십시오 .

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

metric 열거형 값을 문자열로 반환합니다.

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

지정된 ` metric`의 측정 단위를 반환합니다.

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

터치 이벤트를 시뮬레이션하기 위해 caps 기능을 갖춘 devType 유형의 더미 터치 장치를 생성합니다.

이 터치 장치는 Qt 윈도우 시스템 인터페이스에 등록됩니다. 일반적으로 테스트 케이스 클래스에서 createTouchDevice()를 사용하여 QPointingDevice 멤버 변수를 초기화하고, 모든 테스트에 동일한 인스턴스를 사용하며, 더 이상 필요하지 않을 때 이를 삭제해야 합니다.

QTest::QTouchEventSequence 및 touchEvent()도 참조하십시오 .

const char *QTest::currentAppName()

현재 실행 중인 바이너리의 이름을 반환합니다.

const char *QTest::currentDataTag()

현재 테스트 데이터의 이름을 반환합니다. 테스트에 할당된 테스트 데이터가 없는 경우, 이 함수는 ` nullptr`를 반환합니다.

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

현재 전역 테스트 데이터의 이름을 반환합니다. 테스트에 할당된 전역 테스트 데이터가 없는 경우, 이 함수는 ` nullptr`를 반환합니다.

이 함수는 Qt 6.11에서 도입되었습니다.

bool QTest::currentTestFailed()

현재 테스트 함수가 실패한 경우 ` true `를 반환하고, 그렇지 않으면 `false`를 반환합니다.

QTest::currentTestResolved()도 참조하십시오 .

const char *QTest::currentTestFunction()

현재 실행 중인 테스트 함수의 이름을 반환합니다.

예시:

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

[since 6.5] bool QTest::currentTestResolved()

현재 테스트 함수가 실패했거나 건너뛴 경우 ` true `를 반환합니다.

이는 테스트가 실패했거나 건너뛰기가 실행된 경우에 적용됩니다. 이 값이 true인 경우, 테스트 함수는 조기에 반환해야 합니다. 특히, QTRY_* 매크로와 테스트 이벤트 루프는 테스트 함수 실행 중(단, cleanup()은 제외)에 호출될 경우 루프를 조기에 종료합니다. 테스트가 이 모듈의 매크로를 사용하는 헬퍼 함수를 호출한 후에는, 이 함수를 사용하여 조기 반환 여부를 판단할 수 있습니다.

이 함수는 Qt 6.5에서 도입되었습니다.

QTest::currentTestFailed()도 참조하십시오 .

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

messagePattern 에 해당하는 각 경고에 대해 테스트 로그에 테스트 실패 항목을 추가합니다.

실패 항목이 추가되어도 테스트 함수는 실행을 계속합니다. 대신 테스트를 중단하려면 currentTestFailed()를 확인하고, 결과가 true 인 경우 조기에 반환할 수 있습니다.

각 경고에 대해, 일치하는 첫 번째 패턴이 실패를 유발하며, 나머지 패턴은 무시됩니다.

각 테스트 함수가 종료되면 모든 패턴이 초기화됩니다.

void FileTest::loadFiles()
{
    QTest::failOnWarning(QRegularExpression("^로드 실패"));

    // 다음 각 항목은 테스트 실패를 유발합니다:
    qWarning() << "Failed to load image";
    qWarning() << "Failed to load video";
}

주어진 경고를 유발하는 모든 테스트가 실패하도록 하려면, init()에서 이 함수에 적절한 정규식을 전달하십시오:

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

경고가 발생하면 테스트를 실패시키는 일반적인 경우에는 매개변수를 전달하지 마십시오:

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

이 함수는 Qt 6.3에서 도입되었습니다.

QTEST_FATAL_FAIL항목도 참조하십시오 .

[since 6.8] void QTest::failOnWarning()

경고가 출력되면 테스트 로그에 테스트 실패 항목을 추가합니다.

이 함수는 Qt 6.8에서 도입되었습니다.

failOnWarning(const char *)도 참조하십시오 .

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

message 가 출력되면 테스트 로그에 테스트 실패 항목을 추가합니다.

이 함수는 Qt 6.3에서 도입되었습니다.

failOnWarning()도 참조하십시오 .

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

qDebug(), qInfo() 또는 qWarning()에 의해 생성된 메시지를 무시합니다. 해당 type 을 포함하는 message 이 출력된 경우, 이는 테스트 로그에서 제거됩니다. 테스트가 완료되었으나 message 이 출력되지 않은 경우, 테스트 로그에 테스트 실패 기록이 추가됩니다.

예시:

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

위의 예제는 QDir::mkdir()가 유효하지 않은 파일 이름으로 호출되었을 때 올바른 경고를 출력하는지 테스트합니다.

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

qDebug(), qInfo() 또는 qWarning()에 의해 생성된 메시지를 무시합니다. messagePattern 와 해당 type 에 해당하는 메시지가 출력된 경우, 해당 메시지는 테스트 로그에서 제거됩니다. 테스트가 완료되었으나 해당 메시지가 출력되지 않은 경우, 테스트 실패 기록이 테스트 로그에 추가됩니다.

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

widget 에서 key 을 클릭하는 것을 시뮬레이션하며, 선택적으로 modifier 을 지정할 수 있습니다. delay 이 0보다 크면, 테스트는 delay 밀리초 동안 대기한 후 키를 클릭합니다.

예시:

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

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

위의 첫 번째 예제는 키보드 수정 키 없이 지연 시간 없이 myWidget 에서 escape 키를 클릭하는 것을 시뮬레이션합니다. 두 번째 예제는 테스트가 200 ms 동안 지연된 후 myWidget 에서 shift-escape 를 클릭하는 것을 시뮬레이션합니다.

QTest::keyClicks()도 참조하십시오 .

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

widget 에서 key 를 클릭하는 동작을 시뮬레이션하며, 선택 사항으로 modifier 를 지정할 수 있습니다. delay 가 0보다 크면, 테스트는 delay 밀리초 동안 대기한 후 키를 클릭합니다.

예시:

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

위의 예제는 키보드 수정 키 없이 테스트 지연 시간 없이 myWidget 에서 a 를 클릭하는 것을 시뮬레이션합니다.

QTest::keyClicks()도 참조하십시오 .

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

window 에서 key 를 클릭하는 동작을 시뮬레이션하며, 선택 사항인 modifier 를 적용할 수 있습니다. delay 가 0보다 크면, 테스트는 키를 클릭하기 전까지 delay 밀리초 동안 대기합니다.

예시:

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

위의 첫 번째 예제는 키보드 수정 키 없이 지연 시간 없이 myWindow 에서 escape 키를 클릭하는 것을 시뮬레이션합니다. 두 번째 예제는 테스트가 200 ms 지연된 후 myWindow 에서 shift-escape 를 클릭하는 것을 시뮬레이션합니다.

QTest::keyClicks()도 참조하십시오 .

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

window 에서 key 를 클릭하는 동작을 시뮬레이션하며, 선택 사항으로 modifier 를 지정할 수 있습니다. delay 가 0보다 크면, 테스트는 delay 밀리초 동안 대기한 후 키를 클릭합니다.

예시:

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

위의 예제는 키보드 수정 키 없이 테스트 지연 시간 없이 myWindow 에서 a 를 클릭하는 것을 시뮬레이션합니다.

QTest::keyClicks()도 참조하십시오 .

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

widget 에서 키 조합( sequence )을 클릭하는 동작을 시뮬레이션합니다. 선택적으로, 키보드( modifier )를 지정할 수 있으며, 각 키 클릭 전에 테스트의 지연 시간( delay, 밀리초 단위)을 지정할 수도 있습니다.

예시:

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

위의 예제는 키보드 수정 키 없이, 테스트 지연 시간 없이 myWidget 에서 "hello world"를 나타내는 키 시퀀스를 클릭하는 것을 시뮬레이션합니다.

QTest::keyClick()도 참조하십시오 .

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

지정된 키 위치( key )와 연관된 키 상태( action)를 사용하여 Qt 키 이벤트를 키보드 이벤트 처리기( widget )로 전송합니다. 선택적으로 키보드 이벤트 처리기( modifier )를 지정할 수 있으며, 이벤트를 전송하기 전 테스트를 수행할 시간( delay, 밀리초 단위)도 지정할 수 있습니다.

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

지정된 키 ascii 와 관련 키보드 이벤트( action)를 사용하여 Qt 키 이벤트를 widget 로 전송합니다. 선택적으로 키보드 modifier 를 지정할 수 있으며, 이벤트를 전송하기 전 테스트의 대기 시간( delay, 밀리초 단위)도 지정할 수 있습니다.

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

지정된 키 위치( key )와 연관된 키 상태( action)를 사용하여 Qt 키 이벤트를 ` window `로 전송합니다. 선택적으로 키보드 위치( modifier )를 지정할 수 있으며, 이벤트를 전송하기 전 테스트의 대기 시간( delay, 밀리초 단위)도 지정할 수 있습니다.

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

지정된 키 ascii 와 관련 키보드 이벤트( action)를 사용하여 Qt 키 이벤트를 ` window `로 전송합니다. 선택적으로 키보드 이벤트( modifier )를 지정할 수 있으며, 이벤트를 전송하기 전 테스트의 대기 시간( delay, 밀리초 단위)을 지정할 수도 있습니다.

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

widget 에서 선택적 modifier 을 사용하여 key 를 누르는 것을 시뮬레이션합니다. delay 가 0보다 크면, 테스트는 delay 밀리초 동안 대기한 후 키를 누릅니다.

QTest::keyRelease() 및 QTest::keyClick()도 참조하십시오 .

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

widget 에서 선택 사항인 modifier 을 사용하여 key 을 누르는 것을 시뮬레이션합니다. delay 이 0보다 크면, 테스트는 키를 누르기 전까지 delay 밀리초 동안 대기합니다.

QTest::keyRelease() 및 QTest::keyClick()도 참조하십시오 .

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

window 에서 선택 사항인 modifier 와 함께 key 키를 누르는 동작을 시뮬레이션합니다. delay 가 0보다 크면, 테스트는 delay 밀리초 동안 대기한 후 키를 누릅니다.

QTest::keyRelease() 및 QTest::keyClick()도 참조하십시오 .

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

window 에서 선택적 modifier 과 함께 key 를 누르는 동작을 시뮬레이션합니다. delay 가 0보다 크면, 테스트는 delay 밀리초 동안 대기한 후 키를 누릅니다.

QTest::keyRelease() 및 QTest::keyClick()도 참조하십시오 .

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

widget 에서 선택적 modifier 을 사용하여 key 를 해제하는 것을 시뮬레이션합니다. delay 가 0보다 크면, 테스트는 키를 해제하기 전에 delay 밀리초 동안 대기합니다.

QTest::keyPress() 및 QTest::keyClick()도 참조하십시오 .

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

widget 에서 선택적 modifier 을 사용하여 key 를 해제하는 것을 시뮬레이션합니다. delay 가 0보다 크면, 테스트는 키를 해제하기 전에 delay 밀리초 동안 대기합니다.

QTest::keyClick()도 참조하십시오 .

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

window 에서 선택적 modifier 을 사용하여 key 를 해제하는 것을 시뮬레이션합니다. delay 가 0보다 크면, 테스트는 키를 해제하기 전에 delay 밀리초 동안 대기합니다.

QTest::keyPress() 및 QTest::keyClick()도 참조하십시오 .

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

window 에서 선택적 modifier 를 사용하여 key 를 해제하는 것을 시뮬레이션합니다. delay 가 0보다 크면, 테스트는 키를 해제하기 전에 delay 밀리초 동안 대기합니다.

QTest::keyClick()도 참조하십시오 .

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

widget 에 keySequence 를 입력하는 것을 시뮬레이션합니다.

QTest::keyClick() 및 QTest::keyClicks()도 참조하십시오 .

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

window 에 keySequence 를 입력하는 동작을 시뮬레이션합니다.

QTest::keyClick() 및 QTest::keyClicks()도 참조하십시오 .

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

widget 에서 마우스 클릭 button 을 시뮬레이션하며, 선택적으로 modifier 을 지정할 수 있습니다. 클릭 위치는 pos 로 정의되며, 기본 위치는 위젯의 중심입니다. delay 가 지정된 경우, 테스트는 버튼을 누르기 전과 놓기 전에 지정된 밀리초 수만큼 대기합니다.

QTest::mousePress() 및 QTest::mouseRelease()도 참조하십시오 .

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

window 에서 마우스 클릭 button 을 시뮬레이션하며, 선택적으로 stateKey 수식자를 사용할 수 있습니다. 클릭 위치는 pos 로 정의되며, 기본 위치는 창의 중앙입니다. delay 가 지정된 경우, 테스트는 버튼을 누르기 전과 놓기 전에 지정된 밀리초 수만큼 대기합니다.

QTest::mousePress() 및 QTest::mouseRelease()도 참조하십시오 .

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

widget 에서 마우스 button 를 더블 클릭하는 동작을 시뮬레이션하며, 선택적으로 modifier 을 지정할 수 있습니다. 클릭 위치는 pos 로 정의되며, 기본 위치는 위젯의 중앙입니다. delay 이 지정된 경우, 테스트는 각 클릭 및 클릭 해제 전에 지정된 밀리초 수만큼 대기합니다.

QTest::mouseClick()도 참조하십시오 .

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

window 에서 마우스 button 를 더블 클릭하는 동작을 시뮬레이션하며, 선택적으로 stateKey 수정을 적용할 수 있습니다. 클릭 위치는 pos 로 정의되며, 기본 위치는 창의 중앙입니다. delay 가 지정된 경우, 테스트는 각 클릭 및 해제 전에 지정된 밀리초 수만큼 대기합니다.

QTest::mouseClick()도 참조하십시오 .

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

마우스 포인터를 ` widget`로 이동합니다. ` pos `가 지정되지 않은 경우, 마우스 포인터는 위젯의 중앙으로 이동합니다. ` delay `(밀리초 단위)가 지정된 경우, 테스트는 마우스 포인터를 이동하기 전에 해당 시간만큼 대기합니다.

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

마우스 포인터를 ` window`로 이동합니다. ` pos `가 지정되지 않으면 마우스 포인터는 창의 중앙으로 이동합니다. ` delay `(밀리초 단위)가 지정된 경우, 테스트는 마우스 포인터를 이동하기 전에 해당 시간만큼 대기합니다.

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

widget 에서 마우스 버튼 button 을 누르는 것을 시뮬레이션하며, 선택적으로 modifier 을 사용할 수 있습니다. 위치는 pos 으로 정의되며, 기본 위치는 위젯의 중심입니다. delay 이 지정된 경우, 테스트는 지정된 밀리초 동안 대기한 후 버튼을 누릅니다.

QTest::mouseRelease() 및 QTest::mouseClick()도 참조하십시오 .

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

window 에서 마우스 버튼 button 을 누르는 것을 시뮬레이션하며, 선택적으로 stateKey 수정을 적용할 수 있습니다. 위치는 pos 로 정의되며, 기본 위치는 창의 중앙입니다. delay 가 지정된 경우, 테스트는 버튼을 누르기 전까지 지정된 밀리초 수만큼 대기합니다.

QTest::mouseRelease() 및 QTest::mouseClick()도 참조하십시오 .

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

widget 에서 마우스 버튼 button 을 놓는 동작을 시뮬레이션하며, 선택적으로 modifier 를 지정할 수 있습니다. 버튼이 놓이는 위치는 pos 로 정의되며, 기본 위치는 위젯의 중앙입니다. delay 가 지정된 경우, 테스트는 지정된 밀리초 수만큼 기다린 후 버튼을 놓습니다. 그렇지 않은 경우, 기본 시간(1ms)만큼 기다리며, 이 시간은 명령줄 인수를 통해 재정의할 수 있습니다.

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);

QTest::mousePress() 및 QTest::mouseClick()도 참조하십시오 .

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

window 에서 마우스 버튼 button 을 stateKey 수정을 선택적으로 적용하여 놓는 것을 시뮬레이션합니다. 버튼이 놓이는 위치는 pos 로 정의되며, 기본 위치는 창의 중앙입니다. delay 가 지정된 경우, 테스트는 지정된 밀리초(ms) 동안 대기한 후 버튼을 놓습니다. 그렇지 않으면 기본 대기 시간(1 ms)만큼 대기하며, 이 값은 명령줄 인수를 통해 재정의할 수 있습니다.

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);

QTest::mousePress() 및 QTest::mouseClick()도 참조하십시오 .

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

현재 테스트 데이터에 새 행을 추가합니다.

테스트 출력에서는 이 테스트 데이터를 사용하여 테스트 실행을 ‘ dataTag ’라는 이름으로 식별합니다.

테이블의 각 열에 대해 하나의 값씩 데이터를 스트리밍하는 데 사용할 수 있는 QTestData 참조를 반환합니다.

예:

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

더 자세한 예제는 ‘데이터 기반 테스트’를 참조하십시오.

addRow(), addColumn(), QFETCH()도 참조하십시오 .

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

testObject 에 선언된 테스트를 실행합니다. 또한, initTestCase(), cleanupTestCase(), init() 및 cleanup() 와 같은 비공개 슬롯이 존재할 경우 해당 슬롯도 실행됩니다. 자세한 내용은 ‘테스트 생성’을 참조하십시오.

선택적으로 argc 및 argv 명령줄 인수를 지정할 수 있습니다. 인식되는 인수의 목록은 Qt Test 명령줄 인수를 참조하십시오.

다음 예제는 MyTestObject 에 있는 모든 테스트를 실행합니다:

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

이 함수는 실패한 테스트가 없으면 0을 반환하고, 하나 이상의 테스트가 실패했거나 처리되지 않은 예외가 발생한 경우에는 0이 아닌 값을 반환합니다. (건너뛴 테스트는 반환 값에 영향을 미치지 않습니다.)

독립형 테스트 애플리케이션의 경우, 편의 매크로인 QTEST_MAIN()를 사용하여 명령줄 인수를 파싱하고 테스트를 실행하는 main() 함수를 선언할 수 있으며, 이 경우 이 함수를 명시적으로 호출할 필요가 없습니다.

QTEST_MAIN() 매크로를 사용할 경우, 이 함수의 반환 값은 테스트 애플리케이션의 종료 코드이기도 합니다.

독립형 테스트 애플리케이션의 경우, 테스트 출력을 파일에 기록하거나 개별 테스트 함수를 실행하기 위한 명령줄 옵션이 올바르게 작동하지 않으므로 이 함수를 두 번 이상 호출해서는 안 됩니다.

main() 의 인자에서 가져오는 것이 아니라 프로그래밍 방식으로 인자를 생성한 경우, 유니코드 안전성을 보장하는 QTest::qExec(QObject *, const QStringList &)를 사용하는 것이 좋습니다.

QTEST_MAIN(), QTEST_GUILESS_MAIN(), QTEST_APPLESS_MAIN()도 참조하십시오 .

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

qExec(QObject *, int, char**)와 동일하게 동작하지만, char** 리스트 대신 arguments 의 QStringList 를 인수로 받습니다.

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

리소스에서 디렉터리를 디스크로 추출합니다. 내용은 임시 폴더로 재귀적으로 추출됩니다. 반환 값에 대한 마지막 참조가 범위 밖으로 나가면 추출된 내용은 자동으로 삭제됩니다.

dirName 는 리소스에서 추출할 디렉터리의 이름입니다.

데이터가 추출된 임시 디렉터리를 반환하며, 오류가 발생한 경우에는 null을 반환합니다.

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

테스트 name 를, 진입 함수 entryFunction 와 함께, 현재 바이너리의 중앙 테스트 케이스 레지스트리에 등록합니다.

매개변수 없이 배치 테스트 바이너리를 실행하면 name 가 목록에 표시됩니다. 테스트 바이너리를 name 의 argv[1]을 지정하여 실행하면 entryFunction 가 호출됩니다.

이 함수는 Qt 6.5에서 도입되었습니다.

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

msecs 동안 대기하며, 테스트 실행을 차단합니다.

이 메서드는 이벤트 처리를 수행하지 않으며, 테스트가 응답하지 않는 상태가 됩니다. 대기 중에 네트워크 통신이 시간 초과될 수 있습니다. 비차단 대기 기능을 사용하려면 QTest::qWait()을 사용하십시오.

msecs 값은 0ms보다 커야 합니다.

예시:

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

이 함수는 Qt 6.7에서 도입되었습니다.

QTest::qWait()도 참조하십시오 .

void QTest::qSleep(int ms)

ms 밀리초 동안 대기하며, 테스트 실행을 차단합니다.

다음과 호출하는 것과 동일합니다:

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

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

msecs 가 완료될 때까지 대기합니다. 대기하는 동안 이벤트는 처리되며, 테스트는 사용자 인터페이스 이벤트나 네트워크 통신에 계속해서 반응할 수 있습니다.

예시:

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

위의 코드는 네트워크 서버가 응답할 때까지 최대 약 12.5초 동안 대기합니다.

QTRY_* 매크로는 일반적으로 qWait()보다 더 나은 선택입니다. qWait()는 항상 전체 타임아웃 기간 동안 일시 중지되므로, 테스트가 유휴 상태가 되어 실행 속도가 느려질 수 있습니다.

QTRY_* 매크로는 조건이 충족되거나 타임아웃이 만료될 때까지 주기적으로 확인합니다. 따라서 테스트는 가능한 한 빨리 계속 진행되며 더 안정적으로 유지됩니다. 조건이 여전히 충족되지 않으면, 매크로는 타임아웃 시간을 한 번 두 배로 늘리고 새로운 값을 보고하므로 사용자가 이를 조정할 수 있습니다.

예를 들어, 위의 코드를 다음과 같이 다시 작성해 보십시오.

QTRY_VERIFY_WITH_TIMEOUT(!myNetworkServerNotResponding(), 12.5s);

이 함수는 Qt 6.7에서 도입되었습니다.

QTest::qSleep(), QSignalSpy::wait(), QTRY_VERIFY_WITH_TIMEOUT()도 참조하십시오 .

void QTest::qWait(int msecs)

msecs 를 기다립니다. 다음 호출과 동일합니다:

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)))

deadline 의 유효 기간이 만료되거나, predicate 가 true를 반환할 때까지(둘 중 먼저 발생하는 시점까지) 대기합니다.

predicate 가 어느 시점에서든 true를 반환한 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

예시:

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

위의 코드는 객체가 준비될 때까지 최대 3초 동안 대기합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

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

timeout 밀리초 동안 대기하거나, predicate 가 true를 반환할 때까지 대기합니다.

이는 다음을 호출하는 것과 동일합니다:

qWaitFor(predicate, QDeadlineTimer(timeout));

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

widget 가 timeout 밀리초 이내에 활성 상태인 경우 true 를 반환합니다. 그렇지 않은 경우 false 를 반환합니다.

이 메서드는 QWidget::show()을 호출하고, 진행하기 전에 위젯이 실제로 활성 상태(즉, 표시되고 포커스를 가지고 있는 상태)인지 확인해야 하는 테스트에서 유용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

qWaitForWindowExposed() 및 QWidget::isActiveWindow()도 참조하십시오 .

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

timeout 내에서 window 가 활성 상태인 경우 true 를 반환합니다. 그렇지 않은 경우 false 를 반환합니다.

이 메서드는 QWindow::show()를 호출하고, 진행하기 전에 해당 창이 실제로 활성 상태(즉, 표시되어 있고 포커스를 가지고 있는 상태)인지 확인해야 하는 테스트에서 유용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

qWaitForWindowExposed(), qWaitForWindowFocused() 및 QWindow::isActive()도 참조하십시오 .

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

이 함수는 기본 타임아웃인 5초를 사용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

이 함수는 기본 타임아웃인 5초를 사용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

timeout 는 밀리초 단위입니다.

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

timeout 는 밀리초 단위입니다.

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

widget 가 timeout 밀리초 이내에 노출되면 true 를 반환합니다. 그렇지 않으면 false 를 반환합니다.

이 메서드는 ` QWidget::show()`를 호출하고, 진행하기 전에 위젯이 실제로 표시되어 있는지 확인해야 하는 테스트에서 유용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

qWaitForWindowActive(), QWidget::isVisible() 및 QWindow::isExposed()도 참조하십시오 .

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

timeout 내에서 window 가 노출되어 있으면 true 를 반환합니다. 그렇지 않으면 false 를 반환합니다.

이 메서드는 QWindow::show()을 호출하고, 진행하기 전에 창이 실제로 표시되어 있는지 확인해야 하는 테스트에서 유용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

qWaitForWindowActive() 및 QWindow::isExposed()도 참조하십시오 .

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

이 함수는 기본 시간 제한인 5초를 사용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

이 함수는 5초의 기본 타임아웃을 사용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

timeout 는 밀리초 단위입니다.

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

timeout 는 밀리초 단위입니다.

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

widget 가 timeout 내에서 포커스 창인 경우 true 을 반환합니다. 그렇지 않은 경우 false 을 반환합니다.

이 메서드는 QWidget::show()를 호출하고, 진행하기 전에 위젯이 포커스를 가지고 있는지(예: 키보드 이벤트 수신을 위해) 확인해야 하는 테스트에서 유용합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

qWaitForWindowExposed(), qWaitForWindowActive(), QGuiApplication::focusWindow()도 참조하십시오 .

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

window 가 timeout 내에서 포커스를 가진 창인 경우 true 를 반환합니다. 그렇지 않은 경우 false 를 반환합니다.

이 메서드는 QWindow::show()을 호출하고, 진행하기 전에 해당 창이 포커스를 가지고 있는지(예: 키보드 이벤트 수신 등) 확인해야 하는 테스트에서 유용합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

qWaitForWindowExposed(), qWaitForWindowActive(), QGuiApplication::focusWindow()도 참조하십시오 .

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

이 함수는 기본 타임아웃인 5초를 사용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

이 함수는 기본 타임아웃인 5초를 사용합니다.

이 함수는 Qt 6.10에서 도입되었습니다.

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

이 테스트 함수의 벤치마크 결과를 result 로 설정합니다.

QBENCHMARK 매크로를 사용하지 않고 벤치마크 결과를 보고하려면 이 함수를 사용하십시오. metric 를 사용하여 Qt Test 가 결과를 어떻게 해석할지 지정하십시오.

결과의 컨텍스트는 테스트 함수 이름과 _data 함수의 데이터 태그가 됩니다. 이 함수는 각 테스트 함수에서 한 번만 호출할 수 있으며, 이후 호출 시 이전에 보고된 결과가 대체됩니다.

QBENCHMARK 매크로가 없는 테스트 함수의 경우, -iterations 명령줄 인수는 아무런 영향을 미치지 않는다는 점에 유의하십시오.

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

QCOMPARE()/QVERIFY() 호출이 실패할 때 예외를 발생시키도록 설정(enable = true)하거나, 예외 발생을 비활성화(enable = false)합니다(단순히 바로 앞의 함수 컨텍스트에서 반환되는 것과는 대조적으로).

이 기능은 참조 카운트 방식입니다. true 를 사용하여 이 함수를 N번 호출했다면, 시작 지점으로 돌아가기 위해 false 를 N번 호출해야 합니다.

QTEST_THROW_ON_FAIL C++ 매크로가 정의된 경우 이 호출은 아무런 효과도 없습니다.

이 함수는 Qt 6.8에서 도입되었습니다.

setThrowOnSkip(), ThrowOnFailEnabler, ThrowOnFailDisabler 및 QTEST_THROW_ON_FAIL도 참조하십시오 .

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

QSKIP() 호출 시 예외 발생을 활성화(enable = true)하거나 비활성화(enable= false)합니다(단순히 바로 앞의 함수 컨텍스트에서 반환되는 것과는 대조적으로).

이 기능은 참조 카운팅 방식입니다. 즉, ` true`을 사용하여 이 함수를 N번 호출했다면, 시작 지점으로 돌아가기 위해서는 ` false `을 사용하여 N번 호출해야 합니다.

QTEST_THROW_ON_SKIP C++ 매크로가 정의된 경우, 이 호출은 아무런 효과도 미치지 않습니다.

이 함수는 Qt 6.8에서 도입되었습니다.

setThrowOnFail(), ThrowOnSkipEnabler, ThrowOnSkipDisabler 및 QTEST_THROW_ON_SKIP도 참조하십시오 .

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

ba 문자열을 공백으로 구분된 16진수 문자열로 표현한 문자열 포인터를 반환합니다. 입력 문자열이 너무 길다고 판단되면 잘립니다. 잘린 부분은 반환된 문자열의 끝에 줄임표(…)로 표시됩니다. 호출자는 반환된 포인터에 대한 소유권을 가지며, 나중에 이 포인터를 operator delete[]에 전달해야 합니다.

length 는 문자열 ba 의 길이입니다.

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

value 의 텍스트 표현을 반환합니다. 이 함수는 테스트가 실패할 경우 QCOMPARE()에서 자세한 정보를 출력하는 데 사용됩니다.

테스트에서 이 함수의 특화(specialization)나 오버로드(overload)를 추가하여 상세 출력을 활성화할 수 있습니다.

특화 예시 (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());
    }
}

위의 예제는 MyPoint 라는 클래스에 대한 toString() 특수화를 정의합니다. MyPoint 의 두 인스턴스 간 비교가 실패할 때마다, QCOMPARE()는 이 함수를 호출하여 MyPoint 의 내용을 테스트 로그에 출력합니다.

동일한 예제이지만 오버로딩을 사용한 경우(Qt 5.5 이상):

char *toString(const MyPoint &point) // should be inside the same namespace as MyPoint
{
    return QTest::toString("MyPoint(" +
                           QByteArray::number(point.x()) + ", " +
                           QByteArray::number(point.y()) + ')');
}

QCOMPARE()도 참조하십시오 .

char *toString(QSizePolicy sp)

sp 의 크기 정책에 대한 텍스트 표현을 반환합니다.

char *toString(QSizePolicy::ControlType ct)

ct 제어 유형을 텍스트로 변환한 값을 반환합니다.

char *toString(QSizePolicy::ControlTypes cts)

cts 의 제어 유형을 텍스트로 변환한 값을 반환합니다.

char *toString(QSizePolicy::Policy p)

p 정책의 텍스트 표현을 반환합니다.

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

바이트 배열 ba 의 문자열 표현을 반환합니다.

QTest::toHexRepresentation()도 참조하십시오 .

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

주어진 CBOR 오류 c 의 텍스트 표현을 반환합니다.

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

주어진 ` character`의 텍스트 표현을 반환합니다.

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

주어진 ` date`의 텍스트 표현을 반환합니다.

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

dateTime 로 지정된 날짜와 시간의 문자열 표현을 반환합니다.

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

ks 키 시퀀스의 텍스트 표현을 반환합니다.

이 함수는 Qt 6.5에서 도입되었습니다.

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

주어진 ` string`의 텍스트 표현을 반환합니다.

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

주어진 ` point`의 텍스트 표현을 반환합니다.

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

주어진 ` point`의 텍스트 표현을 반환합니다.

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

주어진 ` rectangle`의 텍스트 표현을 반환합니다.

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

주어진 ` rectangle`의 텍스트 표현을 반환합니다.

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

주어진 ` size`의 텍스트 표현을 반환합니다.

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

주어진 ` size`의 텍스트 표현을 반환합니다.

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

주어진 ` string`의 텍스트 표현을 반환합니다.

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

주어진 string 의 문자열 표현을 반환합니다.

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

주어진 ` time`의 문자열 표현을 반환합니다.

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

주어진 ` url`의 텍스트 표현을 반환합니다.

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

주어진 ` uuid`의 텍스트 표현을 반환합니다.

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

주어진 ` variant`의 텍스트 표현을 반환합니다.

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

2차원 벡터 ` v`를 텍스트 형식으로 변환하여 반환합니다.

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

3차원 벡터 v 의 문자열 표현을 반환합니다.

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

4차원 벡터 ` v`의 문자열 표현을 반환합니다.

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

pair 의 텍스트 표현을 반환합니다.

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

주어진 ` tuple`의 텍스트 표현을 반환합니다.

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

nullptr 를 포함하는 문자열을 반환합니다.

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

device 에 대한 QTouchEventSequence 를 생성하여 반환하며, 이를 통해 widget 에 대한 이벤트를 시뮬레이션합니다.

시퀀스에 터치 이벤트를 추가할 때, press(), move() 등의 호출에서 다른 위젯이 제공되지 않는 한, widget 는 제공된 위치를 화면 좌표로 변환하는 데에도 사용됩니다.

autoCommit 가 false로 설정되어 있지 않은 한, 터치 이벤트는 QTouchEventSequence 의 소멸자가 호출될 때(즉, 반환된 객체의 범위가 종료될 때) 이벤트 시스템에 커밋됩니다. autoCommit 가 false인 경우, commit()을 수동으로 호출해야 합니다.

createTouchDevice()를 호출하여 이 함수와 함께 사용할 테스트용 터치 장치를 생성할 수 있습니다.

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

device 에 대한 QTouchEventSequence 를 생성하여 반환하며, 이를 통해 window 에 대한 이벤트를 시뮬레이션합니다.

시퀀스에 터치 이벤트를 추가할 때, press(), move() 등의 호출에서 별도의 창이 지정되지 않는 한, window 는 제공된 위치를 화면 좌표로 변환하는 데에도 사용됩니다.

autoCommit 가 false로 설정되지 않은 한, 터치 이벤트는 QTouchEventSequence 의 소멸자가 호출될 때(즉, 반환된 객체의 범위가 종료될 때) 이벤트 시스템에 커밋됩니다. autoCommit 가 false인 경우, commit()을 수동으로 호출해야 합니다.

createTouchDevice()를 호출하여 이 함수와 함께 사용할 테스트용 터치 장치를 생성할 수 있습니다.

[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)

window 내에서 로컬 창 좌표계 기준 pos 위치에서 휠 이벤트를 시뮬레이션합니다. angleDelta 에는 휠 회전 각도가 포함됩니다. 양수 값은 앞으로 회전을, 음수 값은 뒤로 회전을 의미합니다. pixelDelta 에는 화면상의 스크롤 거리(픽셀 단위)가 포함됩니다. 이 값은 null일 수 있습니다. 이벤트 발생 시점의 키보드 상태는 stateKey 로 지정됩니다. 이벤트의 스크롤 단계는 phase 로 지정됩니다.

이 함수는 Qt 6.8에서 도입되었습니다.