Gunakan opsi yang tersedia dalam paket layanan dengan pratinjau Pengujian Microsoft Playwright

Penting

Microsoft Playwright Testing akan dihentikan pada 8 Maret 2026. Untuk terus menjalankan pengujian Playwright Anda, buat Ruang Kerja Playwright baru di Azure App Testing, sekarang tersedia secara umum. Pelajari cara bermigrasi.

Artikel ini memperlihatkan kepada Anda cara menggunakan opsi yang tersedia dalam playwright.service.config.ts file yang dihasilkan untuk Anda. Jika Anda tidak memiliki file ini dalam kode Anda, ikuti Mulai Cepat: Jalankan pengujian end-to-end dalam skala besar dengan Pratinjau Pengujian Microsoft Playwright

Artikel ini memperlihatkan kepada Anda cara menggunakan opsi yang .runsettings tersedia dalam file. Jika Anda tidak memiliki file ini dalam kode Anda, ikuti Mulai Cepat: Jalankan pengujian end-to-end dalam skala besar dengan Pratinjau Pengujian Microsoft Playwright

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.

Prasyarat

Ikuti panduan Mulai Cepat dan siapkan proyek untuk dijalankan dengan layanan Microsoft Playwright Testing. Lihat, Mulai Cepat: Menjalankan pengujian end-to-end dalam skala besar dengan Pratinjau Pengujian Microsoft Playwright

Berikut adalah versi playwright.service.config.ts file dengan semua opsi yang tersedia:

import { getServiceConfig, ServiceOS } from "@azure/microsoft-playwright-testing";
import { defineConfig } from "@playwright/test";
import { AzureCliCredential } from "@azure/identity";
import config from "./playwright.config";

export default defineConfig(
  config,
  getServiceConfig(config, {
    serviceAuthType:'ACCESS_TOKEN' // Use this option when you want to authenticate using access tokens. This mode of auth should be enabled for the workspace.
    os: ServiceOS.WINDOWS, // Select the operating system where you want to run tests.
    runId: new Date().toISOString(), // Set a unique ID for every test run to distinguish them in the service portal.
    credential: new AzureCliCredential(), // Select the authentication method you want to use with Entra.
    useCloudHostedBrowsers: true, // Select if you want to use cloud-hosted browsers to run your Playwright tests.
    exposeNetwork: '<loopback>', // Use this option to connect to local resources from your Playwright test code without having to configure additional firewall settings.
    timeout: 30000 // Set the timeout for your tests.
  }),
  {
    reporter: [
      ["list"],
      [
        "@azure/microsoft-playwright-testing/reporter",
        {
          enableGitHubSummary: true, // Enable/disable GitHub summary in GitHub Actions workflow.
        },
      ],
    ],
  },
);

Pengaturan dalam `playwright.service.config.ts` file

serviceAuthType:
- Deskripsi: Pengaturan ini memungkinkan Anda memilih metode autentikasi yang ingin Anda gunakan untuk uji coba.
- Opsi yang Tersedia:
  - ACCESS_TOKEN untuk menggunakan token akses. Anda perlu mengaktifkan autentikasi menggunakan token akses jika Anda ingin menggunakan opsi ini, lihat mengelola autentikasi.
  - ENTRA_ID untuk menggunakan ID Microsoft Entra untuk autentikasi. Ini adalah mode default.
- Nilai Default: ENTRA_ID
- Contoh:
```
serviceAuthType:'ENTRA_ID'
```
os:
- Deskripsi: Pengaturan ini memungkinkan Anda memilih sistem operasi tempat browser yang menjalankan pengujian Playwright dihosting.
- Opsi yang Tersedia:
  - ServiceOS.WINDOWS untuk OS Windows.
  - ServiceOS.LINUX untuk OS Linux.
