Tutorial: Menguji pustaka kelas .NET

Tutorial ini menunjukkan cara mengotomatiskan pengujian unit dengan menambahkan proyek pengujian ke solusi.

Prasyarat

Tutorial ini berfungsi dengan solusi yang Anda buat di Buat pustaka kelas .NET.

Membuat proyek pengujian unit

Pengujian unit menyediakan pengujian perangkat lunak secara otomatis dalam proses pengembangan dan penerbitan Anda. MSTest adalah salah satu dari tiga kerangka kerja pengujian yang dapat Anda pilih. Yang lain adalah xUnit dan nUnit.

Mulai Visual Studio.
Buka solusi ClassLibraryProjects yang Anda buat di Buat pustaka kelas .NET.
Tambahkan proyek pengujian unit baru bernama "StringLibraryTest" ke solusi.
1. Klik kanan pada solusi di Solution Explorer dan pilih Tambahkan>Proyek baru.
2. Pada halaman Tambahkan proyek baru , masukkan mstest di kotak pencarian. Pilih C# atau Visual Basic dari daftar Bahasa, lalu pilih Semua platform dari daftar Platform.
3. Pilih templat MSTest Test Project , lalu pilih Berikutnya.
4. Pada halaman Atur proyek baru Anda, masukkan StringLibraryTest di kotak Nama proyek. Kemudian pilih Berikutnya.
5. Pada halaman Informasi tambahan, pilih .NET 10 di kotak Framework, pilih Microsoft.Testing.Platform untuk runner Test, lalu pilih Buat.
Visual Studio membuat proyek dan membuka file kelas di jendela kode dengan kode berikut. Jika bahasa yang ingin Anda gunakan tidak ditampilkan, ubah pemilih bahasa di bagian atas halaman.
```
namespace StringLibraryTest
{

    [TestClass]
    public sealed class Test1
    {
        [TestMethod]
        public void TestMethod1()
        {
        }
    }
}
```
```
Imports Microsoft.VisualStudio.TestTools.UnitTesting

Namespace StringLibraryTest
    <TestClass>
    Public Class Test1
        <TestMethod>
        Sub TestSub()

        End Sub
    End Class
End Namespace
```
Kode sumber yang dibuat oleh templat pengujian unit melakukan hal berikut:
- Termasuk Microsoft.VisualStudio.TestTools.UnitTesting dalam file proyek StringLibraryTest di C#, dan mengimpor Microsoft.VisualStudio.TestTools.UnitTesting di Visual Basic.
- Menerapkan atribut TestClassAttribute ke kelas Test1.
- Menerapkan atribut TestMethodAttribute untuk menentukan TestMethod1 di C# atau TestSub di Visual Basic.
Setiap metode yang ditandai dengan [TestMethod] dalam kelas pengujian yang ditandai dengan [TestClass] dijalankan secara otomatis saat pengujian unit berjalan.

Mulai Visual Studio Code.
Buka solusi ClassLibraryProjects yang Anda buat di Buat pustaka kelas .NET.
Dari Solution Explorer, pilih Proyek Baru, atau dari Palet Perintah pilih .NET: Proyek Baru.
Pilih MSTest Test Project, beri nama "StringLibraryTest", pilih direktori default, dan pilih Buat Proyek.

Templat proyek membuat StringLibraryTest/Test1.cs dengan kode berikut:
```
namespace StringLibraryTest;

[TestClass]
public class Test1
{
    [TestMethod]
    public void TestMethod1()
    {
    }
}
```
Kode sumber yang dibuat oleh templat pengujian unit melakukan hal berikut:
- Ini menerapkan TestClassAttribute atribut ke Test1 kelas .
- Ini menerapkan TestMethodAttribute atribut untuk menentukan TestMethod1.
- Ini mengimpor Microsoft.VisualStudio.TestTools.UnitTesting namespace, yang berisi jenis yang digunakan untuk pengujian unit. Namespace diimpor melalui global using direktif di GlobalUsings.cs.
Setiap metode yang ditandai dengan [TestMethod] dalam kelas pengujian yang ditandai dengan [TestClass] dijalankan secara otomatis saat pengujian unit dipanggil.

