微軟開源 Python 自動化神器 Playwright

宗恩發表於2020-12-28
微軟Python

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

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

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

1. Playwright介紹

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

Playwright提供的自動化技術是綠色的、功能強大、可靠且快速，支援Linux、Mac以及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：規定生成指令碼的語言，有JS和Python兩種，預設為Python
  • -b：指定瀏覽器驅動

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

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

相關文章