- Nilai Default: ServiceOS.LINUX
- Contoh:
```
os: ServiceOS.WINDOWS
```
runId:
- Deskripsi: Pengaturan ini memungkinkan Anda mengatur ID unik untuk setiap pengujian yang dijalankan untuk membedakannya di portal layanan. Menggunakan runId yang sama untuk beberapa eksekusi pengujian menghasilkan kesalahan. Untuk sharding, simpan ini sama di semua pecahan.
- Contoh:
```
runId: new Date().toISOString()
```
credential:
- Deskripsi: Pengaturan ini memungkinkan Anda memilih metode autentikasi yang ingin Anda gunakan dengan ID Microsoft Entra.
- Contoh:
```
credential: new AzureCliCredential()
```
useCloudHostedBrowsers
- Deskripsi: Pengaturan ini memungkinkan Anda memilih apakah akan menggunakan browser yang dihosting cloud atau browser di komputer klien Anda untuk menjalankan pengujian Playwright Anda. Jika Anda menonaktifkan opsi ini, pengujian Anda berjalan di browser komputer klien Anda alih-alih browser yang dihosting cloud, dan Anda tidak dikenakan biaya apa pun.
- Nilai Default: true
- Contoh:
```
useCloudHostedBrowsers: true
```
exposeNetwork
- Deskripsi: Pengaturan ini memungkinkan Anda untuk terhubung ke sumber daya lokal dari kode uji Playwright Anda tanpa harus mengonfigurasi pengaturan firewall lain. Untuk mempelajari lebih lanjut, lihat cara menguji aplikasi lokal
- Contoh:
```
exposeNetwork: '<loopback>'
```
timeout
- Deskripsi: Pengaturan ini memungkinkan Anda mengatur batas waktu untuk pengujian Anda yang terhubung ke browser yang dihosting cloud.
- Contoh:
```
timeout: 30000,
```
reporter
- Deskripsi: File playwright.service.config.ts memperluas file konfigurasi playwright dari penyiapan Anda. Opsi ini mengambil alih wartawan yang ada dan mengatur wartawan Pengujian Microsoft Playwright. Anda dapat menambahkan atau mengubah daftar ini untuk menyertakan wartawan yang ingin Anda gunakan. Anda ditagih untuk pelaporan Pengujian Microsoft Playwright jika Anda menambahkan @azure/microsoft-playwright-testing/reporter.
- Nilai Default: ["@azure/microsoft-playwright-testing/reporter"]
- Contoh:
```
reporter: [
["list"],
["@azure/microsoft-playwright-testing/reporter"],
```
enableGitHubSummary:
- Deskripsi: Pengaturan ini memungkinkan Anda mengonfigurasi reporter layanan Pengujian Microsoft Playwright. Anda dapat memilih apakah akan menyertakan ringkasan uji coba dalam ringkasan GitHub saat berjalan di GitHub Actions.
- Nilai Default: true
- Contoh:
```
  reporter: [
    ["list"],
    [
      "@azure/microsoft-playwright-testing/reporter",
      {
        enableGitHubSummary: true,
      },
    ],
  ]
```

Berikut adalah versi .runsettings file dengan semua opsi yang tersedia:

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
    <TestRunParameters>
        <!-- Use this option when you want to authenticate using access tokens. This mode of auth should be enabled for the workspace. -->
         <Parameter name="ServiceAuthType" value="EntraId" />
        <!-- Select the operating system where you want to run tests. -->
        <Parameter name="Os" value="linux" />
        <!-- Set a unique ID for every test run to distinguish them in the service portal.-->
        <Parameter name="RunId" value="sample-run-id1" />
        <!--Select if you want to use cloud-hosted browsers to run your Playwright tests.-->
        <Parameter name="UseCloudHostedBrowsers" value="true" />
        <!--Use this option to connect to local resources from your Playwright test code without having to configure additional firewall-->
        <Parameter name="ExposeNetwork" value="loopback" />
        <!--Select the authentication method you want to use with Entra-->
        <Parameter name="AzureTokenCredentialType" value="DefaultAzureCredential" />
        <!--Enable/disable GitHub summary in GitHub Actions workflow.-->
        <Parameter name="EnableGitHubSummary" value="false" />
    </TestRunParameters>
  <!-- NUnit adapter -->  
  <NUnit>
    <!-- Adjust parallel workers, parallel worker would also be bound by number of unit test files -->
    <NumberOfTestWorkers>10</NumberOfTestWorkers>
  </NUnit>
  <!-- General run configuration -->
  <RunConfiguration>
    <EnvironmentVariables>
      <!-- For debugging selectors, it's recommend to set the following environment variable -->
      <DEBUG>pw:api</DEBUG>
    </EnvironmentVariables>
  </RunConfiguration>
  <!-- Playwright -->  
  <Playwright>
    <BrowserName>chromium</BrowserName>
    <!--Set the timeout for your tests.-->
    <ExpectTimeout>5000</ExpectTimeout>
    <LaunchOptions>
      <Headless>false</Headless>
      <!--Channel>msedge</Channel-->
    </LaunchOptions>
  </Playwright>
    <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>

