Bagikan melalui

Mulai Cepat: Memecahkan masalah pengujian dengan Pratinjau Pengujian Microsoft Playwright

Dalam mulai cepat ini, Anda mempelajari cara memecahkan masalah pengujian Playwright dengan mudah menggunakan laporan dan artefak yang diterbitkan di Pratinjau Pengujian Microsoft Playwright. Selain itu, panduan ini menunjukkan cara menggunakan fitur pelaporan, terlepas dari apakah Anda menjalankan pengujian di browser yang dihosting cloud yang disediakan oleh layanan.

Setelah menyelesaikan mulai cepat ini, Anda akan memiliki ruang kerja Microsoft Playwright Testing untuk melihat hasil pengujian dan artefak di portal layanan.

Penting

Pengujian Microsoft Playwright saat ini dalam pratinjau. Untuk persyaratan hukum yang berlaku untuk fitur Azure yang beta, dalam pratinjau, atau belum dirilis ke ketersediaan umum, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Latar belakang

Layanan Pengujian Microsoft Playwright memungkinkan Anda untuk:

  • Mempercepat alur build dengan menjalankan pengujian secara paralel menggunakan browser yang dihosting cloud.
  • Sederhanakan pemecahan masalah dengan menerbitkan hasil pengujian dan artefak ke layanan, membuatnya dapat diakses melalui portal layanan.

Kedua fitur layanan ini dapat digunakan secara independen atau bersama-sama, dan masing-masing memiliki paket harganya sendiri. Anda memiliki fleksibilitas untuk:

  • Mempercepat eksekusi pengujian dan menyederhanakan pemecahan masalah dengan menggunakan kedua fitur: menjalankan pengujian di browser yang dihosting cloud dan menerbitkan hasil ke layanan.
  • Jalankan pengujian hanya di browser yang dihosting cloud untuk menyelesaikan eksekusi pengujian lebih cepat.
  • Terbitkan hasil pengujian ke layanan sambil terus menjalankan pengujian secara lokal untuk pemecahan masalah yang efisien.

Catatan

Artikel ini berfokus pada bagaimana Anda dapat menerbitkan hasil pengujian ke layanan tanpa menggunakan browser yang dihosting cloud. Jika Anda ingin mempelajari cara juga mempercepat eksekusi pengujian, lihat mulai cepat: menjalankan pengujian Playwright dalam skala besar

Prasyarat

Membuat ruang kerja

Untuk mulai menerbitkan hasil pengujian pada layanan Pengujian Playwright, pertama-tama buat ruang kerja Pengujian Microsoft Playwright di portal Playwright.

  1. Masuk ke portal Playwright dengan akun Azure Anda.

  2. Jika Anda sudah memiliki ruang kerja, pilih ruang kerja yang sudah ada, dan pindah ke langkah berikutnya.

    Tip

    Jika Anda memiliki beberapa ruang kerja, Anda dapat beralih ke ruang kerja lain dengan memilih nama ruang kerja di bagian atas halaman, lalu pilih Kelola semua ruang kerja.

  3. Jika Anda belum memiliki ruang kerja, pilih + Ruang kerja baru, lalu berikan informasi berikut:

    Bidang Deskripsi
    Nama ruang kerja Masukkan nama unik untuk mengidentifikasi ruang kerja Anda.
    Nama hanya dapat terdiri dari karakter alfanumerik, dan memiliki panjang antara 3 dan 64 karakter.
    Langganan Azure Pilih langganan Azure yang ingin Anda gunakan untuk ruang kerja Pengujian Microsoft Playwright ini.
    Wilayah Pilih lokasi geografis untuk menghosting ruang kerja Anda.
    Ini adalah lokasi tempat data uji coba disimpan untuk ruang kerja.

    Cuplikan layar yang memperlihatkan halaman 'Buat ruang kerja' di portal Playwright.

  4. Pilih Buat ruang kerja untuk membuat ruang kerja di langganan Anda.

    Selama pembuatan ruang kerja, grup sumber daya baru dan sumber daya Microsoft Playwright Testing Azure dibuat di langganan Azure Anda.

