Microsoft劇作家測試預覽

Microsoft Playwright Testing 是一項完全受控的 Azure 服務，其使用雲端可讓您同時在不同的操作系統瀏覽器組合上執行具有更高平行處理的 Playwright 測試。 這表示使用更廣泛的案例涵蓋範圍更快速的測試執行，這有助於加快功能傳遞速度，而不會犧牲品質。 此服務也可讓您將測試結果和相關成品發佈至服務，並在服務入口網站中檢視它們，以便更快速地進行疑難解答。 透過Microsoft Playwright Testing 服務，您可以更快速且更自信地發行功能。

準備好開始嗎？ ，請跳到我們的 快速入門指南！

有用的連結

• 快速入門：大規模執行端對端測試
• 快速入門：在不同瀏覽器和操作系統之間設定連續端對端測試，
• 探索功能與優點
• 檔
• 定價
• 共用意見反應

開始使用

請遵循下列步驟，使用服務執行您現有的 Playwright 測試套件。

先決條件

• 具有作用中訂用帳戶的 Azure 帳戶。 如果您沒有 Azure 訂用帳戶，請在開始之前 建立免費帳戶。
• 您的 Azure 帳戶必須獲指派 擁有者、參與者，或傳統系統管理員角色之一。
• Azure CLI 必須安裝在您執行 Playwright 測試的電腦中。

建立工作區

1. 使用您的 Azure 帳戶登入 Playwright 入口網站。

2. 建立工作區。

   

   田	描述
   工作區名稱	用來識別工作區的唯一名稱。 名稱不能包含特殊字元或空格符。
   Azure 訂用帳戶	選取您要在其中建立工作區的 Azure 訂用帳戶。
   區域	這是測試回合數據會儲存在工作區的位置。

如果您沒有看到此畫面，請選取現有的工作區，然後移至下一節。

安裝 Microsoft Playwright Testing 套件

1. 執行此命令以安裝服務套件

   npm init @azure/microsoft-playwright-testing
   

安裝服務套件將會建立名為 playwright.service.config.ts 的服務組態檔

服務組態會提供下列專案：

• 將劇作家直接和驗證至Microsoft劇作家測試服務。
• 將Microsoft Playwright Testing 報告新增至您的設定。
• 視需要覆寫服務作業的逾時。

請確定您的專案使用 @playwright/test 1.47 版或更新版本。

取得區域端點

1. 在 Playwright 入口網站中，於 [在設定中新增區域端點] 底下複製 命令，。

   

   端點 URL 會對應至工作區區域。 您可能會在 Playwright 入口網站中看到不同的端點 URL，視您在建立工作區時選取的區域而定。

設定環境

請確定您在上一個步驟中取得的 PLAYWRIGHT_SERVICE_URL 可在您的環境中使用。

建議您使用 dotenv 模組來管理您的環境。 使用 dotenv，您將使用 .env 檔案來定義環境變數。

別忘了將 .env 檔案新增至 .gitignore 檔案，以免洩漏您的秘密。

npm i --save-dev dotenv

.env 檔案

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

設定驗證

若要在 Microsoft Playwright Testing 工作區中執行 Playwright 測試，您需要向服務執行測試的 Playwright 用戶端進行驗證。 這可能是您的本機開發電腦或 CI 計算機。

此服務提供兩種驗證方法：Microsoft Entra 標識符和存取令牌。

Microsoft Entra ID 會使用您的 Azure 認證，要求登入您的 Azure 帳戶以安全存取。 或者，您可以從 Playwright 工作區產生存取令牌，並在您的設定中使用。

使用 Microsoft Entra 識別碼設定驗證

Microsoft Entra ID 是服務的預設和建議驗證。 從本機開發計算機，您可以使用 Azure CLI 來登入

az login

NOTE：如果您是多個Microsoft Entra 租使用者的一部分，請務必登入工作區所屬的租使用者。 您可以從 Azure 入口網站取得租使用者識別碼，請參閱 尋找您的 Microsoft Entra Tenant。 取得標識符之後，請使用 命令登入 az login --tenant <TenantID>

使用存取令牌設定驗證

您可以從 Playwright Testing 工作區產生存取令牌，並在設定中使用。 不過，我們強烈建議Microsoft Entra ID 進行驗證，因為其安全性增強。 存取令牌雖然方便，但功能類似長期密碼，而且更容易遭到入侵。

1. 若要使用存取令牌型驗證，啟用存取令牌型驗證

2. 使用存取令牌設定驗證

強烈建議使用 Microsoft Entra ID 向服務進行驗證。 如果您使用存取令牌，請參閱 如何管理存取令牌

注意： 若要在 CI 管線中使用 Microsoft Playwright Testing，您需要從管線設定服務驗證，請參閱 跨不同瀏覽器和操作系統設定連續端對端測試

執行測試

使用您在上面建立的設定，對服務所管理的瀏覽器執行 Playwright 測試。

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

後續步驟

• 在 CI/CD 管線中執行測試。

• 瞭解如何 管理已建立工作區 存取權。

• 試驗不同的背景工作角色數目，以 判斷測試套件的最佳組態。

貢獻

此項目歡迎參與和建議。 大部分的捐款都要求您同意「參與者許可協定」（CLA），宣告您有權，而且實際上確實會授與我們使用您貢獻的許可權。 如需詳細資訊，請瀏覽 https://cla.opensource.microsoft.com。

當您提交提取要求時，CLA Bot 會自動判斷是否需要提供 CLA 並適當裝飾 PR（例如狀態檢查、批注）。 只要遵循 Bot 所提供的指示即可。 您只需要使用我們的 CLA 在所有存放庫上執行此動作一次。

此專案已採用 Microsoft開放原始碼。 如需詳細資訊，請參閱 《行為規範》常見問題 或連絡 opencode@microsoft.com，以取得任何其他問題或意見。

商標

此專案可能包含專案、產品或服務的商標或標誌。 授權使用Microsoft商標或標誌須遵循 Microsoft商標 & 商標指導方針。 在此專案的修改版本中使用Microsoft商標或標誌不得造成混淆或暗示Microsoft贊助。 任何使用第三方商標或標誌，都受限於這些第三方的原則。