Buka terminal dan navigasikan ke folder tutorial yang berisi proyek StringLibrary dan ShowCase.
Buat proyek pengujian MSTest baru:
```
dotnet new mstest -n StringLibraryTest
```
Templat proyek membuat StringLibraryTest/Test1.cs dengan kode berikut:
```
namespace StringLibraryTest;

[TestClass]
public class Test1
{
    [TestMethod]
    public void TestMethod1()
    {
    }
}
```
Kode sumber yang dibuat oleh templat pengujian unit melakukan hal berikut:
- Ini menerapkan TestClassAttribute atribut ke Test1 kelas .
- Ini menerapkan TestMethodAttribute atribut untuk menentukan TestMethod1.
- Ini mengimpor Microsoft.VisualStudio.TestTools.UnitTesting namespace, yang berisi tipe yang digunakan untuk pengujian unit.
Setiap metode yang ditandai dengan [TestMethod] dalam kelas pengujian yang ditandai dengan [TestClass] dijalankan secara otomatis saat pengujian unit dipanggil.

Menambahkan referensi proyek

Agar proyek pengujian berfungsi dengan kelas StringLibrary, tambahkan referensi dari proyek StringLibraryTest ke proyek StringLibrary.

Dalam Solution Explorer, klik kanan simpul Dependencies dari proyek StringLibraryTest dan pilih Tambahkan Referensi Proyek dari menu konteks.
Dalam dialog Manajer Referensi , pilih kotak di samping StringLibrary.
Pilih OK.

Dari Solution Explorer klik kanan pada Proyek 'StringLibraryTest' dan pilih Tambahkan Referensi Proyek.
Pilih "StringLibrary".

Navigasikan ke folder StringLibraryTest dan tambahkan referensi proyek:

cd StringLibraryTest
dotnet add reference ../StringLibrary/StringLibrary.csproj

Menambahkan dan menjalankan metode pengujian unit

Saat pengujian unit berjalan, setiap metode yang ditandai dengan TestMethodAttribute atribut di kelas yang ditandai dengan TestClassAttribute atribut dijalankan secara otomatis. Metode pengujian berakhir ketika kegagalan pertama ditemukan atau ketika semua pengujian yang terkandung dalam metode berhasil.

Tes yang paling umum memanggil anggota kelas Assert tersebut. Banyak metode pernyataan mencakup setidaknya dua parameter, salah satunya adalah hasil pengujian yang diharapkan dan yang lainnya adalah hasil pengujian aktual. Beberapa metode kelas Assert yang paling sering disebut diperlihatkan dalam tabel berikut:

Metode pernyataan	Fungsi
`Assert.AreEqual`	Memverifikasi bahwa dua nilai atau objek sama. Pernyataan gagal jika nilai atau objek tidak sama.
`Assert.AreSame`	Memverifikasi bahwa dua variabel objek merujuk ke objek yang sama. Pernyataan gagal jika variabel merujuk ke objek yang berbeda.
`Assert.IsFalse`	Memverifikasi bahwa suatu kondisi adalah `false`. Pernyataan gagal jika kondisinya adalah `true`.
`Assert.IsNotNull`	Memverifikasi bahwa objek bukan `null`. Asersi akan gagal jika objek adalah `null`.

Anda juga dapat menggunakan metode Assert.Throws dalam metode pengujian untuk menunjukkan tipe pengecualian yang diharapkan akan dilemparkan. Pengujian gagal jika pengecualian yang ditentukan tidak dilemparkan.

Dalam menguji StringLibrary.StartsWithUpper metode , Anda ingin menyediakan sejumlah string yang dimulai dengan karakter huruf besar. Anda mengharapkan metode untuk mengembalikan true dalam kasus ini, sehingga Anda dapat memanggil metode Assert.IsTrue. Demikian pula, Anda ingin menyediakan sejumlah string yang dimulai dengan sesuatu selain karakter huruf besar. Anda mengharapkan metode untuk mengembalikan false dalam kasus ini, sehingga Anda dapat memanggil metode Assert.IsFalse.

Karena metode pustaka Anda menangani string, Anda juga ingin memastikan bahwa metode tersebut berhasil menangani string kosong (String.Empty) dan null string. String kosong adalah string yang tidak memiliki karakter dan yang Length 0. String null adalah string yang belum diinisialisasi. Anda dapat memanggil StartsWithUpper langsung sebagai metode statis dan meneruskan satu String argumen. Atau Anda dapat memanggil StartsWithUpper sebagai metode ekstensi pada variabel yang string ditetapkan ke null.

Anda akan menentukan tiga metode, yang masing-masing memanggil Assert metode untuk setiap elemen dalam array string. Anda akan memanggil kelebihan beban metode yang memungkinkan Anda menentukan pesan kesalahan yang akan ditampilkan jika terjadi kegagalan pengujian. Pesan mengidentifikasi string yang menyebabkan kegagalan.

