ЮНИТ-ТЕСТИРОВАНИЕ в Asp.Net: полное руководство

⚡ Умное резюме

Модульное тестирование приложения ASP.NET в Visual Studio начинается с проекта модульных тестов, устанавливает ссылку на целевой проект, добавляет атрибуты MSTest [TestClass] и [TestMethod] и вызывает методы Assert для подтверждения того, что классы ведут себя так, как задумано.

  • 🧪 Тестовый проект: Добавьте проект модульного тестирования в решение ASP.NET и укажите целевой проект, который вы хотите проверить.
  • 🏷️ Атрибуты: Пометьте класс с помощью [TestClass], а каждый тест — с помощью [TestMethod], чтобы MSTest мог их обнаружить.
  • ✅ Утверждения: Используйте вызовы Assert.AreEqual, Assert.IsTrue и аналогичные для объявления ожидаемого результата каждой проверки.
  • ▶ ️ Запуск тестов: В меню «Выполнить тест» выберите «Запустить все тесты» в Visual Studio и просмотрите обозреватель тестов, чтобы увидеть результаты «пройдено» и «не пройдено».
  • ️ Выбор фреймворка: MSTest, NUnit и xUnit работают с dotnet test; MSTest поставляется по умолчанию, xUnit предпочтительнее для ASP.NET Core.
  • 🇧🇷 лучшие практики: Изолируйте модуль, следуйте алгоритмам Arrange, Act и Assert, и обеспечьте высокую скорость выполнения всего набора команд, чтобы он запускался при каждом коммите.

Модульное тестирование в ASP.NET

Тестирование является важным аспектом любого языка программирования. Тестирование Для приложений ASP.NET это возможно с помощью Visual Studio.

Visual Studio используется для создания тестового кода. Он также используется для запуска тестового кода для приложения ASP.NET. Таким образом, становится проще проверять наличие ошибок в приложении ASP.NET. В Visual Studio модуль тестирования поставляется с готовой функциональностью. Можно сразу же выполнить тестирование проекта ASP.NET.

Введение в тестирование ASP.NET

Первый уровень тестирования проекта ASP.NET — это модульное тестирование. Этот тест проверяет функциональность приложения. Тестирование проводится для того, чтобы убедиться, что приложение работает должным образом. В ASP.NET первая задача — создать тестовый проект в Visual Studio. Тестовый проект будет содержать необходимый код для тестирования приложения.

Рассмотрим приведенную ниже веб-страницу. На странице мы видим сообщение «GuruОтобразилось сообщение «99 – ASP.NET». Как же убедиться, что при запуске проекта ASP.NET отображается правильное сообщение? Это делается путем добавления тестового проекта в решение ASP.NET (используемое для разработки веб-приложений). Этот тестовый проект гарантирует, что пользователю будет показано правильное сообщение.

Введение в тестирование ASP.NET

Давайте теперь рассмотрим подробнее, как можно работать с тестированием в ASP.NET.

Создание проекта модульного тестирования .NET

Прежде чем создать тестовый проект, нам необходимо выполнить следующие шаги высокого уровня.

  1. Используйте наше «Демоприложение», использованное в предыдущих разделах. Это будет наше приложение, которое необходимо протестировать.
  2. Мы добавим новый класс в DemoApplication. Этот класс будет содержать строку с именем 'Guru99 – ASP.NET. Эта строка будет протестирована в нашем тестовом проекте.
  3. Наконец, мы создадим тестовый проект. Он будет использоваться для тестирования приложения ASP.NET.

Итак, давайте выполним описанные выше основные шаги и посмотрим, как реализовать тестирование.

Шаг 1) Убедитесь, что DemoApplication открыто в Visual Studio.

Шаг 2) Теперь добавим новый класс в DemoApplication. Этот класс будет содержать строку с именем 'Guru99 – ASP.NET. Эта строка будет протестирована в нашем тестовом проекте.

Следуйте шагу ниже, чтобы добавить новый класс.

Создание проекта модульного тестирования .NET

  1. В Visual Studio щелкните правой кнопкой мыши «DemoApplication» в обозревателе решений.
  2. Выберите опцию Добавить->Класс в контекстном меню.

Шаг 3) На этом этапе

Создание проекта модульного тестирования .NET

  1. Дайте новому классу имя Tutorial.cs.
  2. Нажмите кнопку «Добавить», чтобы добавить файл в DemoApplication.

Теперь в файл «DemoApplication» добавлен новый класс.