Opsi konfigurasi dalam `.runsettings` file

serviceAuthType:
- Deskripsi: Pengaturan ini memungkinkan Anda memilih metode autentikasi yang ingin Anda gunakan untuk uji coba.
- Opsi yang Tersedia:
  - AccessToken untuk menggunakan token akses. Anda perlu mengaktifkan autentikasi menggunakan token akses jika Anda ingin menggunakan opsi ini, lihat mengelola autentikasi.
  - EntraId untuk menggunakan ID Microsoft Entra untuk autentikasi. Ini adalah mode default.
- Nilai Default: EntraId
- Contoh:
```
<Parameter name="ServiceAuthType" value="EntraId" />
```
os:
- Deskripsi: Pengaturan ini memungkinkan Anda memilih sistem operasi tempat browser yang menjalankan pengujian Playwright dihosting.
- Opsi yang Tersedia:
  - "windows" untuk OS Windows.
  - "linux" untuk OS Linux.
- Nilai Default: "linux"
- Contoh:
```
<Parameter name="Os" value="linux" />
```
RunId:
- Deskripsi: Pengaturan ini memungkinkan Anda mengatur ID unik untuk setiap pengujian yang dijalankan untuk membedakannya di portal layanan. Menggunakan runId yang sama untuk beberapa eksekusi pengujian menghasilkan kesalahan. Jika Anda tidak mengaturnya, paket layanan akan menghasilkan ID unik setiap kali Anda memicu uji coba. Untuk sharding, simpan ini sama di semua pecahan.
- Contoh:
```
<Parameter name="RunId" value="sample-run-id1" />
```
AzureTokenCredentialType:
- Deskripsi: Pengaturan ini memungkinkan Anda memilih metode autentikasi yang ingin Anda gunakan dengan ID Microsoft Entra.
- Contoh:
```
<Parameter name="AzureTokenCredentialType" value="DefaultAzureCredential" />
```
UseCloudHostedBrowsers
- Deskripsi: Pengaturan ini memungkinkan Anda memilih apakah akan menggunakan browser yang dihosting cloud atau browser di komputer klien Anda untuk menjalankan pengujian Playwright Anda. Jika Anda menonaktifkan opsi ini, pengujian Anda berjalan di browser komputer klien Anda alih-alih browser yang dihosting cloud, dan Anda tidak dikenakan biaya apa pun.
- Nilai Default: true
- Contoh:
```
<Parameter name="UseCloudHostedBrowsers" value="true" />
```
ExposeNetwork
- Deskripsi: Pengaturan ini memungkinkan Anda untuk terhubung ke sumber daya lokal dari kode uji Playwright Anda tanpa harus mengonfigurasi pengaturan firewall lain. Untuk mempelajari lebih lanjut, lihat cara menguji aplikasi lokal
- Contoh:
```
<Parameter name="ExposeNetwork" value="loopback" />
```
reporter
- Deskripsi: Anda dapat menerbitkan hasil pengujian dan artefak ke layanan menggunakan microsoft-playwright-testing pencatat. Anda dapat menonaktifkan pelaporan dengan menghapus ini dari Anda .runsettings atau dengan mengaturnya ke false.
- Nilai Default: true
- Contoh:
```
<Logger friendlyName="microsoft-playwright-testing" enabled="true" />
```
EnableGitHubSummary:
- Deskripsi: Pengaturan ini memungkinkan Anda mengonfigurasi reporter layanan Pengujian Microsoft Playwright. Anda dapat memilih apakah akan menyertakan ringkasan uji coba dalam ringkasan GitHub saat berjalan di GitHub Actions.
- Nilai Default: true
- Contoh:
```
  <Parameter name="EnableGitHubSummary" value="false" />
```

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-08-15

Bagikan melalui

Gunakan opsi yang tersedia dalam paket layanan dengan pratinjau Pengujian Microsoft Playwright

Prasyarat

Pengaturan dalam playwright.service.config.ts file

Opsi konfigurasi dalam .runsettings file

Saran dan Komentar

Sumber Daya Tambahan:

Pengaturan dalam `playwright.service.config.ts` file

Opsi konfigurasi dalam `.runsettings` file