Python Playwright的使用详解

目录

• 实战场景
• 实战操作

实战场景

本篇博客为大家介绍一款新的自动化测试工具，效果类似 selenium，但是这个模块年轻。

模块名称为 playwright-python，微软开源的，是针对 Python 语言的纯自动化工具，可以通过 API 调用浏览器，github 地址在本文末尾。

接下来将通过 3 篇博客为大家详细介绍该 playwright-python，彻彻底底了解它。

正式开始前依旧是模块安装：

pip install playwright

该模块安装非常快，但完整体验还需要安装浏览器相关驱动，这个有点大，命令如下：

python -m playwright install

安装时注意使用国内源！

等待过程中，可以查阅输出日志，核对安装了哪些模块：

• Downloading FFMPEG：FFMPEG；
• Downloading Firefox 104.0：火狐浏览器驱动；
• Downloading Chromium ：谷歌浏览器驱动；
• Downloading Webkit 16.0 ：Webkit 浏览器驱动。

实战操作

第一次实战操作，先从不写代码开始，通过下述命令启动浏览器，然后【录制】我们的操作过程。

python -m playwright codegen

运行代码之后，弹出默认浏览器和一个代码录制展示框，具体如下所示：

下面就可以在左侧的浏览器窗口中进行操作，然后观察右侧自动生成的代码段。

在地址栏输入 baidu.com 跳转到百度首页，然后输入 航天员，点击搜索按钮，生成的代码如下所示。

将生成的代码复制到开发工具中，直接运行就可以得到刚刚相同的操作。

from playwright.sync_api import Playwright, sync_playwright, expect

def run(playwright: Playwright) -> None:
    browser = playwright.chromium.launch(headless=False)
    context = browser.new_context()
    # Open new page
    page = context.new_page()
    # Go to https://www.baidu.com/
    page.goto("https://www.baidu.com/")
    # Click input[name="wd"]
    page.locator("input[name=\"wd\"]").click()
    # Fill input[name="wd"]
    page.locator("input[name=\"wd\"]").fill("航天员")
    # Press Enter
    page.locator("input[name=\"wd\"]").press("Enter")
    page.wait_for_url(
        "https://www.baidu.com/s?ie=utf-8&f=8&rsv_bp=1&rsv_idx=1&tn=baidu&wd=%E8%88%AA%E5%A4%A9%E5%91%98&fenlei=256&rsv_pq=0xfde7decb0011bfe6&rsv_t=3a67vLT%2Buti4VKw0mDppSrydbnq6CGsyOVNNxN%2F39naR6lYvxacuqvbYKRs0&rqlang=en&rsv_enter=1&rsv_dl=tb&rsv_sug3=24&rsv_sug1=24&rsv_sug7=100&rsv_sug2=0&rsv_btype=i&prefixsug=%25E8%2588%25AA%25E5%25A4%25A9%25E5%2591%2598&rsp=5&inputT=5824&rsv_sug4=6786&rsv_jmp=fail")
    # ---------------------
    context.close()
    browser.close()

with sync_playwright() as playwright:
    run(playwright)

接下来我们分析一下其生成的代码含义。

from playwright.sync_api import Playwright, sync_playwright

从 playwright.sync_api 模块导入 Playwright 和 sync_playwright，看到关键字 sync，可以猜测这是一个同步操作，那与之对应的，也是未来我们要对比学习的，就是异步接口相关内容，这里先埋下一个伏笔，下篇博客在进行讨论。

browser = playwright.chromium.launch(headless=False)

初始化一个谷歌浏览器对象，并且不是无头浏览器，即在桌面打开浏览器窗口。launch() 方法包含很多参数，常用的有以下内容：

• headless：是否为无头浏览器，即是否显示浏览器窗口，默认为不显示；
• channel：浏览器版本，"chrome", "chrome-beta", "chrome-dev", "chrome-canary"；
• proxy：代理设置；
• timeout：超时时间，默认 30s。

context = browser.new_context()
page = context.new_page()

打开一个新浏览器，创建一个新页面，其中 browser.new_context() 的参数都是与浏览器配置相关的内容，实践的时候需要特别设置的在这里设置，例如下述参数：

• user_agent：UA 代理；
• viewport：页面大小，比例，例 1024*768；
• offline：离线模式加载。

page.goto("https://www.baidu.com/")
page.locator("input[name=\"wd\"]").click()
……
page.wait_for_url(……)

• goto() ：地址跳转，即浏览器跳转；
• locator()：定位元素；
• wait_for_url()：等待页面加载完毕。

本文末尾重点介绍一下 goto() 相关内容，剩余函数下篇博客继续说明。 goto() 函数的重要参数：

• url：跳转地址，必须包含协议，例如 http:// 或者 https://；
• referer：请求头中的 referer 参数；
• timeout：最大操作时间（毫秒），默认为 30 秒；
• wait_until：默认操作成功时，执行的内容，还有几个事件，分别是 domcontentloaded，networkidle，commit

项目开源地址：https://github.com/microsoft/playwright-python

官方手册：https://playwright.dev/python/docs/intro

到此这篇关于Python Playwright的使用详解的文章就介绍到这了,更多相关Python Playwright内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！