微軟開源 Python 自動化神器 Playwright

宗恩發表於2020-12-28

最近,微軟開源了一個專案叫「playwright-python」,這個專案是針對 Python 語言的純自動化工具,它可以通過單個API自動執行Chromium,Firefox和WebKit瀏覽器,連程式碼都不用寫,就能實現自動化功能。

相比測試工具 selenium 來說,playwright-python 簡直是小白們的神器。

Playwright真的適用於Python嗎?答案是肯定的,微軟對於適用於Python的Playwright已準備就緒。可能會發生API重大更改。 但大概率是這種情況不會發生,微軟還表示僅在他們知道它可以改善您使用新庫的體驗時,才會可能這樣做。不過微軟也提醒尚不支援特定於供應商的API的某些極端情況,例如收集Chromium跟蹤,覆蓋率報告等。

1. Playwright介紹

Playwright是一個強大的Python庫,僅用一個API即可自動執行ChromiumFirefoxWebKit等主流瀏覽器自動化操作,並同時支援以無頭模式、有頭模式執行。

Playwright提供的自動化技術是綠色的、功能強大、可靠且快速,支援LinuxMac以及Windows作業系統。

2. Playwright使用

安裝

Playwright的安裝非常簡單,兩步走。

安裝playwright庫
pip install playwright
安裝瀏覽器驅動檔案(安裝過程稍微有點慢)
python -m playwright install
複製程式碼

上面兩個pip操作分別安裝:

  • 安裝Playwright依賴庫,需要Python3.7+
  • 安裝Chromium、Firefox、WebKit等瀏覽器的驅動檔案

錄製

使用Playwright無需寫一行程式碼,我們只需手動操作瀏覽器,它會錄製我們的操作,然後自動生成程式碼指令碼。

下面就是錄製的命令codegen,僅僅一行。

命令列鍵入 --help 可看到所有選項
python -m playwright codegen
複製程式碼

codegen的用法可以使用--help檢視,如果簡單使用就是直接在命令後面加上url連結,如果有其他需要可以新增options

python -m playwright codegen --help
Usage: index codegen [options] [url]


open page and generate code for user actions


Options:
  -o, --output <file name>  saves the generated script to a file
  --target <language>       language to use, one of javascript, python, python-async, csharp (default: "python")
  -h, --help                display help for command


Examples:


  $ codegen
  $ codegen --target=python
  $ -b webkit codegen https://example.com

複製程式碼

options含義:

  • -o:將錄製的指令碼儲存到一個檔案
  • --target:規定生成指令碼的語言,有JSPython兩種,預設為Python
  • -b:指定瀏覽器驅動

比如,我要在baidu.com搜尋,用chromium驅動,將結果儲存為my.pypython檔案。

python -m playwright codegen --target python -o 'my.py' -b chromium https://www.baidu.com
複製程式碼

命令列輸入後會自動開啟瀏覽器,然後可以看見在瀏覽器上的一舉一動都會被自動翻譯成程式碼,如下所示。

結束後自動關閉瀏覽器,儲存生成的自動化指令碼到py檔案。

from playwright import sync_playwright


def run(playwright):
browser = playwright.chromium.launch(headless=False)
context = browser.newContext()

# Open new page
page = context.newPage()


page.goto("https://www.baidu.com/")


page.click("input[name="wd"]")


page.fill("input[name="wd"]", "jingdong")


page.click("text="京東"")

# Click //a[normalize-space(.)='京東JD.COM官網 多快好省 只為品質生活']
with page.expect_navigation():
    with page.expect_popup() as popup_info:
        page.click("//a[normalize-space(.)='京東JD.COM官網 多快好省 只為品質生活']")
    page1 = popup_info.value
# ---------------------
context.close()
browser.close()
with sync_playwright() as playwright:
run(playwright

此外,playwright還提供了同步和非同步的API介面,文件如下。

連結:https://microsoft.github.io/playwright-python/index.html

同步

下面示例程式碼:依次開啟三個瀏覽器,前往baidu搜尋,截圖後退出。

from playwright import sync_playwright
with sync_playwright() as p:
for browser_type in [p.chromium, p.firefox, p.webkit]:
    browser = browser_type.launch()
    page = browser.newPage()
    page.goto('https://baidu.com/')
    page.screenshot(path=f'example-{browser_type.name}.png')
    browser.close()
    複製程式碼

非同步

非同步操作可結合asyncio同時進行三個瀏覽器操作。

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('http://baidu.com/')
        await page.screenshot(path=f'example-{browser_type.name}.png')
        await browser.close()
        asyncio.get_event_loop().run_until_complete(main())
       複製程式碼

移動端

更厲害的是,playwright還可支援移動端的瀏覽器模擬。 下面是官方文件提供的一段程式碼,模擬在給定地理位置上手機iphone 11 pro上的Safari瀏覽器,首先導航到maps.google.com,然後執行定位並截圖。

from playwright import sync_playwright
with sync_playwright() as p:
iphone_11 = p.devices['iPhone 11 Pro']
browser = p.webkit.launch(headless=False)
context = browser.newContext(
    **iphone_11,
    locale='en-US',
    geolocation={ 'longitude': 12.492507, 'latitude': 41.889938 },
    permissions=['geolocation']
)
page = context.newPage()
page.goto('https://maps.google.com')
page.click('text="Your location"')
page.screenshot(path='colosseum-iphone.png')
browser.close()
複製程式碼

另外,還可以配合pytest外掛一起使用,感興趣可以自己試一下。

3. 總結

playwright相比已有的自動化測試工具有很多優勢,比如:

  • 跨瀏覽器,支援Chromium、Firefox、WebKit
  • 跨作業系統,支援Linux、Mac、Windows
  • 可提供錄製生成程式碼功能,解放雙手
  • 可用於移動端
  • 在JavaScript,TypeScript,Python,C#和Java均可使用Playwright API。

現在playwright 已經更新到了 1.7.0 版本,目前存在的缺點就是生態和文件還不是非常完備,比如沒有API中文文件、沒有較好的教程和示例供學習。不過相信,隨著知道的人越來越多,未來會越來越好。

GitHub連結:https://github.com/microsoft/playwright-python
傳送門:https://playwright.dev/
開源組織:Microsoft

image.png

相關文章