Setelah pembuatan ruang kerja selesai, Anda diarahkan ke panduan penyiapan.

Menginstal paket Pengujian Microsoft Playwright

Untuk menggunakan layanan ini, instal paket Pengujian Microsoft Playwright.

npm init @azure/microsoft-playwright-testing@latest

Catatan

Pastikan proyek Anda menggunakan @playwright/test versi 1.47 atau lebih tinggi.

Perintah ini menghasilkan playwright.service.config.ts file yang berfungsi untuk:

  • Arahkan dan autentikasi klien Playwright Anda ke layanan Pengujian Microsoft Playwright.
  • Menambahkan wartawan untuk menerbitkan hasil pengujian dan artefak.

Jika Anda sudah memiliki file ini, perintah meminta Anda untuk mengambil alihnya.

Untuk hanya menggunakan fitur pelaporan untuk uji coba, nonaktifkan browser yang dihosting cloud dengan mengatur useCloudHostedBrowsers sebagai false.

export default defineConfig(
  config,
  getServiceConfig(config, {
    timeout: 30000,
    os: ServiceOS.LINUX,
	useCloudHostedBrowsers: false // Do not use cloud hosted browsers
  }),
  {
    reporter: [['list'], ['@azure/microsoft-playwright-testing/reporter']], // Reporter for Microsoft Playwright Testing service
  }
);

Mengatur nilai sebagai false memastikan bahwa browser yang dihosting cloud tidak digunakan untuk menjalankan pengujian. Pengujian berjalan pada komputer lokal Anda tetapi hasil dan artefak diterbitkan pada layanan.

Untuk menggunakan layanan ini, instal paket Pengujian Microsoft Playwright.

dotnet add package Azure.Developer.MicrosoftPlaywrightTesting.NUnit --prerelease

Catatan

Pastikan proyek Anda menggunakan Microsoft.Playwright.NUnit versi 1.47 atau lebih tinggi.

Untuk hanya menggunakan fitur pelaporan, perbarui yang berikut ini dalam .runsettings file proyek Anda:

  1. Nonaktifkan browser yang dihosting cloud dengan mengatur useCloudHostedBrowsers sebagai false.
  2. Tambahkan pencatat Pengujian Microsoft Playwright di bagian 'Pencatat'.
<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
    <TestRunParameters>        
        <!--Select if you want to use cloud-hosted browsers to run your Playwright tests.-->
        <Parameter name="UseCloudHostedBrowsers" value="true" />
        <!--Select the authentication method you want to use with Entra-->
    </TestRunParameters> 
 .
 .
 .
    <LoggerRunSettings>
        <Loggers>
            <!--Microsoft Playwright Testing service logger for reporting -->
            <Logger friendlyName="microsoft-playwright-testing" enabled="True" />
            <!--could enable any logger additionally -->
            <Logger friendlyName="trx" enabled="false" />
        </Loggers>
    </LoggerRunSettings>
</RunSettings>

Tip

Jika Anda ingin mempercepat uji coba menggunakan browser yang dihosting cloud, Anda dapat mengatur useCloudHostedBrowsers sebagai true. Ini akan menjalankan pengujian Anda pada browser yang dikelola layanan.

Mengonfigurasi titik akhir wilayah layanan

Dalam penyiapan, Anda harus menyediakan titik akhir layanan khusus wilayah. Titik akhir bergantung pada wilayah Azure yang Anda pilih saat membuat ruang kerja.

