上期咱们分享了Playwright的概念以及原理,理解了它们之后从本篇文章开始我们将深入探讨Playwright的基础以及高阶玩法。本期先带大家学习和搭建Playwright的环境与配置安装。
那我们开始咯(^▽^)

【官方文档 Node版本】
【官方文档 Python版本】

👑一、安装Playwright

由于Playwright的特性,它支持在Windows、Mac以及Linux系统上安装和使用。

我们可以通过以下方式安装Playwright:

  1. 使用npm安装(适用于Node.js项目)

    1
    2
    3
    npm i -D @playwright/test
    # 安装支持的浏览器引擎
    npx playwright install
  2. 使用yarn安装(适用于Node.js项目)

    1
    yarn create playwright
  3. 使用pnpm安装(适用于Node.js项目)

    1
    pnpm dlx create-playwright
  4. 使用PIP安装(适用于Python项目)

    1
    2
    3
    4
    5
    6
    pip install playwright
    pip install pytest-playwright
    # 安装支持的浏览器引擎
    playwright install chromium
    # 或:
    python3 -m playwright install chromium
  5. Docker安装
    如果你熟悉Docker,也可以使用Playwright提供的Docker镜像安装:

    1
    docker run -it -v /dev/shm:/dev/shm mcr.microsoft.com/playwright:v1.5.2

🍇二、安装Playwright浏览器引擎

需要安装Chromium、Firefox和/或WebKit浏览器来运行测试。我们可以:

  1. 自动安装:这是最简单的方式,在使用Playwright时,它会自动下载对应浏览器。
    1
    2
    3
    4
    5
    # Node版本:
    npx playwright install

    # Python版本:
    playwright install
  2. 手动安装:我们可以手动下载并安装浏览器,然后指定浏览器位置。
    Playwright对浏览器版本有要求,系统浏览器版本需要在支持范围内。以手动安装Chromium为例,我们可以:
    1. 下载Playwright支持版本的Chromium:https://playwright.chromium.org/
    2. 解压到一个文件夹,如:/Users/username/chromium
    3. 设置环境变量
      Mac/Linux:
    1
    export CHROMIUM_EXECUTABLE_PATH=/Users/username/chromium/chrome

    Windows:

    1
    set CHROMIUM_EXECUTABLE_PATH=C:\Users\username\chromium\chrome.exe
  3. 使用系统默认浏览器:我们可以让Playwright使用系统默认安装的浏览器。
  4. Playwright脚本中通过环境变量使用Chromium:
    1
    2
    3
    4
    5
    6
    from playwright.sync_api import sync_playwright

    def run(playwright):
    chromium = playwright.chromium
    browser = chromium.launch() # 使用环境变量指定的Chromium
    # ...

配置环境变量(可选):
我们可以为Playwright相关工具配置环境变量,方便使用:

• PLAYWRIGHT_BROWSERS_PATH:浏览器路径,用于Playwright调用浏览器
• PLAYWRIGHT_TEST_REGEX:测试文件匹配正则,用于pytest-playwright插件
• PLAYWRIGHT_DEBUG:打开Playwright调试日志
• PLAYWRIGHT_HEADLESS:以无头模式启动浏览器

🔞至此我们已经了解Playwright的各种安装方式和浏览器安装配置,以及可选的环境变量设置。在下一章,我们将学习如何编写第一个Playwright测试脚本!