Шаг 4) Откройте новый файл Tutorial.cs из папки “DemoApplication”. Добавьте строку “Guru99 – ASP.NET.

Чтобы открыть файл, дважды щелкните файл Tutorial.cs в обозревателе решений.

Создание проекта модульного тестирования .NET

В файле уже будет написан код по умолчанию. Не беспокойтесь об этом коде, просто добавьте следующую строку кода.

Создание проекта модульного тестирования .NET

namespace DemoApplication
{
  public class Tutorial
  {
     public String Name;
     public Tutorial()
     {
        Name = "Guru99 - ASP.Net";
     }
  }
}

Code Объяснение:-

  1. Переменная Name имеет строковый тип.
  2. Наконец, в конструкторе класса Tutorial присвойте значение переменной Name. Значение присваивается переменной "Guru99 – ASP.NET”

Шаг 5) Теперь перейдите к файлу demo.aspx и добавьте строки кода для отображения текста «Guru99 – ASP.NET.

Создание проекта модульного тестирования .NET

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title></title>
</head>
    <body>
    <form id="form1" runat="server">
    <div>
        <% DemoApplication.Tutorial tp=new DemoApplication.Tutorial();%>
        <%=tp.Name%>
    </div>
    </form>
    </body>
</html>

Code Объяснение:-

  1. Первая строка создает объект класса 'Tutorial'. Это первый шаг при работе с классами и объектами. Объекту присваивается имя 'tp'.
  2. Наконец, мы вызываем «tutorial.cs» из файла demo.aspx. Он отображает значение переменной Name.

Когда вы запустите вышеуказанную программу в Visual Studio, вы получите следующий результат.

Выход:-

Создание проекта модульного тестирования .NET

В результате выполнения программы вы видите сообщение «GuruОтобразилось «99 – ASP.NET».

Шаг 6) Теперь добавим наш тестовый проект в демонстрационное приложение. Это делается с помощью Visual Studio.

Создание проекта модульного тестирования .NET

  1. Щелкните правой кнопкой мыши Решение — DemoApplication.
  2. В контекстном меню выберите опцию «Новый проект».

Шаг 7) Этот шаг включает добавление проекта модульного тестирования в демонстрационное приложение.

Создание проекта модульного тестирования .NET

  1. Нажмите на тип элемента «Тест» на левой панели.
  2. Выберите элемент «Проект модульного теста» из списка, который появляется в центральной части диалогового окна.
  3. Дайте имя тестовому проекту. В нашем случае указано имя «DemoTest».
  4. Наконец, нажмите кнопку «ОК».

В конечном итоге вы увидите, что проект DemoTest добавлен в обозреватель решений. При этом вы также можете увидеть, что другие файлы, такие как UnitTest1.cs, свойства и т. д., генерируются по умолчанию.

Создание проекта модульного тестирования .NET

Запуск тестового проекта

Созданный в предыдущем разделе тестовый проект используется для тестирования нашего ASP.NET-приложения. В следующих шагах мы рассмотрим, как запустить тестовый проект.

  • Первым шагом будет добавление ссылки на проект ASP.NET. Этот шаг выполняется для того, чтобы тестовый проект имел доступ к проекту ASP.NET.
  • Затем мы напишем наш тестовый код.
  • Наконец, мы запустим тест с помощью Visual Studio.

Шаг 1) Чтобы протестировать наше демонстрационное приложение, первый тестовый проект должен ссылаться на демонстрационное приложение. Добавьте ссылку на решение Demo.aspx.

Запуск тестового проекта .NET

  1. Щелкните правой кнопкой мыши проект Demo Test.
  2. В меню выберите опцию Добавить->Ссылка.

Шаг 2) Следующим шагом будет добавление ссылки на DemoApplication.

Запуск тестового проекта .NET

  1. Выберите параметр «Проекты» в левой части диалогового окна.
  2. Установите флажок рядом с DemoApplication.
  3. Нажмите кнопку «ОК».

Это позволит демонстрационному проекту протестировать наше DemoApplication.

Шаг 3) Теперь пришло время добавить тестовый код в наш тестовый проект.

  • Для этого сначала дважды щелкните файл UnitTest1 (файл UnitTest1 автоматически добавляется Visual Studio при создании тестового проекта) в обозревателе решений.
  • Это файл, который будет запущен для тестирования проекта ASP.NET.

Запуск тестового проекта .NET

Вы увидите приведенный ниже код, добавленный Visual Studio в файл UnitTest1.cs. Это базовый код, необходимый для запуска тестового проекта.