Untuk mendapatkan URL titik akhir layanan, lakukan langkah-langkah berikut:

  1. Di Tambahkan titik akhir wilayah dalam penyiapan Anda, salin titik akhir wilayah untuk ruang kerja Anda.

    URL titik akhir cocok dengan wilayah Azure yang Anda pilih saat membuat ruang kerja. Pastikan URL ini tersedia dalam PLAYWRIGHT_SERVICE_URL variabel lingkungan.

    Cuplikan layar yang memperlihatkan cara menyalin titik akhir wilayah ruang kerja di portal Pengujian Playwright.

Menyiapkan lingkungan Anda

Untuk menyiapkan lingkungan, Anda harus mengonfigurasi PLAYWRIGHT_SERVICE_URL variabel lingkungan dengan nilai yang Anda peroleh di langkah-langkah sebelumnya.

Kami menyarankan agar Anda menggunakan dotenv modul untuk mengelola lingkungan Anda. Dengan dotenv, Anda menentukan variabel lingkungan Anda dalam .env file.

  1. dotenv Tambahkan modul ke proyek Anda:

    npm i --save-dev dotenv

  2. Buat .env file bersama playwright.config.ts file di proyek Playwright Anda:

    PLAYWRIGHT_SERVICE_URL={MY-REGION-ENDPOINT}

    Pastikan untuk mengganti {MY-REGION-ENDPOINT} tempat penampung teks dengan nilai yang Anda salin sebelumnya.

Menyiapkan konfigurasi layanan

Buat file PlaywrightServiceSetup.cs di direktori akar dengan konten berikut.

using Azure.Developer.MicrosoftPlaywrightTesting.NUnit;

namespace PlaywrightTests; // Remember to change this as per your project namespace

[SetUpFixture]
public class PlaywrightServiceSetup : PlaywrightServiceNUnit {};

Catatan

Pastikan proyek Anda menggunakan Microsoft.Playwright.NUnit versi 1.47 atau lebih tinggi.

Mengonfigurasikan autentikasi

Untuk menerbitkan hasil pengujian dan artefak ke ruang kerja Microsoft Playwright Testing, Anda perlu mengautentikasi klien Playwright tempat Anda menjalankan pengujian dengan layanan. Klien bisa menjadi komputer dev lokal atau mesin CI Anda.

Layanan ini menawarkan dua metode autentikasi: ID Microsoft Entra dan Token Akses.

ID Microsoft Entra menggunakan kredensial Azure Anda, memerlukan masuk ke akun Azure Anda untuk akses yang aman. Atau, Anda dapat menghasilkan token akses dari ruang kerja Playwright dan menggunakannya dalam penyiapan Anda.

Menyiapkan autentikasi menggunakan ID Microsoft Entra

ID Microsoft Entra adalah autentikasi default dan direkomendasikan untuk layanan. Dari komputer dev lokal, Anda dapat menggunakan Azure CLI untuk masuk

az login

Catatan

Jika Anda adalah bagian dari beberapa penyewa Microsoft Entra, pastikan Anda masuk ke penyewa tempat ruang kerja Anda berada. Anda bisa mendapatkan ID penyewa dari portal Azure. Untuk informasi selengkapnya, lihat Menemukan Penyewa Microsoft Entra Anda. Setelah Anda mendapatkan ID, masuk menggunakan perintah az login --tenant <TenantID>

Menyiapkan autentikasi menggunakan token akses

Anda dapat membuat token akses dari ruang kerja Pengujian Playwright dan menggunakannya dalam penyiapan Anda. Namun, kami sangat merekomendasikan ID Microsoft Entra untuk autentikasi karena keamanannya yang ditingkatkan. Token akses, meskipun nyaman, berfungsi seperti kata sandi berumur panjang dan lebih rentan disusupi.

  1. Autentikasi menggunakan token akses dinonaktifkan secara default. Untuk digunakan, Aktifkan autentikasi berbasis token akses

  2. Menyiapkan autentikasi menggunakan token akses

Perhatian

Sebaiknya gunakan ID Microsoft Entra untuk autentikasi ke layanan. Jika Anda menggunakan token akses, lihat Cara Mengelola Token Akses

