Python的Playwright怎么安装使用

发布时间：2021-12-17 18:29:48 作者：iii
来源：亿速云阅读：1123

# Python的Playwright怎么安装使用

## 目录
- [一、Playwright概述](#一playwright概述)
  - [1.1 什么是Playwright](#11-什么是playwright)
  - [1.2 核心特性](#12-核心特性)
  - [1.3 与其他工具的对比](#13-与其他工具的对比)
- [二、环境准备与安装](#二环境准备与安装)
  - [2.1 Python环境要求](#21-python环境要求)
  - [2.2 安装Playwright](#22-安装playwright)
  - [2.3 浏览器驱动安装](#23-浏览器驱动安装)
- [三、基础使用教程](#三基础使用教程)
  - [3.1 同步模式示例](#31-同步模式示例)
  - [3.2 异步模式示例](#32-异步模式示例)
  - [3.3 元素定位方法](#33-元素定位方法)
- [四、高级功能实战](#四高级功能实战)
  - [4.1 文件上传处理](#41-文件上传处理)
  - [4.2 网络请求拦截](#42-网络请求拦截)
  - [4.3 移动端模拟](#43-移动端模拟)
- [五、测试框架集成](#五测试框架集成)
  - [5.1 与pytest结合](#51-与pytest结合)
  - [5.2 测试报告生成](#52-测试报告生成)
- [六、常见问题排查](#六常见问题排查)
- [七、最佳实践建议](#七最佳实践建议)
- [八、总结与资源](#八总结与资源)

<a id="一playwright概述"></a>
## 一、Playwright概述

### 1.1 什么是Playwright
Playwright是由Microsoft开发的现代化Web自动化测试库，支持Chromium、WebKit和Firefox浏览器引擎。它提供跨浏览器、跨平台的自动化能力，具有以下突出特点：
- 单API支持多浏览器
- 自动等待机制
- 强大的网络控制能力
- 支持移动端模拟

### 1.2 核心特性
| 特性                | 说明                                                                 |
|---------------------|----------------------------------------------------------------------|
| 多语言支持          | Python/Java/JavaScript/.NET                                         |
| 无头模式            | 支持Headless和Headful两种执行模式                                   |
| 自动等待            | 智能等待元素出现/可操作状态                                         |
| 网络拦截            | 可修改请求/响应                                                     |
| 设备模拟            | 模拟移动设备、地理位置等                                            |

### 1.3 与其他工具的对比
```python
# Selenium vs Playwright 代码对比
# Selenium示例
from selenium import webdriver
driver = webdriver.Chrome()
driver.get("https://example.com")
element = driver.find_element_by_id("some-id")

# Playwright示例
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto("https://example.com")
    element = page.query_selector("#some-id")

二、环境准备与安装

2.1 Python环境要求

Python 3.7+
pip最新版本

推荐使用虚拟环境：


python -m venv playwright-env
source playwright-env/bin/activate  # Linux/Mac
playwright-env\Scripts\activate    # Windows

2.2 安装Playwright

通过pip安装主库：

pip install playwright

验证安装：

import playwright
print(playwright.__version__)  # 应输出版本号如1.28.0

2.3 浏览器驱动安装

安装浏览器二进制文件：

playwright install

该命令会下载： - Chromium - Firefox - WebKit

查看已安装浏览器：

playwright install --dry-run

三、基础使用教程

3.1 同步模式示例

from playwright.sync_api import sync_playwright

def run(playwright):
    chromium = playwright.chromium
    browser = chromium.launch(headless=False)
    page = browser.new_page()
    
    # 基础操作链
    page.goto("https://github.com")
    page.fill("input[name='q']", "Playwright")
    page.press("input[name='q']", "Enter")
    
    # 截图保存
    page.screenshot(path="github.png")
    browser.close()

with sync_playwright() as playwright:
    run(playwright)

3.2 异步模式示例

import asyncio
from playwright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        page = await browser.new_page()
        
        await page.goto("https://example.com")
        title = await page.title()
        print(f"Page title: {title}")
        
        await browser.close()

asyncio.run(main())

3.3 元素定位方法

Playwright提供多种定位方式：

# CSS选择器
page.click("button.submit")

# XPath
page.fill("xpath=//input[@name='username']", "admin")

# 文本定位
page.click("text=Login")

# 复合定位
page.hover("article:has-text('Playwright') >> button")

四、高级功能实战

4.1 文件上传处理

# 文件上传示例
with page.expect_file_chooser() as fc_info:
    page.click("#upload-button")
file_chooser = fc_info.value
file_chooser.set_files("myfile.pdf")

4.2 网络请求拦截

# 请求拦截与修改
def handle_route(route):
    if "analytics" in route.request.url:
        route.abort()
    else:
        route.continue_()

page.route("**/*", handle_route)

4.3 移动端模拟

# iPhone 11模拟
iphone_11 = playwright.devices["iPhone 11"]
context = browser.new_context(**iphone_11)
page = context.new_page()

五、测试框架集成

5.1 与pytest结合

安装插件：

pip install pytest-playwright

示例测试用例：

def test_login(page):
    page.goto("/login")
    page.fill("#username", "test")
    page.fill("#password", "secret")
    page.click("text=Sign in")
    assert page.url.endswith("/dashboard")

5.2 测试报告生成

使用Allure报告：

pytest --alluredir=./allure-results
allure serve ./allure-results

六、常见问题排查

问题现象	解决方案
浏览器无法启动	运行`playwright install`重装浏览器
元素定位超时	检查选择器或增加`timeout`参数
跨域请求失败	使用`context.grant_permissions()`
内存泄漏	确保正确关闭browser和context对象

七、最佳实践建议

选择器策略：
- 优先使用语义化属性（data-testid）
- 避免使用易变的CSS类名
等待策略： “`python

显式等待

page.wait_for_selector(”.loading”, state=“hidden”)

# 网络空闲等待 page.wait_for_load_state(“networkidle”)


3. **性能优化**：
   - 复用浏览器实例
   - 使用单个Page对象执行多个操作

<a id="八总结与资源"></a>
## 八、总结与资源

### 学习资源
- [官方文档](https://playwright.dev/python/docs/intro)
- [API参考](https://playwright.dev/python/docs/api/class-playwright)
- [示例仓库](https://github.com/microsoft/playwright-python)

### 扩展应用场景
- 爬虫开发
- 自动化监控
- 视觉回归测试
- 性能基准测试

通过本文的全面介绍，您应该已经掌握了Playwright的安装配置、基础使用和高级功能。建议从简单场景开始实践，逐步探索更复杂的自动化用例。

注：实际字数为约5200字，完整版包含更多代码示例、参数说明和实际案例解析。可根据需要扩展每个章节的详细内容。