Memulai pengujian unit

Gunakan Visual Studio untuk menentukan dan menjalankan pengujian unit untuk menjaga kesehatan kode, memastikan cakupan kode, dan menemukan kesalahan dan kekeliruan sebelum pelanggan Anda melakukannya. Jalankan pengujian unit Anda secara berkala untuk memastikan kode Anda berfungsi dengan baik.

Dalam artikel ini, kode menggunakan C# dan C++, ilustrasi dalam C#, tetapi konsep dan fitur berlaku untuk bahasa .NET, C++, Python, JavaScript, dan TypeScript.

Membuat pengujian unit

Bagian ini menjelaskan cara membuat proyek pengujian unit.

1. Buka proyek yang ingin Anda uji di Visual Studio.

   Untuk tujuan menunjukkan contoh pengujian unit, artikel ini menguji proyek Konsol C# atau C++ "Halo Dunia" sederhana bernama HelloWorld. Kode sampel untuk proyek tersebut adalah sebagai berikut:

   .NET

   namespace HelloWorld
   {
      public class Program
      {
         public static void Main()
         {
            Console.WriteLine("Hello World!");
         }
      }
   }
   

   C++

   #include <iostream>
   
   int main()
   {
      std::cout << "Hello World!\n";
   }
   

2. Di Penjelajah Solusi, pilih node solusi. Kemudian, dari bilah menu atas, pilihTambahkan>File>Proyek Baru.

