Exponenta Banner

matlab.unittest.diagnostics.ScreenshotDiagnostic class

Пакет: matlab.unittest.diagnostics

Диагностика, чтобы получить экран как файл изображения

расширьте все на странице

Описание

Используйте ScreenshotDiagnostic класс, чтобы создать диагностику, которая получает доступные экраны как файлы изображений. Файлы сохраняются после того, как MATLAB® завершает тестовый прогон, и таким образом, они доступны для контроля после испытания.

Конструкция

ScreenshotDiagnostic() создает диагностику, которая получает доступные экраны как файлы изображений. Когда среда тестирования диагностирует ScreenshotDiagnostic экземпляр, это сохраняет снимки экрана в файлы PNG. Файлы у каждого есть уникальное имя, состоящее из префикса (Screenshot_', по умолчанию), автоматически сгенерированный идентификатор и расширение файла. Именем файла в качестве примера является Screenshot_cf95fe7f-5a7c-4310-9c49-16c0c18a969f.png. Чтобы просмотреть местоположение файлов, получите доступ к FileArtifact объект через TestResult экземпляр.

ScreenshotDiagnostic('Prefix',prefix) создает диагностику, которая сохраняет снимки экрана в файлы с именами, которые начинаются с заданного префикса.

Входные параметры

развернуть все

Префикс имени файла в виде текста. Если вы не задаете префикс, префиксом по умолчанию является 'Screenshot_'. Задайте значение как вектор символов или строковый скаляр. В объекте MATLAB хранит их как векторы символов.

Пример: 'LoggedScreenshot_'

Пример: "TestScreenshot-"

Свойства

развернуть все

Префикс имени файла, возвращенный как вектор символов. Префиксом по умолчанию является 'Screenshot_'. Prefix свойство только для чтения, и его значение  установлено во время конструкции.

Примеры

свернуть все

Создайте TestCase для интерактивного использования.

import matlab.unittest.TestCase
testCase = TestCase.forInteractiveUse;

Используйте ScreenshotDiagnostic сохранять образ рабочего стола как тестовая диагностика.

import matlab.unittest.diagnostics.ScreenshotDiagnostic
testCase.verifyTrue(false,ScreenshotDiagnostic)
Interactive verification failed.

----------------
Test Diagnostic:
----------------
Screenshot captured to:
--> C:\work\Temp\Screenshot_e99834ed-75e9-4ee1-9596-2f95e64b0ff1.png

---------------------
Framework Diagnostic:
---------------------
verifyTrue failed.
--> The value must evaluate to "true".

Actual logical:
       0

Создайте TestCase для интерактивного использования.

import matlab.unittest.TestCase
testCase = TestCase.forInteractiveUse;

Используйте ScreenshotDiagnostic регистрировать изображение рабочего стола как тестовая диагностика с пользовательским префиксом

import matlab.unittest.diagnostics.ScreenshotDiagnostic
testCase.log(ScreenshotDiagnostic('Prefix','LoggedScreenshot_'))
Interactive diagnostic logged.
Screenshot captured to:
--> C:\work\Temp\LoggedScreenshot_35bb1ecb-441a-4f79-9f59-8b18ac3f9d12.png

В файле в вашей текущей рабочей папке создайте ScreenShotExampleTest тестирование класса. Когда failingTest сбои метода тестирования (это всегда делает в этом примере), это использует ScreenshotDiagnostic получать изображение экрана, таким образом, можно исследовать его позже. logScreenshotTest тест всегда получает изображение экрана и сохраняет его в файле, снабженном префиксом LoggedScreenshot_.

classdef ScreenShotExampleTest < matlab.unittest.TestCase
    methods (Test)
        function passingTest(testCase)
            testCase.verifyEqual(7,4+3);
        end
        function failingTest(testCase)
            import matlab.unittest.diagnostics.ScreenshotDiagnostic
            testCase.verifyFalse(true,ScreenshotDiagnostic);
        end
        function logScreenshotTest(testCase)
            import matlab.unittest.diagnostics.ScreenshotDiagnostic
            testCase.verifySubstring("Some Long Message","sage");
            testCase.log(1,ScreenshotDiagnostic('Prefix','LoggedScreenshot_'));
        end
    end
end

Запущение тестов.

res = runtests('ScreenShotExampleTest');
Running ScreenShotExampleTest
.
================================================================================
Verification failed in ScreenShotExampleTest/failingTest.

    ----------------
    Test Diagnostic:
    ----------------
    Screenshot captured to:
    --> C:\Temp\bf0e26d1-8d47-4462-b1f2-673c7d35c236\Screenshot_b24f2219-61a4-4cf8-b4da-fe7e10da92bd.png

    ---------------------
    Framework Diagnostic:
    ---------------------
    verifyFalse failed.
    --> The value must evaluate to "false".
    
    Actual logical:
           1

    ------------------
    Stack Information:
    ------------------
    In C:\work\ScreenShotExampleTest.m (ScreenShotExampleTest.failingTest) at 8
================================================================================
.   [Terse] Diagnostic logged (2016-12-22T11:21:54): 
Screenshot captured to:
--> C:\Temp\bf0e26d1-8d47-4462-b1f2-673c7d35c236\LoggedScreenshot_26def240-9a9d-4147-9d3e-c399ae157c0f.png

.
Done ScreenShotExampleTest
__________

Failure Summary:

     Name                               Failed  Incomplete  Reason(s)
    ================================================================================
     ScreenShotExampleTest/failingTest    X                 Failed by verification.

Диагностика в среде в Командном окне указывает на полученные снимки экрана. Можно также получить доступ к этим местоположениям программно через диагностические записи результатов испытаний.

Начиная со вторых тестовых сбоев снимок экрана сохранен как часть диагностического теста. Доступ к пути к снимку экрана через Artifacts объект на TestDiagnosticResults.

res(2).Details.DiagnosticRecord.TestDiagnosticResults.Artifacts.FullPath
ans = 

    "C:\Temp\bf0e26d1-8d47-4462-b1f2-673c7d35c236\Screenshot_b24f2219-61a4-4cf8-b4da-fe7e10da92bd.png"

Третьи тестовые передачи и снимок экрана сохранены как часть регистрируемой диагностики (через log метод на TestCase). Доступ к пути к снимку экрана через Artifacts объект на LoggedDiagnosticResults.

res(3).Details.DiagnosticRecord.LoggedDiagnosticResults.Artifacts.FullPath
ans = 

    "C:\Temp\bf0e26d1-8d47-4462-b1f2-673c7d35c236\LoggedScreenshot_26def240-9a9d-4147-9d3e-c399ae157c0f.png"

Советы

  • Местоположение сохраненных снимков экрана является папкой с именем, уникальным для тестового прогона в папке, содержавшейся в ArtifactsRootFolder. Если при запуске тест в интерактивном режиме, местоположение корневой папки является значением, возвращенным tempdir().

  • Чтобы определить путь сохраненных снимков экрана, получите доступ к FileArtifact объект для конкретного результата испытаний. Например, примите, что у вас есть TestResult массив, res. Определите местоположение сохраненной фигуры для первого элемента массива можно следующим образом.

    res(1).Details.DiagnosticRecord.TestDiagnosticResults.Artifacts
    ans = 

  FileArtifact with properties:

        Name: "Screenshot_f51601ef-86bc-499c-bcec-203969f72a85.png"
    Location: "C:\work\Temp\1f4d3b64-3201-4bde-92ed-ad6859e97051"
    FullPath: "C:\work\Temp\1f4d3b64-3201-4bde-92ed-ad6859e97051\Screenshot_f51601ef-86bc-499c-bcec-203969f72a85.png"

Смотрите также

|

Введенный в R2017a

Документация MATLAB
Поддержка