Untuk membuat metode pengujian:

Di jendela kode Test1.cs atau Test1.vb , ganti kode dengan kode berikut:

using UtilityLibraries;

namespace StringLibraryTest
{
    [TestClass]
    public sealed class Test1
    {
        [TestMethod]
        public void TestStartsWithUpper()
        {
            // Tests that we expect to return true.
            string[] words = ["Alphabet", "Zebra", "ABC", "Αθήνα", "Москва"];
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsTrue(result, $"Expected for '{word}': true; Actual: {result}");
            }
        }

        [TestMethod]
        public void TestDoesNotStartWithUpper()
        {
            // Tests that we expect to return false.
            string[] words = ["alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                          "1234", ".", ";", " "];
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsFalse(result, $"Expected for '{word}': false; Actual: {result}");
            }
        }

        [TestMethod]
        public void DirectCallWithNullOrEmpty()
        {
            // Tests that we expect to return false.
            string?[] words = [string.Empty, null];
            foreach (var word in words)
            {
                bool result = StringLibrary.StartsWithUpper(word);
                Assert.IsFalse(result, $"Expected for '{word ?? "<null>"}': false; Actual: {result}");
            }
        }
    }
}

Imports Microsoft.VisualStudio.TestTools.UnitTesting
Imports UtilityLibraries

Namespace StringLibraryTest
    <TestClass>
    Public Class UnitTest1
        <TestMethod>
        Public Sub TestStartsWithUpper()
            ' Tests that we expect to return true.
            Dim words() As String = {"Alphabet", "Zebra", "ABC", "Αθήνα", "Москва"}
            For Each word In words
                Dim result As Boolean = word.StartsWithUpper()
                Assert.IsTrue(result,
                       $"Expected for '{word}': true; Actual: {result}")
            Next
        End Sub

        <TestMethod>
        Public Sub TestDoesNotStartWithUpper()
            ' Tests that we expect to return false.
            Dim words() As String = {"alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                               "1234", ".", ";", " "}
            For Each word In words
                Dim result As Boolean = word.StartsWithUpper()
                Assert.IsFalse(result,
                       $"Expected for '{word}': false; Actual: {result}")
            Next
        End Sub

        <TestMethod>
        Public Sub DirectCallWithNullOrEmpty()
            ' Tests that we expect to return false.
            Dim words() As String = {String.Empty, Nothing}
            For Each word In words
                Dim result As Boolean = StringLibrary.StartsWithUpper(word)
                Assert.IsFalse(result,
                       $"Expected for '{If(word Is Nothing, "<null>", word)}': false; Actual: {result}")
            Next
        End Sub
    End Class
End Namespace

Pengujian karakter huruf besar dalam metode TestStartsWithUpper mencakup alfa huruf kapital Yunani (U+0391) dan huruf kapital Sirilik EM (U+041C). Pengujian karakter huruf kecil dalam metode TestDoesNotStartWithUpper mencakup alfa huruf kecil Yunani (U+03B1) dan huruf kecil Sirilik Ghe (U+0433).

Pada bilah menu, pilih Simpan File>Test1.cs Sebagai atau Simpan File>Test1.vb Sebagai. Dalam dialog Simpan File Sebagai, pilih panah di samping tombol Simpan , dan pilih Simpan dengan Pengodean.
Dalam dialog Konfirmasi Simpan Sebagai, pilih tombol Ya untuk menyimpan file.
Dalam dialog Opsi Penyimpanan Tingkat Lanjut , pilih Unicode (UTF-8 dengan tanda tangan) - Halaman kode 65001 dari daftar drop-down Pengodean dan pilih OK.

Jika Anda gagal menyimpan kode sumber sebagai file yang dikodekan UTF8, Visual Studio mungkin menyimpannya sebagai file ASCII. Ketika itu terjadi, runtime tidak secara akurat mendekode karakter UTF8 di luar rentang ASCII, dan hasil pengujian tidak benar.
Pada bilah menu, pilih Uji>Jalankan Semua Pengujian. Jika jendela Test Explorer tidak terbuka, buka dengan memilih TestTest Explorer. Ketiga pengujian tercantum di bagian Passed Tests, dan bagian Ringkasan melaporkan hasil pengujian.

Buka StringLibraryTest/Test1.cs dan ganti semua kode dengan kode berikut.

using UtilityLibraries;

namespace StringLibraryTest
{
    [TestClass]
    public sealed class Test1
    {
        [TestMethod]
        public void TestStartsWithUpper()
        {
            // Tests that we expect to return true.
            string[] words = ["Alphabet", "Zebra", "ABC", "Αθήνα", "Москва"];
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsTrue(result, $"Expected for '{word}': true; Actual: {result}");
            }
        }

        [TestMethod]
        public void TestDoesNotStartWithUpper()
        {
            // Tests that we expect to return false.
            string[] words = ["alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                          "1234", ".", ";", " "];
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsFalse(result, $"Expected for '{word}': false; Actual: {result}");
            }
        }

        [TestMethod]
        public void DirectCallWithNullOrEmpty()
        {
            // Tests that we expect to return false.
            string?[] words = [string.Empty, null];
            foreach (var word in words)
            {
                bool result = StringLibrary.StartsWithUpper(word);
                Assert.IsFalse(result, $"Expected for '{word ?? "<null>"}': false; Actual: {result}");
            }
        }
    }
}

