作者：京東保險 宋陽

1背景

在車險系統(tǒng)中，對接保司的數(shù)量眾多。每當(dāng)系統(tǒng)有新功能迭代后，基本上各個保司的報價流程都需要進(jìn)行回歸測試。由于保司數(shù)量多，回歸測試的場景也會變得重復(fù)而繁瑣，給測試團(tuán)隊帶來了巨大的工作壓力。

車險投保流程主要通過H5頁面進(jìn)行，核心功能集中在投保、報價、核保等階段。這些功能的UI自動化測試具有很高的可行性和必要性。通過自動化測試，我們可以完全覆蓋這些核心功能的測試場景，有效地降低手動測試的工作量和錯誤率。

在這種情況下，Playwright自動化測試工具因其跨瀏覽器和平臺的支持、簡潔直觀的API設(shè)計以及強(qiáng)大的異步處理能力而成為首選。使用Playwright進(jìn)行UI自動化測試不僅可以提高測試效率和準(zhǔn)確性，還可以幫助測試團(tuán)隊更好地應(yīng)對頻繁的功能迭代和回歸測試的挑戰(zhàn)。

?

?

?

圖1.車險自動化測試需解決問題

2工具

Playwright是一個強(qiáng)大的UI自動化測試工具，能夠錄制并自動生成代碼，支持多種主流瀏覽器，包括Chrome、Firefox和Safari，并且適用于Windows、Linux和macOS操作系統(tǒng)，能夠?qū)崿F(xiàn)跨平臺的自動化測試。同時，Playwright采用Python、C#、Java等編程語言編寫腳本，易于學(xué)習(xí)和使用。它還提供了豐富的API，可以實(shí)現(xiàn)復(fù)雜的用戶交互操作，如鍵盤輸入、鼠標(biāo)操作等，讓自動化測試更加貼近真實(shí)用戶行為。

此外，Playwright具備自動等待功能，能夠智能地處理元素加載，提高測試的穩(wěn)定性和效率?？偟膩碚f，Playwright在UI自動化測試領(lǐng)域具有很高的靈活性和實(shí)用性。

2.1安裝

安裝Playwright只需要一條pip3安裝命令，如下:

    pip3 install playwright

Playwright可以安裝支持的瀏覽器，運(yùn)行不帶參數(shù)的命令將安裝默認(rèn)瀏覽器，默認(rèn)會下載chromium內(nèi)核，firefox以及webkit驅(qū)動。

    playwright install

3實(shí)踐

3.1車險系統(tǒng)

車險系統(tǒng)流程如圖2，其核心功能在于人車信息錄入、線上報價和核保，這些功能的測試點(diǎn)都可以通過PlaywrightUI自動化覆蓋。

?

?

?

圖2.車險系統(tǒng)流程圖

3.2錄制

使用Playwright的錄制功能生成測試用例的代碼。運(yùn)行"npx playwright codegen --device='iPhone 13'"命令啟動playwright，默認(rèn)會開啟兩個窗口，左圖為指定的iPhone 13機(jī)型瀏覽器，右圖為playwright inspector界面，在瀏覽器頁面進(jìn)行系統(tǒng)測試，playwright inspector會自動生成記錄瀏覽器操作的代碼，圖3為打開車險首頁的playwright界面。

?

?

?

圖3.playwright界面

在Target選擇生成的代碼語言，默認(rèn)生成Python，可以換選Java等，如圖4。

?

?

?

圖4.選擇生成語言

選擇好生成的語言后，就可以在瀏覽器中執(zhí)行測試用例了，圖5中playwright inspector會自動生成在瀏覽器測試用例對應(yīng)代碼。

?

?

?

圖5.錄制Case

測試完成之后就可以把playwright inspector中生成的代碼拷貝到Idea，添加日志斷言等，進(jìn)行執(zhí)行和完善。

    import com.microsoft.playwright.*;
    import com.microsoft.playwright.options.*;
    import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;
    import java.util.*;

    public class Example {
      public static void main(String[] args) {
        try (Playwright playwright = Playwright.create()) {
          Browser browser = playwright.webkit().launch(new BrowserType.LaunchOptions()
            .setHeadless(false));
          BrowserContext context = browser.newContext(new Browser.NewContextOptions()
            .setDeviceScaleFactor(3)
            .setHasTouch(true)
            .setIsMobile(true)
            .setUserAgent("Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4 Mobile/15E148 Safari/604.1")
            .setViewportSize(390, 664));
          Page page = context.newPage();
          page.navigate("http://test***");//注入pin
          page.navigate("http://testcar***");//訪問車險測試環(huán)境地址
          page.getByText("更換車輛").click();
          page.navigate("http://testcar***");
          page.getByText("更換車輛").click();
          page.getByText("京AL3UVJ").click();
          page.getByText("更換車輛").click();
          page.locator("p").filter(new Locator.FilterOptions().setHasText("晉L613A4")).click();
          page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("查看報價")).click();
          page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("同意").setExact(true)).click();
          page.getByText("知道了").click();
          page.getByText("查看該方案報價").click();
        }
      }
    }

3.3頁面接口響應(yīng)驗(yàn)證