Mengaktifkan artefak dalam penyiapan Playwright Anda

playwright.config.ts Dalam file proyek Anda, pastikan Anda mengumpulkan semua artefak yang diperlukan.

  use: {
    trace: 'on-first-retry',
    video:'retain-on-failure',
    screenshot:'on'
  }

Aktifkan artefak seperti cuplikan layar, video, dan jejak yang akan diambil oleh Playwright.

Setelah Anda mengumpulkan artefak ini, lampirkan ke untuk memastikan artefak tersebut TestContext tersedia dalam laporan pengujian Anda. Untuk informasi selengkapnya, lihat proyek sampel kami untuk NUnit

Jalankan pengujian Anda dan terbitkan hasilnya di Pengujian Microsoft Playwright

Anda sekarang telah menyiapkan konfigurasi untuk menerbitkan hasil pengujian dan artefak dengan Microsoft Playwright Testing. Jalankan pengujian menggunakan file yang baru dibuat playwright.service.config.ts dan terbitkan hasil pengujian dan artefak ke layanan.

   npx playwright test --config=playwright.service.config.ts

Catatan

Untuk fitur Pelaporan Pengujian Microsoft Playwright, Anda akan dikenakan biaya berdasarkan hasil pengujian angka yang diterbitkan. Jika Anda adalah pengguna pertama kali atau memulai uji coba gratis, Anda mungkin mulai menerbitkan hasil pengujian tunggal alih-alih rangkaian pengujian lengkap Anda untuk menghindari kelelahan batas uji coba gratis Anda.

Setelah pengujian selesai, Anda dapat melihat status pengujian di terminal.

Running 6 test using 2 worker
    5 passed, 1 failed (20.2s)

Test report: https://playwright.microsoft.com/workspaces/<workspace-id>/runs/<run-id>

Anda sekarang telah menyiapkan konfigurasi untuk menerbitkan hasil pengujian dan artefak dengan Microsoft Playwright Testing. Jalankan pengujian menggunakan file dan terbitkan .runsettings hasil pengujian dan artefak ke layanan.

dotnet test --settings:.runsettings

Pengaturan untuk uji coba Anda ditentukan dalam .runsettings file. Untuk informasi selengkapnya, lihat cara menggunakan opsi paket layanan

Catatan

Untuk fitur Pelaporan Pengujian Microsoft Playwright, Anda akan dikenakan biaya berdasarkan hasil pengujian angka yang diterbitkan. Jika Anda adalah pengguna pertama kali atau memulai uji coba gratis, Anda mungkin mulai menerbitkan hasil pengujian tunggal alih-alih rangkaian pengujian lengkap Anda untuk menghindari kelelahan batas uji coba gratis Anda.

Setelah uji coba selesai, Anda dapat melihat status pengujian di terminal.

Starting test execution, please wait...

Initializing reporting for this test run. You can view the results at: https://playwright.microsoft.com/workspaces/<workspace-id>/runs/<run-id>

A total of 100 test files matched the specified pattern.

Test Report: https://playwright.microsoft.com/workspaces/<workspace-id>/runs/<run-id>

Passed!  - Failed:     0, Passed:     100, Skipped:     0, Total:     100, Duration: 10 m - PlaywrightTestsNUnit.dll (net7.0)

Workload updates are available. Run `dotnet workload list` for more information.

Perhatian

Bergantung pada ukuran rangkaian pengujian, Anda mungkin dikenakan biaya tambahan untuk hasil pengujian di luar hasil pengujian gratis yang dialokasikan.

Melihat eksekusi pengujian dan hasil di portal Playwright