Simpan perubahan Anda.

Membuat dan menjalankan pengujian Anda

Di Solution Explorer, klik kanan solusi dan pilih Build atau dari Palet Perintah, pilih .NET: Build.
Pilih jendela Pengujian , pilih Jalankan Pengujian atau dari Palet Perintah, pilih Uji: Jalankan semua Pengujian.

Buka StringLibraryTest/Test1.cs dan ganti semua kode dengan kode berikut:

using UtilityLibraries;

namespace StringLibraryTest
{
    [TestClass]
    public sealed class Test1
    {
        [TestMethod]
        public void TestStartsWithUpper()
        {
            // Tests that we expect to return true.
            string[] words = ["Alphabet", "Zebra", "ABC", "Αθήνα", "Москва"];
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsTrue(result, $"Expected for '{word}': true; Actual: {result}");
            }
        }

        [TestMethod]
        public void TestDoesNotStartWithUpper()
        {
            // Tests that we expect to return false.
            string[] words = ["alphabet", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                          "1234", ".", ";", " "];
            foreach (var word in words)
            {
                bool result = word.StartsWithUpper();
                Assert.IsFalse(result, $"Expected for '{word}': false; Actual: {result}");
            }
        }

        [TestMethod]
        public void DirectCallWithNullOrEmpty()
        {
            // Tests that we expect to return false.
            string?[] words = [string.Empty, null];
            foreach (var word in words)
            {
                bool result = StringLibrary.StartsWithUpper(word);
                Assert.IsFalse(result, $"Expected for '{word ?? "<null>"}': false; Actual: {result}");
            }
        }
    }
}

Simpan perubahan Anda dan jalankan pengujian:
```
dotnet test
```
Tes harus lulus.

Menangani kegagalan pengujian

Jika Anda melakukan pengembangan berbasis pengujian (TDD), Anda menulis pengujian terlebih dahulu dan mereka gagal saat pertama kali menjalankannya. Kemudian Anda menambahkan kode ke aplikasi yang membuat pengujian berhasil. Untuk tutorial ini, Anda membuat pengujian setelah menulis kode aplikasi yang divalidasinya, sehingga Anda belum melihat pengujian gagal. Untuk memvalidasi bahwa pengujian gagal ketika Anda mengharapkannya gagal, tambahkan nilai yang tidak valid ke input pengujian.

Ubah array words dalam metode TestDoesNotStartWithUpper untuk menyertakan string "Kesalahan".

string[] words = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " };

Dim words() As String = { "alphabet", "Error", "zebra", "abc", "αυτοκινητοβιομηχανία", "государство",
                   "1234", ".", ";", " " }

Jalankan pengujian dengan memilih Uji>Jalankan Semua Pengujian dari bilah menu. Jendela Test Explorer menunjukkan bahwa dua pengujian berhasil dan satu gagal.
Pilih pengujian yang gagal, TestDoesNotStartWith.

Jendela Test Explorer menampilkan pesan yang dihasilkan oleh pernyataan: "Assert.IsFalse gagal. Diharapkan untuk 'Kesalahan': false; aktual: Benar." Karena kegagalan, string dalam array setelah "Kesalahan" tidak diuji.

Jalankan pengujian dengan mengklik kesalahan hijau di samping pengujian di editor.

Output menunjukkan bahwa pengujian tersebut gagal, dan memberikan pesan kesalahan: "Assert.IsFalse gagal. Diharapkan untuk 'Kesalahan': false; aktual: Benar". Karena kegagalan, tidak ada string dalam array setelah "Kesalahan" diuji.

