Playwright快速上手指南(入門教程)

Posted on by

Playwright是由微軟公司2020年初發佈的新一代自動化測試工具，相較於目前最常用的Selenium，它僅用一個API即可自動執行Chromium、Firefox、WebKit等主流瀏覽器自動化操作。作為針對 Python 語言純自動化的工具，在回歸測試中可更快的實現自動化。

1. 為什麼選擇Playwright

1.1 Playwright的優勢

（1） Selenium需要通過WebDriver操作瀏覽器；Playwright通過開發者工具與瀏覽器交互，安裝簡潔，不需要安裝各種Driver。

（2） Playwright幾乎支持所有語言，且不依賴於各種Driver，通過調用內置瀏覽器所以啟動速度更快。

（3） Selenium基於HTTP協議（單向通訊），Playwright基於Websocket（雙向通訊）可自動獲取瀏覽器實際情況。

（4） Playwright為自動等待。

  • 等待元素出現（定位元素時，自動等待30s，等待時間可以自定義，單位毫秒）
  • 等待事件發生

1.2 已知局限性

（1） Playwright不支持舊版Microsoft Edge或IE11。支持新的Microsoft Edge（在Chromium上）；所以對瀏覽器版本有硬性要求的項目不適用。

（2） 需要SSL證書進行訪問的網站可能無法錄制，該過程需要單獨定位編寫。

（3） 移動端測試是通過桌面瀏覽器來模擬移動設備（相當於自帶模擬器），無法控制真機。

2. Playwright使用

2.1 安裝

（1）安裝Playwright依賴庫（Playwright支持Async\Await語法，故需要Python3.7+）

pip install playwright

（2）安裝Chromium、Firefox、WebKit等瀏覽器的驅動文件（內置瀏覽器）

python -m playwright install

2.2 自動錄制

（1）命令行鍵入 –help 看到所有可後接選項

python -m playwright codegen --help

（2）從起始頁為xingzheai.cn開始錄制

python -m playwright codegen https://xingzheai.cn/

（3）打開xingzheai.cn，用Chromium驅動，將結果保存為my.py的python文件

python -m playwright codegen --target python -o 'my.py' -b chromium https://xingzheai.cn/

 -target：規定生成腳本的語言，有JS和Python兩種，默認為Python
-b：指定瀏覽器驅動
-o：將錄制的腳本保存到一個文件

2.3 定制化編寫

（1）元素定位

  • 選擇單個元素：querySelector(engine=body)
  • 選擇多個元素：querySelectorAll(engine=body)
  • 選擇單個元素，並且自動等待：waitForSelector(engine=body)

By的8種定位方式，實際為4種

  • id、name、tag name、class name（java和pythona將該4種都歸為CSS）
  • xpath、link text、partial link text、css selector

W3C標準規定的webDriver協議為5種定位方式

  • CSS、Link text、Partial link text、Tag name、XPath

Playwright將選擇器匯總為3種

  • CSS、XPATH（支持邏輯表達式和函數）、TEXT

（2）選擇器規則

  • CSS： ID選擇器、類選擇器、元素選擇器、屬性選擇器、通配選擇器、層次選擇器。
  • XPath： XML路徑語言，通過“路徑標識符”，導航XML文檔的，在類XML種（HTML）也可以使用。
  • Text： 結構化內容（html，xml，json）使用模糊匹配（忽略大小寫，忽略前後空格，搜索子字符串）及精確匹配、非結構化內容使用正則匹配。

（3）元素常用操作

  • 下拉選擇框：selectOpion、value、labei、index
  • 文件上傳：setInputFiles、單個文件、多個文件、拖放上傳
  • 鼠標點擊：click、dbclick
  • 鼠標拖動：down、up
  • 鼠標移動：move
  • 觸摸屏幕：tag
  • 鍵盤按鍵：press
  • 截屏、錄屏：screenshot、recordVideo

2.4 網絡攔截（Mock接口），示例如下：

page = context.newPage()
def Whether_intercept() -> bool:
    return True  #進行攔截
# return False #不進行攔截

def handler(route:Route):
    print(route.request.url)
    #正常訪問
    # route.continue_()
    #拒絕訪問
    # route.abort("網絡攔截")
    # 重定向到非目標地址
    route.fulfill(
        status=302,
        headers={
            'Location' : "https://xingzheai.cn/"
        }
    )
page.route(Whether_intercept,handler)

2.5 同步執行，示例如下： 

#依次打開三個瀏覽器，前往行者官網，截圖後退出。
from playwright import sync_playwright with sync_playwright() as p:
    for browser_type in [p.chromium, p.firefox, p.webkit]:
         # 指定為有頭模式，Ture為無頭模式
        browser = browser_type.launch(headless=False)
        page = browser.newPage()
        page.goto('https://xingzheai.cn/')
        # 等待頁面加載完全後截圖
        page.waitForSelector("text=智能內容審核")
        page.screenshot(path=f'example-{browser_type.name}.png')
        browser.close()

2.6 異步執行，示例如下：

#同時進行三個瀏覽器操作
import asyncio
from playwright import async_playwright
async def main():
 async with async_playwright() as p:
     for browser_type in [p.chromium, p.firefox, p.webkit]:
          browser = await browser_type.launch()
         page = await browser.newPage()
         await page.goto('https://xingzheai.cn/')
          await page.waitForSelector("text=智能內容審核")
          await page.screenshot(path=f'example-{browser_type.name}.png')
          await browser.close()
         asyncio.get_event_loop().run_until_complete(main())

2.7 Pytest結合，示例如下：

安裝：pip install pytest-playwright

def test_playwright(page):
    page.goto("https://xingzheai.cn/")
    with page.expect_popup() as popup_info:         
 page.click('text="智能內容審核"')         
    assert "智能內容審核" == element.textContent()

2.8 移動端操作，示例如下：

目前支持模擬機型較少， 參照：仿真設備列表

from time import sleep
from playwright import sync_playwright  
with sync_playwright() as p:
    GalaxyS5 = p.devices['Galaxy S5']
    browser = p.chromium.launch(headless=False)
    context = browser.newContext(**GalaxyS5)
    page = context.newPage()
    page.goto('https://xingzheai.cn/')
    page.click('text="智能內容審核"')
    # 截圖
    # page.screenshot(path='colosseum-GalaxyS5.png')
    sleep(10)
    browser.close()

3. 總結

Playwright作為新一代自動化測試工具，相較於Selenium不論是易用性，還是實用性都得到瞭全方位的提升。做到瞭簡約而不簡單，相信使用該工具可以幫助我們提升做自動化的工作效率。

到此這篇關於Playwright快速上手指南(入門教程)的文章就介紹到這瞭,更多相關Playwright入門內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：