Запуск тестового проекта .NET

Шаг 4) Следующий шаг — добавить код, используемый для проверки строки "Guru99 – ASP.NET.

Запуск тестового проекта .NET

using System;
using Microsoft.VisualStudio.TestTools.UnitTesting;
using DemoApplication;

namespace DemoTest
{
 [TestClass]
 public class UnitTest1
 {
   [TestMethod]
   public void TestMethod1()
   {
      Tutorial tp = new Tutorial();
      Assert.AreEqual(tp.Name,"Guru99 - ASP.Net");
   }
 }
}
  1. Создайте новый объект с именем «tp» типа Tutorial.
  2. Метод Assert.AreEqual используется в .NET для проверки равенства значения чему-либо. В нашем случае мы сравниваем значения tp.Name с Guru99 – ASP.NET.

Шаг 5) Теперь давайте запустим наш тестовый проект. Для этого нам нужно перейти в меню «Тест» -> «Запуск» -> «Все тесты».

Запуск тестового проекта .NET

Выход:-

Запуск тестового проекта .NET

В Visual Studio появится окно обозревателя тестов. Это покажет приведенный выше результат и покажет, что в Visual Studio был выполнен успешный тест.

Атрибуты и утверждения MSTest, которые вы будете использовать.

MicrosoftПространство имен .VisualStudio.TestTools.UnitTesting содержит небольшой набор атрибутов и утверждений, охватывающих большинство модульных тестов ASP.NET. Изучение этих атрибутов в первую очередь упрощает чтение и сопровождение всех последующих тестов.

  • [TestClass] – помечает класс как контейнер для тестов. MSTest сканирует классы с этим атрибутом во время обнаружения.
  • [Метод тестирования] – помечает публичный метод без параметров как отдельный тест. Метод возвращает void, Task или ValueTask.
  • [TestInitialize] / [TestCleanup] – Запускаются до и после каждого тестового метода. Используйте их для создания и освобождения общей среды, такой как фиктивный репозиторий или контекст в памяти.
  • [Инициализация класса] / [Очистка класса] – Запускаются один раз для всего класса. Они полезны, когда настройка требует больших затрат, например, для заполнения тестовой базы данных.
  • [DataRow] и [DataTestMethod] – Предоставлять параметризованные входные данные, чтобы один метод тестирования охватывал несколько случаев.

Внутри каждого тестового метода класс Assert проверяет результат. Часто используются вызовы Assert.AreEqual для сравнения значений, Assert.IsTrue и Assert.IsFalse для логических значений, Assert.IsNull и Assert.IsNotNull для ссылок, а также Assert.ThrowsException для ожидаемых исключений. Структурируйте каждый тест, используя шаблон Arrange, Act, Assert, чтобы настройка, вызов и проверка визуально были разделены. Такая структура упрощает отладку неудачных тестов, поскольку строка, вызывающая ошибку, почти всегда представляет собой единственный вызов Assert внизу.

Сравнение MSTest, NUnit и xUnit для ASP.NET

В экосистеме .NET доминируют три фреймворка для тестирования. Каждый из них работает в Visual Studio и интегрируется с dotnet test, поэтому разница в основном заключается в стиле, поддержке сообщества и поведении по умолчанию.

  • МСТест – отправлено Microsoft и поставляется с предустановленным шаблоном проекта модульного тестирования Visual Studio, использованным ранее в этом руководстве. Это самый безопасный вариант по умолчанию, когда команда только начинает заниматься модульным тестированием. Microsoft стек.
  • NUnit – самый старый из трёх, первоначально перенесённый из JUnitОн предлагает богатую модель ограничений, параметризованные тесты через TestCase и TestCaseSource, а также развитую поддержку для всех версий .NET.
  • xUnit.net – используется внутри команд ASP.NET Core и Entity Framework Core. Заменяет метод SetUp конструктором и IDisposable, поощряет использование одного тестового класса для каждого поведения и использует [Fact] и [Theory] вместо [TestMethod].

Все три фреймворка обнаруживают тесты по атрибутам, запускают их с помощью команды `dotnet test` и создают XML-отчеты в форматах `trx` или `xUnit`, которые затем используются в конвейерах CI, таких как... Azure DevOps, GitHub Actions и Jenkins Можно использовать напрямую. Для первого проекта на ASP.NET использование MSTest упрощает цепочку инструментов. Команды, которым нужна более богатая параметризация или которые уже используют ASP.NET Core, часто выбирают xUnit из-за его совместимости с фреймворком, на котором он был построен.