Jalankan pengujian:
```
dotnet test
```
Output menunjukkan bahwa pengujian tersebut gagal, dan memberikan pesan kesalahan: "Assert.IsFalse gagal. Diharapkan untuk 'Kesalahan': false; aktual: Benar". Karena kegagalan, tidak ada string dalam array setelah "Kesalahan" diuji.

Hapus string "Kesalahan" yang Anda tambahkan.
Jalankan ulang tes dan tes berhasil.

Menguji versi rilis perpustakaan

Sekarang setelah semua pengujian lulus saat menjalankan build Debug pustaka, jalankan pengujian sekali lagi pada build Rilis pustaka. Sejumlah faktor, termasuk pengoptimalan pengkompilasi, terkadang dapat menghasilkan perilaku yang berbeda antara build Debug dan Rilis.

Untuk menguji versi rilis:

Di toolbar Visual Studio, ubah konfigurasi build dari Debug menjadi Release.
Di Solution Explorer, klik kanan proyek StringLibrary dan pilih Build dari menu konteks untuk mengkompilasi ulang pustaka.
Jalankan pengujian unit dengan memilih Uji>Jalankan Semua Pengujian dari bilah menu. Tes lulus.

Jalankan pengujian dengan konfigurasi build Rilis:

dotnet test StringLibraryTest/StringLibraryTest.csproj --configuration Release

Tes lulus.

Jalankan pengujian dengan konfigurasi build Rilis:

dotnet test --configuration Release

Tes lulus.

Tes penyaringan kesalahan

Jika Anda menggunakan Visual Studio sebagai IDE, Anda dapat menggunakan proses yang sama yang ditampilkan di Tutorial: Debug aplikasi konsol .NET untuk men-debug kode menggunakan proyek pengujian unit Anda. Alih-alih memulai proyek aplikasi ShowCase , klik kanan proyek StringLibraryTests , dan pilih Debug Tests dari menu konteks.

Visual Studio memulai proyek pengujian dengan debugger terlampir. Eksekusi berhenti pada titik henti apa pun yang telah Anda tambahkan ke proyek pengujian atau kode pustaka yang mendasar.

Jika Anda menggunakan Visual Studio Code sebagai IDE, Anda dapat menggunakan proses yang sama yang ditampilkan di Debug aplikasi konsol .NET untuk men-debug kode menggunakan proyek pengujian unit Anda. Alih-alih memulai proyek aplikasi ShowCase , buka StringLibraryTest/Test1.cs, dan pilih Debug Pengujian dalam file saat ini antara baris 7 dan 8. Jika Anda tidak dapat menemukannya, tekan Ctrl+Shift+P untuk membuka palet perintah dan masukkan Jendela Muat Ulang.

Visual Studio Code memulai proyek pengujian dengan debugger terlampir. Eksekusi akan berhenti pada titik henti apa pun yang telah Anda tambahkan ke proyek pengujian atau kode pustaka yang mendasar.

Sumber daya tambahan

Dasar-Dasar Unit Test - Visual Studio
Unit testing dalam .NET

Unit testing dalam .NET

Membersihkan sumber daya

GitHub secara otomatis menghapus Codespace Anda setelah 30 hari tidak aktif. Jika Anda berencana untuk menjelajahi lebih banyak tutorial di seri ini, Anda dapat membiarkan Codespace Anda tetap tersedia. Jika Anda siap untuk mengunjungi situs .NET untuk mengunduh SDK .NET, Anda dapat menghapus Codespace Anda. Untuk menghapus Codespace Anda, buka jendela browser dan navigasikan ke Codespace Anda. Anda melihat daftar codespace Anda di jendela. Pilih tiga titik (...) dalam entri untuk ruang kode tutorial pembelajaran. Lalu pilih "Hapus".

Langkah selanjutnya

Dalam tutorial ini, Anda unit menguji pustaka kelas. Anda dapat membuat pustaka tersedia untuk orang lain dengan menerbitkannya ke NuGet sebagai paket. Untuk mempelajari caranya, ikuti tutorial NuGet:

Membuat dan menerbitkan paket menggunakan CLI dotnet

Jika Anda menerbitkan pustaka sebagai paket NuGet, orang lain dapat menginstal dan menggunakannya. Untuk mempelajari caranya, ikuti tutorial NuGet:

Menginstal dan menggunakan paket menggunakan dotnet CLI

Pustaka tidak harus didistribusikan sebagai paket. Ini dapat dibundel dengan aplikasi konsol yang menggunakannya. Untuk mempelajari cara menerbitkan aplikasi konsol, lihat tutorial sebelumnya dalam seri ini:

Menerbitkan aplikasi konsol .NET

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-03-11