Playwright的強(qiáng)大在于支持UI錄制的同時，也提供了接口操作的功能。我們可以結(jié)合UI用例執(zhí)行，對重要接口參數(shù)進(jìn)行獲取和校驗(yàn)，也可以作為UI用例的參數(shù)使用。接口校驗(yàn)主要用到兩個方法：expect_request和expect_response。expect_request方法會等待匹配的請求并返回，expect_response方法會返回匹配的響應(yīng)。在車險的一個使用場景為例：代碼在執(zhí)行點(diǎn)擊更換車輛文本之后，會監(jiān)聽queryCarHomePage接口的返回，獲取當(dāng)前用戶所有的車。

     page.getByText("更換車輛").click();

     // 監(jiān)聽響應(yīng)
     page.onResponse(response -> {
         if (response.url().contains("queryCarHomePage")) {
             String result = new String(response.body(), StandardCharsets.UTF_8);
             JSONObject res = new JSONObject(result);
         
             ObjectMapper mapper = new ObjectMapper();
             JsonNode rootNode = null;
             try {
                 rootNode = mapper.readTree(result);
             } catch (JsonProcessingException e) {
                 throw new RuntimeException(e);
             }

             JsonNode carInfoListNode = rootNode.get("resultData").get("carInfoListDto");
             for (JsonNode carInfo : carInfoListNode) {
                 JsonNode licenseNoNode = carInfo.get("licenseNo");
                 if (licenseNoNode == null) {
                     throw new IllegalArgumentException("licenseNo field not found in carInfoListDto for car " + carInfo);
                 }
                 String licenseNo = licenseNoNode.asText();
                 System.out.println(licenseNo);
             }
         }
         });

3.4基于Playwright的UI自動化測試系統(tǒng)

可見Playwright的自動錄制功能能夠大幅降低生成測試用例的復(fù)雜度，UI的自動執(zhí)行也能夠節(jié)省大量回歸測試的時間。當(dāng)然我們不僅僅滿足于case的錄制和本地手動執(zhí)行，而更希望能夠在生成case之后，可以定期執(zhí)行、自動執(zhí)行錄制的case，并生成能夠直觀反映case執(zhí)行結(jié)果的報告，這樣就可以實(shí)現(xiàn)從用例錄制、收集、定期執(zhí)行到測試效果反饋的完整自動化測試鏈路，實(shí)現(xiàn)系統(tǒng)的測試和監(jiān)控的同時，顯著提升測試的效率，極大節(jié)省時間人力成本。所以未來我們預(yù)期實(shí)現(xiàn)的自動化系統(tǒng)結(jié)構(gòu)如圖6所示，本地錄制case并上傳到數(shù)據(jù)庫，Playwright定時任務(wù)執(zhí)行case并生成用例執(zhí)行報告。

?

?

圖6.基于playwright的UI自動化測試系統(tǒng)流程圖

3.5測試Demo

以下擷取Case為Playwright錄制生成代碼和接口相關(guān)擴(kuò)展方法相結(jié)合，實(shí)現(xiàn)車險首頁切換車輛后報價，并通過獲取該用戶pin下車列表的Demo實(shí)例。

    public class Example {
        public static void main(String[] args) {
            try (Playwright playwright = Playwright.create()) {
                Browser browser = playwright.webkit().launch(new BrowserType.LaunchOptions()
                        .setHeadless(false));
                BrowserContext context = browser.newContext(new Browser.NewContextOptions()
                        .setDeviceScaleFactor(3)
                        .setHasTouch(true)
                        .setIsMobile(true)
                        .setUserAgent("Mozilla/5.0 (iPhone; CPU iPhone OS 15_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4 Mobile/15E148 Safari/604.1")
                        .setViewportSize(390, 664));
                Page page = context.newPage();
                page.navigate("http://test***");
                page.navigate("http://testcar***");

                // 監(jiān)聽響應(yīng)
                page.onResponse(response -> {
                    if (response.url().contains("queryCarHomePage")) {
                        String result = new String(response.body(), StandardCharsets.UTF_8);
                        JSONObject res = new JSONObject(result);
                        System.out.println(result);

                        ObjectMapper mapper = new ObjectMapper();
                        JsonNode rootNode = null;
                        try {
                            rootNode = mapper.readTree(result);
                        } catch (JsonProcessingException e) {
                            throw new RuntimeException(e);
                        }

                        JsonNode carInfoListNode = rootNode.get("resultData").get("carInfoListDto");
                        for (JsonNode carInfo : carInfoListNode) {
                            JsonNode licenseNoNode = carInfo.get("licenseNo");
                            if (licenseNoNode == null) {
                                throw new IllegalArgumentException("licenseNo field not found in carInfoListDto for car " + carInfo);
                            }
                            String licenseNo = licenseNoNode.asText();
                            System.out.println(licenseNo);
                        }
                    }
                });

                page.getByText("更換車輛").click();
                page.getByText("晉L613A4").click();
                page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("查看報價")).click();
                page.getByText("查看該方案報價").click();

    }

執(zhí)行效果如圖7，可以靈活在此基礎(chǔ)上擴(kuò)展其他Case。

?

4總結(jié)與展望

利用Playwright，我們可以輕松地編寫可靠、快速和可維護(hù)的自動化測試腳本。這些腳本可以模擬真實(shí)用戶的交互行為，覆蓋各種可能的測試場景，從而確保車險的UI在不同環(huán)境和配置下的穩(wěn)定性和正確性。通過playwright實(shí)現(xiàn)用例自動生成，定時執(zhí)行并產(chǎn)出報告的車險UI自動化測試系統(tǒng)，能夠幫助我們顯著提高測試效率，節(jié)省大量的測試時間。展望未來，我們期待將車險UI自動化測試技術(shù)繼續(xù)發(fā)展和完善，為目前的測試工作提升效率，未來帶來更多的創(chuàng)新和改進(jìn)。

審核編輯 黃宇

?