Рекомендации по модульному тестированию приложений ASP.NET

Соблюдение небольшого набора правил позволяет обеспечить быструю, надежную и полезную работу набора тестов на протяжении всего жизненного цикла проекта ASP.NET.

  1. Для каждого метода протестируйте только одно поведение. Тест, проверяющий несколько несвязанных между собой вещей, дает сбой по многим причинам и требует больше времени для исправления.
  2. Называйте тесты в соответствии с намерением. Использование такого шаблона, как MethodUnderTest_Scenario_ExpectedResult, позволяет получить в выводе обозревателя тестов удобочитаемую спецификацию класса.
  3. Изолируйте устройство от внешних систем. Оберните вызовы к файлам, сети и базе данных в интерфейсы и замените их фиктивными объектами или моками, чтобы тест не затрагивал реальную зависимость.
  4. Проводите быстрые тесты. Цель состоит в том, чтобы весь набор модульных тестов завершился за считанные секунды. Медленные тесты пропускаются, а пропущенные тесты скрывают регрессии.
  5. Следуйте схеме «Расположить, Действовать, Утвердить». Три коротких блока с пустыми строками между ними указывают на намерение автора и позволяют легко заметить ошибки в написании.
  6. Запускайте тесты для каждого коммита. Интегрируйте dotnet test в конвейер CI таким образом, чтобы неисправный тест блокировал слияние, а не публикацию проекта.ping к производству.
  7. Track — показатель покрытия кода, но не стоит за ним гнаться. Охват позволяет выявить непроверенные маршруты, но большое количество таких маршрутов само по себе не гарантирует их качества. RevПосмотрите, что на самом деле делают отсутствующие строки.

При совместном применении эти методы превращают созданный выше проект DemoTest в основу набора тестов, который выявляет регрессии при каждом изменении кода, документирует поведение для будущих разработчиков и вселяет уверенность при рефакторинге ASP.NET-приложения.

Часто задаваемые вопросы (FAQ)

Да. GitHub Copilot может создавать шаблоны блоков [TestClass] и [TestMethod], предлагать варианты расположения элементов в блоке Arrange Act Assert и генерировать параметризованные варианты [DataRow] на основе сигнатуры целевого метода. RevПросмотрите сгенерированные утверждения, прежде чем доверять им в рабочей среде.

Да. Помощники на основе машинного обучения могут отмечать ненадежные тесты, предлагать более подходящие названия и выделять дублирующиеся настройки, которые должны находиться в [TestInitialize]. Они сокращают время проверки, но разработчик по-прежнему несет ответственность за корректность каждого утверждения.

Модульный тест изолирует один класс или метод и имитирует его зависимости. Интеграционный тест проверяет несколько компонентов одновременно, часто обращаясь к реальной базе данных или веб-серверу. Модульные тесты выполняются за миллисекунды; интеграционные тесты занимают больше времени, но выявляют ошибки в связке компонентов.

В Visual Studio Enterprise используйте Test Analyze. Code Покрытие для всех тестов. В других изданиях добавьте чехол N.uGet Соберите пакет и запустите команду `dotnet test –collect:”XPlat”`. Code «Покрытие» для создания Cobertura XML-отчет.

Оберните зависимость в интерфейс и внедрите её через конструктор. В тесте передайте заглушку или мок, созданный с помощью таких библиотек, как Moq или NSubstitute, чтобы тестируемый модуль никогда не обращался к реальной базе данных или HTTP-терминалу.

Запустите команду `dotnet test` в папке, содержащей тестовый проект. Команда соберет проект, обнаружит все `[TestMethod]`, выполнит их и выведет сводку. Системы непрерывной интеграции, такие как GitHub Actions, вызывают ту же команду внутри шага рабочего процесса.

Отметьте метод атрибутом [DataTestMethod] и добавьте один или несколько атрибутов [DataRow], которые указывают входные значения и ожидаемый результат. Затем MSTest запускает одно и то же тело теста один раз для каждой строки, создавая отдельную строку в обозревателе тестов для каждого случая.

Напишите неработающий [TestMethod], описывающий следующее необходимое поведение, добавьте ровно столько кода для продакшена, чтобы он прошел, а затем проведите рефакторинг. Повторение этого цикла рефакторинга (красный-зеленый) позволяет проектированию следовать за тестами, а не наоборот.

Подведем итог этой публикации следующим образом: