Bagikan melalui

Referensi opsi CLI pada Microsoft.Testing.Platform

Artikel ini memberikan titik masuk pusat untuk opsi baris perintah Microsoft.Testing.Platform.

Pilihan platform

  • @

    Menentukan nama file respons. Nama file respons harus segera mengikuti @ karakter tanpa spasi kosong antara @ karakter dan nama file respons.

    Opsi dalam file respons ditafsirkan seolah-olah ada di tempat tersebut di baris perintah. Anda tidak dapat menggunakan karakter backslash \ untuk menggabungkan baris. Menggunakan file respons membantu untuk perintah yang sangat panjang yang mungkin melebihi batas terminal. Anda dapat menggabungkan file respons dengan argumen baris perintah secara langsung. Contohnya:

    ./TestExecutable.exe @"filter.rsp" --timeout 10s

    di mana filter.rsp dapat memiliki konten berikut:

    --filter "A very long filter"

    Atau satu file rsp dapat digunakan untuk menentukan batas waktu dan filter sebagai berikut:

    ./TestExecutable.exe @"arguments.rsp"

    --filter "A very long filter" --timeout 10s

    Nota

    Saat menggunakan dotnet test, pengurai baris perintah SDK menggunakan pendekatan token per baris di mana setiap baris dalam file respons diperlakukan sebagai token tunggal. Dalam hal ini, setiap argumen harus berada di baris terpisah:

    --filter
A very long filter
--timeout
10s

  • --config-file

    Menentukan file testconfig.json.

  • --diagnostic

    Mengaktifkan pembuatan log diagnostik. Tingkat log default adalah Trace. File ditulis dalam direktori output dengan format nama berikut, log_[MMddHHssfff].diag.

  • --diagnostic-synchronous-write

    Memaksa pencatat file bawaan untuk menulis log secara sinkron. Berguna untuk skenario di mana Anda tidak ingin kehilangan entri log apa pun (jika proses crash). Ini memperlambat eksekusi pengujian.

  • --diagnostic-output-directory

    Direktori keluaran untuk pencatatan diagnostik, jika tidak ditentukan, file akan dihasilkan dalam direktori default TestResults.

  • --diagnostic-file-prefix

    Awalan untuk nama file log. Secara default menjadi "log".

  • --diagnostic-verbosity

    Menentukan tingkat verbositas saat sakelar --diagnostic digunakan. Nilai yang tersedia adalah Trace, Debug, Information, Warning, Error, atau Critical.

  • --exit-on-process-exit

    Hentikan proses pengujian jika proses dependen berhenti. PID harus disediakan.

  • --help

    Mencetak deskripsi cara menggunakan perintah.

  • --ignore-exit-code

    Memungkinkan beberapa kode keluar bukan nol diabaikan atau sebaliknya dikembalikan sebagai 0. Untuk informasi selengkapnya, lihat Abaikan kode keluar tertentu.

  • --info

    Menampilkan informasi lanjutan tentang Aplikasi Pengujian .NET seperti:

    • Platform tersebut.
    • Lingkungan.
    • Setiap penyedia baris perintah terdaftar, seperti name, version, description, dan options.
    • Setiap alat terdaftar, seperti command, name, version, description, dan semua penyedia baris perintah.

    Fitur ini digunakan untuk memahami ekstensi yang akan mendaftarkan opsi baris perintah yang sama atau perubahan opsi yang tersedia antara beberapa versi ekstensi (atau platform).

  • --list-tests

    Mencantumkan pengujian yang tersedia. Pengujian tidak akan dijalankan.

  • --maximum-failed-tests

    Menentukan jumlah maksimum kegagalan pengujian yang, ketika tercapai, akan menghentikan eksekusi pengujian. Dukungan untuk sakelar ini memerlukan pengembang kerangka kerja untuk mengimplementasikan kemampuan IGracefulStopTestExecutionCapability. Kode keluar saat mencapai jumlah kegagalan pengujian adalah 13. Untuk informasi selengkapnya, lihat kode keluar Microsoft.Testing.Platform di dan.

    Nota

    Fitur ini tersedia di Microsoft.Testing.Platform yang dimulai dengan versi 1.5.

  • --minimum-expected-tests

    Menentukan jumlah minimum pengujian yang diharapkan untuk dijalankan. Secara default, setidaknya satu pengujian diharapkan berjalan.

  • --results-directory

    Direktori tempat hasil pengujian akan ditempatkan. Jika direktori yang ditentukan tidak ada, direktori tersebut akan dibuat. Defaultnya adalah TestResults di direktori yang berisi aplikasi pengujian.

  • --timeout

    Batas waktu eksekusi pengujian global. Mengambil satu argumen sebagai string dalam format <value>[h|m|s] di mana <value> mengambang.

Opsi ekstensi menurut skenario

Gunakan tabel berikut untuk menemukan opsi ekstensi dengan cepat.

Skenario Dokumentasi fitur
Mengumpulkan cakupan kode Cakupan kode
Mengumpulkan crash atau hang dump Crash dan hang dump
Membuat laporan pengujian (misalnya TRX) Laporan pengujian
Menyesuaikan output terminal Keluaran terminal
Menerapkan kontrol tingkat hosting Hot Reload
Coba lagi pengujian yang gagal Coba lagi
Menjalankan pengujian yang menggunakan Microsoft Fakes Microsoft Fakes
Mengirim jejak dan metrik OpenTelemetry OpenTelemetry

Menemukan opsi di aplikasi pengujian Anda

Jalankan executable pengujian Anda dengan --help untuk mencantumkan opsi yang tersedia untuk kumpulan ekstensi Anda saat ini.

Untuk diagnostik tingkat lanjut dari penyedia dan opsi terdaftar, jalankan dengan --info.

Baca juga

  • Last updated on