Anda sekarang dapat memecahkan masalah kasus pengujian yang gagal di portal Playwright.

  1. Setelah uji coba selesai, tautan ke Portal Playwright dibuat. Buka tautan ini untuk melihat hasil pengujian terperinci dan artefak terkait. Portal menampilkan informasi penting, termasuk:

    • Detail build CI
    • Status eksekusi pengujian secara keseluruhan
    • ID penerapan yang ditautkan ke eksekusi pengujian

    Cuplikan layar yang memperlihatkan daftar pengujian dalam eksekusi pengujian.

  2. Portal Playwright menyediakan semua informasi yang diperlukan untuk pemecahan masalah. Anda dapat:

    • Beralih di antara percobaan ulang.
    • Lihat log kesalahan terperinci, langkah pengujian, dan artefak terlampir seperti cuplikan layar atau video.
    • Navigasikan langsung ke Penampil Jejak untuk analisis yang lebih mendalam.

    Cuplikan layar yang memperlihatkan pratinjau pengujian.

  3. Penampil Jejak memungkinkan Anda untuk menelusuri eksekusi pengujian Anda secara visual. Anda dapat:

    • Gunakan garis waktu untuk mengarahkan mouse ke atas langkah-langkah individual, memperlihatkan status halaman sebelum dan sesudah setiap tindakan.
    • Periksa log terperinci, rekam jepret DOM, aktivitas jaringan, kesalahan, dan output konsol untuk setiap langkah.

    Cuplikan layar yang memperlihatkan penampil jejak.

  1. Setelah uji coba selesai, Anda akan mendapatkan tautan ke portal Playwright di terminal Anda. Buka tautan ini untuk melihat hasil pengujian terperinci dan artefak terkait. Portal menampilkan informasi penting, termasuk:

    • Detail build CI
    • Status eksekusi pengujian secara keseluruhan
    • ID penerapan yang ditautkan ke eksekusi pengujian

    Cuplikan layar yang memperlihatkan daftar pengujian dalam eksekusi pengujian.

  2. Portal Playwright menyediakan semua informasi yang diperlukan untuk pemecahan masalah. Anda dapat:

    • Lihat log kesalahan terperinci, dan artefak terlampir seperti cuplikan layar atau video.
    • Navigasikan langsung ke Penampil Jejak untuk analisis yang lebih mendalam.

    Cuplikan layar yang memperlihatkan pratinjau pengujian.

Catatan

Beberapa metadata, seperti pemilik, deskripsi, dan kategori, saat ini tidak ditampilkan di dasbor layanan. Jika ada informasi tambahan yang ingin Anda lihat disertakan, kirimkan masalah GitHub di repositori kami.

  1. Penampil Jejak memungkinkan Anda untuk menelusuri eksekusi pengujian Anda secara visual. Anda dapat:

    • Gunakan garis waktu untuk mengarahkan mouse ke atas langkah-langkah individual, memperlihatkan status halaman sebelum dan sesudah setiap tindakan.
    • Periksa log terperinci, rekam jepret DOM, aktivitas jaringan, kesalahan, dan output konsol untuk setiap langkah.

    Cuplikan layar yang memperlihatkan penampil jejak.

Tip

Anda juga dapat menggunakan layanan Pengujian Microsoft Playwright untuk menjalankan pengujian secara paralel menggunakan browser yang dihosting cloud. Browser pelaporan dan yang dihosting cloud adalah fitur independen dan ditagih secara terpisah. Anda dapat menggunakan salah satu dari ini atau keduanya. Untuk detailnya, lihat Cara menggunakan fitur layanan

Catatan

Hasil pengujian dan artefak yang Anda terbitkan dipertahankan pada layanan selama 90 hari. Setelah itu, mereka secara otomatis dihapus.

Langkah selanjutnya

Anda telah berhasil membuat ruang kerja Microsoft Playwright Testing di portal Playwright dan menjalankan pengujian Playwright Anda di browser cloud.

Lanjutkan ke mulai cepat berikutnya untuk menyiapkan pengujian end-to-end berkelanjutan dengan menjalankan pengujian Playwright di alur kerja CI/CD Anda.

Menyiapkan pengujian end-to-end berkelanjutan di CI/CD