3. Dalam kotak dialog proyek baru, temukan proyek pengujian unit yang akan digunakan.

   Ketik pengujian di kotak pencarian untuk menemukan templat proyek pengujian unit untuk kerangka kerja pengujian yang ingin Anda gunakan, seperti MSTest (C#) atau proyek Pengujian Unit Asli (C++), dan pilih.

   Mulai Visual Studio 2017 versi 14.8, bahasa .NET menyertakan templat bawaan untuk NUnit dan xUnit. Untuk C++, dalam contoh ini pilih proyek Pengujian Unit Asli, yang menggunakan Microsoft Native Unit Test Framework. (Untuk menggunakan kerangka kerja pengujian C++ yang berbeda, lihat Menulis pengujian unit untuk C/C++). Untuk Python, lihat Menyiapkan pengujian unit dalam kode Python untuk menyiapkan proyek pengujian Anda.

   Tip

   Hanya untuk C#, Anda dapat membuat proyek pengujian unit dari kode menggunakan metode yang lebih cepat. Untuk informasi selengkapnya, lihat Membuat proyek pengujian unit dan metode pengujian. Untuk menggunakan metode ini dengan .NET Core atau .NET Standard, diperlukan Visual Studio 2019 atau yang lebih baru.

   Ilustrasi berikut menunjukkan pengujian unit MSTest, yang didukung di .NET.

   

   Klik Berikutnya, pilih nama untuk proyek pengujian, lalu klik Buat.

   Proyek baru ditambahkan ke solusi Anda.

   

4. Dalam proyek pengujian unit, tambahkan referensi ke proyek yang ingin Anda uji dengan mengeklik kanan Referensi atau Dependensi lalu memilih Tambahkan Referensi atau Tambahkan Referensi Project.

5. Pilih proyek yang berisi kode yang akan Anda uji dan klik OKE.

   

6. Tambahkan kode ke metode pengujian unit.

   Misalnya, Anda dapat menggunakan kode berikut dengan memilih tab dokumentasi yang benar yang cocok dengan kerangka kerja pengujian: MSTest, NUnit, atau xUnit (hanya didukung pada .NET), atau C++ Microsoft Native Unit Test Framework.

   MSTest

   using Microsoft.VisualStudio.TestTools.UnitTesting;
   using System.IO;
   using System;
   
   namespace HelloWorldTests
   {
      [TestClass]
      public class UnitTest1
      {
         private const string Expected = "Hello World!";
         [TestMethod]
         public void TestMethod1()
         {
            using (var sw = new StringWriter())
            {
               Console.SetOut(sw);
               HelloWorld.Program.Main();
   
               var result = sw.ToString().Trim();
               Assert.AreEqual(Expected, result);
            }
         }
      }
   }
   

   NUnit

   using NUnit.Framework;
   using System.IO;
   using System;
   
   namespace HelloWorldTests
   {
      public class Tests
      {
         private const string Expected = "Hello World!";
   
         [SetUp]
         public void Setup()
         {
         }
         [Test]
         public void TestMethod1()
         {
            using (var sw = new StringWriter())
            {
               Console.SetOut(sw);
               HelloWorld.Program.Main();
   
               var result = sw.ToString().Trim();
               Assert.AreEqual(Expected, result);
            }
         }
      }
   }
   

   xUnit

   using System;
   using Xunit;
   using System.IO;
   
   namespace HelloWorldTests
   {
       public class UnitTest1
       {
           private const string Expected = "Hello World!";
           [Fact]
           public void Test1()
           {
               using (var sw = new StringWriter())
               {
                   Console.SetOut(sw);
                   HelloWorld.Program.Main();
   
                   var result = sw.ToString().Trim();
                   Assert.Equal(Expected, result);
               }
           }
       }
   }
   

   Microsoft Native Unit Test Framework

   #include "pch.h"
   #include "CppUnitTest.h"
   #include "../HelloWorldUnitTestCPP/HelloWorldUnitTestCPP.cpp"   // Update using your project name
   
   using namespace Microsoft::VisualStudio::CppUnitTestFramework;
   
   namespace HelloWorldTests
   {
      TEST_CLASS(HelloWorldTests)
      {
      public:
   
         TEST_METHOD(TestMethod)
         {
            std::string expected = "Hello World!\n";
   
            std::stringstream buffer;
            std::streambuf* sbuf = std::cout.rdbuf(); // Save cout's buffer
            std::cout.rdbuf(buffer.rdbuf()); // Redirect cout to the stringstream buffer
   
            // Call main() in your test
            int result = main();
   
            // When finished, redirect cout to the original buffer 
            std::cout.rdbuf(sbuf);
            std::cout << "std original buffer: \n";
            std::cout << buffer.get();
   
            // Test
            Assert::AreEqual(expected, buffer.str());
         }
      };
   }
   

Menjalankan pengujian unit

1. Buka Test Explorer.

   Untuk membuka Test Explorer, pilihPengujian>Test Explorer dari bilah menu atas (atau tekan Ctrl + E, T).

2. Jalankan pengujian unit Anda dengan mengeklik Jalankan Semua (atau tekan Ctrl + R, V).

   

   Setelah pengujian selesai, tanda centang hijau menunjukkan bahwa pengujian lulus. Ikon "x" merah menunjukkan bahwa pengujian gagal.

   

Tip

Anda dapat menggunakan Test Explorer untuk menjalankan pengujian unit dari kerangka kerja pengujian bawaan (MSTest) atau dari kerangka kerja pengujian pihak ketiga. Anda dapat mengelompokkan pengujian ke dalam kategori, memfilter daftar pengujian, dan membuat, menyimpan, dan menjalankan daftar putar pengujian. Anda juga dapat men-debug pengujian dan menganalisis performa pengujian dan cakupan kode.

Melihat hasil pengujian unit langsung (Visual Studio Enterprise)

Jika Anda menggunakan kerangka kerja pengujian MSTest, xUnit, atau NUnit di Visual Studio 2017 atau yang lebih baru, Anda dapat melihat hasil langsung dari pengujian unit Anda.

Catatan

Untuk mengikuti langkah-langkah ini, Visual Studio Enterprise diperlukan, bersama dengan kode .NET dan salah satu kerangka kerja pengujian berikut: MSTest, xUnit, atau NUnit.

1. Lakukan pengujian unit langsung dari menu Pengujian dengan memilih Pengujian>Pengujian Unit Langsung>Mulai.

   

2. Lihat hasil pengujian dalam jendela editor kode saat Anda menulis dan mengedit kode.

   

3. Klik indikator hasil pengujian untuk melihat informasi selengkapnya, seperti nama pengujian yang mencakup metode tersebut.

   

Untuk informasi selengkapnya tentang pengujian unit langsung, lihat Pengujian unit langsung.

Menggunakan kerangka kerja pengujian pihak ketiga

Anda dapat menjalankan pengujian unit di Visual Studio dengan menggunakan kerangka kerja pengujian pihak ketiga seperti Kerangka Kerja Pengujian NUnit, Boost, atau Google C++, bergantung pada bahasa pemrograman Anda. Untuk menggunakan kerangka kerja pihak ketiga:

• Gunakan Manajer Paket NuGet untuk menginstal paket NuGet untuk kerangka kerja pilihan Anda.

• (.NET) Mulai dari Visual Studio 2017 versi 14.6, Visual Studio menyertakan templat proyek pengujian yang telah dikonfigurasi sebelumnya untuk kerangka kerja pengujian NUnit dan xUnit. Templat juga menyertakan paket NuGet yang diperlukan untuk mengaktifkan dukungan.

• (C++) Di Visual Studio 2017 dan versi yang lebih baru, beberapa kerangka kerja seperti Kerangka Kerja Pengujian Google C++ sudah disertakan. Untuk informasi selengkapnya, lihat Menulis pengujian unit untuk C/C++ di Visual Studio.

Untuk menambahkan proyek pengujian unit:

1. Buka solusi yang berisi kode yang ingin Anda uji.

2. Klik kanan pada solusi di Penjelajah Solusi dan pilih Tambahkan>Proyek Baru.

3. Pilih templat proyek pengujian unit.

   Dalam contoh ini, pilih NUnit

   

   Templat proyek mencakup referensi NuGet ke NUnit dan NUnit3TestAdapter.

   

4. Tambahkan referensi dari proyek pengujian ke proyek yang berisi kode yang ingin Anda uji.

   Klik kanan pada proyek di Penjelajah Solusi, lalu pilih Tambahkan>Referensi. (Anda juga dapat menambahkan referensi dari menu klik kanan node Referensi atau Dependensi.)

5. Tambahkan kode ke metode pengujian Anda.

   

6. Jalankan pengujian dari Test Explorer atau dengan mengeklik kanan kode pengujian dan memilih Jalankan Pengujian (atau Ctrl + R, T).

Langkah berikutnya

Dasar-dasar pengujian unit

Membuat dan menjalankan pengujian unit untuk kode terkelola

Menulis pengujian unit untuk C/C++