Bagikan melalui

Pratinjau Pengujian Microsoft Playwright

Pengujian Microsoft Playwright adalah layanan Azure yang dikelola sepenuhnya yang menggunakan cloud untuk memungkinkan Anda menjalankan pengujian Playwright dengan paralelisasi yang jauh lebih tinggi di berbagai kombinasi browser sistem operasi secara bersamaan. Ini berarti pengujian berjalan lebih cepat dengan cakupan skenario yang lebih luas, yang membantu mempercepat pengiriman fitur tanpa mengorbankan kualitas. Layanan ini juga memungkinkan Anda menerbitkan hasil pengujian dan artefak terkait ke layanan dan melihatnya di portal layanan yang memungkinkan pemecahan masalah yang lebih cepat dan lebih mudah. Dengan layanan Microsoft Playwright Testing, Anda dapat merilis fitur dengan lebih cepat dan lebih percaya diri.

Siap untuk memulai? Langsung ke panduan mulai cepat kami!

Memulai

Ikuti langkah-langkah ini untuk menjalankan rangkaian pengujian Playwright yang ada dengan layanan ini.

Prasyarat

  • Akun Azure dengan langganan aktif. Jika Anda tidak memiliki langganan Azure, membuat akun gratis sebelum memulai.
  • Akun Azure Anda harus diberiPemilik , kontributor , atau salah satu peran administrator klasik .
  • Azure CLI harus diinstal di komputer tempat Anda menjalankan pengujian Playwright.

Membuat Ruang Kerja

  1. Masuk ke portal Playwright dengan akun Azure Anda.

  2. Buat Ruang Kerja.

    Membuat ruang kerja baru

    Kebun Deskripsi
    Nama Ruang Kerja Nama unik untuk mengidentifikasi ruang kerja Anda.
    Nama tidak boleh berisi karakter atau spasi kosong khusus.
    Langganan Azure Pilih langganan Azure tempat Anda ingin membuat ruang kerja.
    Wilayah Di sinilah data uji coba akan disimpan untuk ruang kerja Anda.

Jika Anda tidak melihat layar ini, pilih ruang kerja yang sudah ada dan buka bagian berikutnya.

Menginstal paket Pengujian Microsoft Playwright

  1. Jalankan perintah ini untuk menginstal paket layanan

    npm init @azure/microsoft-playwright-testing

Menginstal paket layanan akan membuat file konfigurasi layanan bernama playwright.service.config.ts

Konfigurasi layanan berfungsi untuk:

  • Arahkan dan autentikasi Playwright ke layanan Microsoft Playwright Testing.
  • Tambahkan pelaporan Pengujian Microsoft Playwright ke konfigurasi Anda.
  • Ambil alih batas waktu untuk operasi layanan, jika diperlukan.

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

Mendapatkan titik akhir wilayah

  1. Di portal Playwright, salin perintah di bawah Tambahkan titik akhir wilayah di pengaturan Anda.

    Mengatur titik akhir ruang kerja

    URL titik akhir sesuai dengan wilayah ruang kerja. Anda mungkin melihat URL titik akhir yang berbeda di portal Playwright, tergantung pada wilayah yang Anda pilih saat membuat ruang kerja.

Menyiapkan lingkungan

Pastikan bahwa PLAYWRIGHT_SERVICE_URL yang Anda peroleh di langkah sebelumnya tersedia di lingkungan Anda.

Sebaiknya gunakan modul dotenv untuk mengelola lingkungan Anda. Dengan dotenv Anda akan menggunakan file .env untuk menentukan variabel lingkungan Anda.

Jangan lupa untuk menambahkan file .env ke file .gitignore Anda agar tidak membocorkan rahasia Anda.

npm i --save-dev dotenv

file .env

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/accounts/workspace-id/browsers

Menyiapkan Autentikasi

Untuk menjalankan pengujian Playwright di ruang kerja Microsoft Playwright Testing, Anda perlu mengautentikasi klien Playwright tempat Anda menjalankan pengujian dengan layanan. Ini bisa menjadi mesin 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 Microsoft Azure, lihat MenemukanPenyewa 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. Untuk menggunakan autentikasi berbasis token akses, Mengaktifkan autentikasi berbasis token akses

  2. Menyiapkan autentikasi menggunakan token akses

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

CATATAN: Untuk menggunakan Pengujian Microsoft Playwright di alur CI, Anda perlu mengonfigurasi autentikasi dengan layanan dari alur, lihat menyiapkan pengujian end-to-end berkelanjutan di berbagai browser dan sistem operasi

Jalankan pengujian

Jalankan pengujian Playwright terhadap browser yang dikelola oleh layanan menggunakan konfigurasi yang Anda buat di atas.

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

Langkah berikutnya

Berkontribusi

Proyek ini menyambut kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda menyetujui Perjanjian Lisensi Kontributor (CLA) yang menyatakan bahwa Anda memiliki hak untuk, dan benar-benar melakukannya, memberi kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi https://cla.opensource.microsoft.com.

Saat Anda mengirimkan permintaan pull, bot CLA akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghias PR dengan tepat (misalnya, pemeriksaan status, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di semua repositori menggunakan CLA kami.

Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi selengkapnya, lihat Tanya Jawab Umum Kode Etik atau hubungi opencode@microsoft.com dengan pertanyaan atau komentar tambahan apa pun.

Merek dagang

Proyek ini mungkin berisi merek dagang atau logo untuk proyek, produk, atau layanan. Penggunaan resmi merek dagang atau logo Microsoft tunduk pada dan harus mengikuti Panduan Merek Dagang & Merek Microsoft. Penggunaan merek dagang atau logo Microsoft dalam versi yang dimodifikasi dari proyek ini tidak boleh menyebabkan kebingungan atau menyiratkan sponsor Microsoft. Setiap penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.

  • Last updated on