Python使用Playwright實現瀏覽器自動化的完整指南
更新時間：2026年03月16日 09:36:00 作者：夔嶷
Playwright是一個由Microsoft開發(fā)的現代化瀏覽器自動化工具,支持Chromium、Firefox和WebKit三大引擎,本文將和大家詳細介紹一下如何使用Playwright進行瀏覽器自動化操作,感興趣的小伙伴可以了解下
一、前言
在當今的Web開發(fā)和測試領域，瀏覽器自動化工具扮演著越來越重要的角色。傳統的Selenium雖然功能強大，但在處理現代Web應用時往往顯得力不從心。今天，我要為大家介紹一個更加強大、現代化的瀏覽器自動化工具——Playwright，結合Python編程語言，讓我們一起探索這個強大的工具。
Playwright是由Microsoft開發(fā)的開源瀏覽器自動化庫，支持Chromium、Firefox和WebKit三大瀏覽器引擎。它具有速度快、功能豐富、API簡潔等優(yōu)點，特別適合現代Web應用的測試和自動化任務。
二、Playwright核心優(yōu)勢
在開始之前，讓我們了解一下Playwright相比傳統工具的優(yōu)勢：
- 跨瀏覽器支持：一套API控制Chromium、Firefox、WebKit
- 自動等待：智能等待元素出現，減少手動等待代碼
- 網絡攔截：輕松攔截和修改網絡請求
- 文件下載/上傳：原生支持文件操作
- 多語言支持：Python、JavaScript/TypeScript、Java、.NET
- 無頭/有頭模式：靈活切換調試和運行模式
- 移動端模擬：支持設備模擬和視口設置
三、環(huán)境搭建
3.1 安裝Playwright
首先，我們需要安裝Playwright庫。打開終端，執(zhí)行以下命令：
# 安裝playwright庫 pip install playwright # 安裝瀏覽器驅動 python -m playwright install
3.2 驗證安裝
安裝完成后，我們可以通過以下代碼驗證安裝是否成功：
from playwright.sync_api import sync_playwright
def verify_installation():
with sync_playwright() as p:
browser = p.chromium.launch(headless=False)
page = browser.new_page()
page.goto("https://www.baidu.com")
print("當前頁面標題:", page.title())
browser.close()
print("Playwright安裝驗證成功！")
if __name__ == "__main__":
verify_installation()
四、基礎使用
4.1 同步API vs 異步API
Playwright提供了兩種API風格：同步API和異步API。對于初學者，推薦使用同步API，代碼更直觀易懂。
同步API示例：
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(headless=False) # headless=False 顯示瀏覽器窗口
page = browser.new_page()
page.goto("https://www.example.com")
print(page.title())
browser.close()
異步API示例：
import asyncio
from playwright.async_api import async_playwright
async def main():
async with async_playwright() as p:
browser = await p.chromium.launch(headless=False)
page = await browser.new_page()
await page.goto("https://www.example.com")
print(await page.title())
await browser.close()
asyncio.run(main())
4.2 基本操作
from playwright.sync_api import sync_playwright
def basic_operations():
with sync_playwright() as p:
# 啟動瀏覽器
browser = p.chromium.launch(headless=False)
page = browser.new_page()
# 導航到頁面
page.goto("https://www.baidu.com")
# 輸入搜索詞
page.fill('input[name="wd"]', "Playwright教程")
# 點擊搜索按鈕
page.click('input[type="submit"]')
# 等待搜索結果
page.wait_for_selector('#content_left')
# 截圖
page.screenshot(path="search_results.png")
# 獲取頁面內容
content = page.content()
print("頁面內容長度:", len(content))
# 關閉瀏覽器
browser.close()
if __name__ == "__main__":
basic_operations()
五、高級功能
5.1 選擇器進階
Playwright支持多種選擇器，包括CSS、XPath、文本選擇器等：
from playwright.sync_api import sync_playwright
def advanced_selectors():
with sync_playwright() as p:
browser = p.chromium.launch(headless=False)
page = browser.new_page()
page.goto("https://www.example.com")
# CSS選擇器
element = page.query_selector('div.container')
# XPath選擇器
elements = page.query_selector_all('//div[@class="item"]')
# 文本選擇器
button = page.get_by_text("點擊這里")
# 組合選擇器
login_button = page.get_by_role("button", name="登錄")
print(f"找到 {len(elements)} 個元素")
browser.close()
if __name__ == "__main__":
advanced_selectors()
5.2 網絡請求攔截
Playwright可以攔截和修改網絡請求，這在測試API或模擬特定場景時非常有用：
from playwright.sync_api import sync_playwright
def intercept_requests():
with sync_playwright() as p:
browser = p.chromium.launch(headless=False)
page = browser.new_page()
# 攔截所有請求
page.route("**/*", lambda route: route.continue_())
# 攔截特定API請求
def handle_api_request(route):
if "api.example.com" in route.request.url:
route.fulfill(
status=200,
content_type="application/json",
body='{"status": "success", "data": "mocked data"}'
)
else:
route.continue_()
page.route("**/api/**", handle_api_request)
page.goto("https://www.example.com")
browser.close()
if __name__ == "__main__":
intercept_requests()
5.3 文件上傳和下載
from playwright.sync_api import sync_playwright
import os
def file_operations():
with sync_playwright() as p:
browser = p.chromium.launch(headless=False)
page = browser.new_page()
# 文件上傳
page.goto("https://filebin.net/")
with page.expect_file_chooser() as fc_info:
page.click('input[type="file"]')
file_chooser = fc_info.value
file_chooser.set_files("example.txt") # 上傳本地文件
# 文件下載
download_path = os.path.join(os.getcwd(), "downloads")
os.makedirs(download_path, exist_ok=True)
page.on("download", lambda download: download.save_as(os.path.join(download_path, download.suggested_filename)))
# 觸發(fā)下載
page.click('a[href="/download/example" rel="external nofollow" ]')
page.wait_for_timeout(3000) # 等待下載完成
browser.close()
if __name__ == "__main__":
file_operations()
六、實戰(zhàn)案例：自動化登錄測試
下面是一個完整的實戰(zhàn)案例，演示如何使用Playwright進行網站登錄測試：
from playwright.sync_api import sync_playwright
import time
class LoginTest:
def __init__(self):
self.base_url = "https://example.com/login"
def setup(self):
self.playwright = sync_playwright().start()
self.browser = self.playwright.chromium.launch(headless=False)
self.context = self.browser.new_context(
viewport={"width": 1200, "height": 800},
user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
)
self.page = self.context.new_page()
def test_login_success(self, username, password):
try:
# 導航到登錄頁面
self.page.goto(self.base_url)
# 填寫表單
self.page.fill('input[name="username"]', username)
self.page.fill('input[name="password"]', password)
# 點擊登錄按鈕
self.page.click('button[type="submit"]')
# 等待登錄成功
self.page.wait_for_selector('.welcome-message', timeout=5000)
# 驗證登錄成功
welcome_text = self.page.text_content('.welcome-message')
assert "歡迎" in welcome_text, "登錄失敗，未找到歡迎信息"
print(f"? 登錄成功！歡迎信息: {welcome_text}")
# 截圖保存
self.page.screenshot(path="login_success.png")
except Exception as e:
print(f"? 登錄失敗: {str(e)}")
self.page.screenshot(path="login_error.png")
raise
def test_login_failure(self, username, password):
try:
self.page.goto(self.base_url)
self.page.fill('input[name="username"]', username)
self.page.fill('input[name="password"]', password)
self.page.click('button[type="submit"]')
# 等待錯誤提示
self.page.wait_for_selector('.error-message', timeout=3000)
error_text = self.page.text_content('.error-message')
print(f"? 錯誤提示正確顯示: {error_text}")
except Exception as e:
print(f"? 錯誤提示未顯示: {str(e)}")
raise
def teardown(self):
self.browser.close()
self.playwright.stop()
if __name__ == "__main__":
test = LoginTest()
test.setup()
try:
# 測試成功登錄
test.test_login_success("testuser", "correctpassword123")
# 測試失敗登錄
test.test_login_failure("wronguser", "wrongpassword")
finally:
test.teardown()
print("測試完成！")
七、最佳實踐
7.1 代碼組織結構
建議將Playwright代碼組織成以下結構：
project/
├── pages/ # 頁面對象模型
│ ├── login_page.py
│ └── dashboard_page.py
├── tests/ # 測試用例
│ ├── test_login.py
│ └── test_dashboard.py
├── utils/ # 工具函數
│ ├── helpers.py
│ └── config.py
├── screenshots/ # 截圖保存
└── requirements.txt # 依賴管理
7.2 頁面對象模型（POM）
使用頁面對象模型可以提高代碼的可維護性：
# pages/login_page.py
class LoginPage:
def __init__(self, page):
self.page = page
self.username_input = 'input[name="username"]'
self.password_input = 'input[name="password"]'
self.login_button = 'button[type="submit"]'
self.error_message = '.error-message'
def navigate(self):
self.page.goto("https://example.com/login")
def login(self, username, password):
self.page.fill(self.username_input, username)
self.page.fill(self.password_input, password)
self.page.click(self.login_button)
def get_error_message(self):
return self.page.text_content(self.error_message) if self.page.is_visible(self.error_message) else None
7.3 配置管理
# utils/config.py
import os
from dotenv import load_dotenv
load_dotenv()
class Config:
BASE_URL = os.getenv("BASE_URL", "https://example.com")
BROWSER_TYPE = os.getenv("BROWSER_TYPE", "chromium")
HEADLESS = os.getenv("HEADLESS", "false").lower() == "true"
TIMEOUT = int(os.getenv("TIMEOUT", "30000"))
@classmethod
def get_browser_args(cls):
return {
"headless": cls.HEADLESS,
"slow_mo": 50 if not cls.HEADLESS else 0,
"args": ["--start-maximized"] if not cls.HEADLESS else []
}
八、常見問題解決
8.1 元素找不到的處理
from playwright.sync_api import TimeoutError
def safe_find_element(page, selector, timeout=5000):
try:
element = page.wait_for_selector(selector, timeout=timeout)
return element
except TimeoutError:
print(f"?? 元素未找到: {selector}")
page.screenshot(path=f"element_not_found_{int(time.time())}.png")
return None
8.2 等待策略優(yōu)化
# 不推薦：固定等待
page.wait_for_timeout(2000)
# 推薦：智能等待
page.wait_for_selector('#result', state='visible')
page.wait_for_function('() => document.readyState === "complete"')
page.wait_for_response('**/api/data**')
8.3 性能優(yōu)化
# 啟動時禁用不必要的功能
browser = p.chromium.launch(
headless=True,
args=[
'--no-sandbox',
'--disable-dev-shm-usage',
'--disable-gpu',
'--disable-software-rasterizer'
]
)
# 使用context reuse
context = browser.new_context()
page1 = context.new_page()
page2 = context.new_page() # 復用同一個context
九、總結
Playwright+Python是一個強大的組合，為Web自動化測試和爬蟲開發(fā)提供了現代化的解決方案。通過本教程，我們學習了：
- 環(huán)境搭建：快速安裝和配置Playwright
- 基礎操作：頁面導航、元素交互、截圖等
- 高級功能：網絡攔截、文件操作、設備模擬
- 實戰(zhàn)案例：完整的登錄測試流程
- 最佳實踐：代碼組織、頁面對象模型、配置管理
Playwright的優(yōu)勢在于其現代化的API設計、強大的功能和優(yōu)秀的性能。相比傳統的Selenium，它在處理現代Web應用時更加得心應手，特別是在處理SPA（單頁面應用）、WebSocket、文件上傳下載等場景時表現尤為出色。
到此這篇關于Python使用Playwright實現瀏覽器自動化的完整指南的文章就介紹到這了,更多相關Python Playwright瀏覽器自動化內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
Python如何使用標準庫tmpfile庫創(chuàng)建臨時文件
這篇文章主要介紹了Python如何使用標準庫tmpfile庫創(chuàng)建臨時文件問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-02-02
這篇文章主要介紹了在Python中使用base64模塊處理字符編碼的教程,示例代碼基于Python2.x版本,需要的朋友可以參考下2015-04-04
域名資產監(jiān)控，通過輸入一個主域名，找到該域名對應的ip地址所在的服務器的端口開閉情況，本文重點給大家介紹用python實現域名資產監(jiān)控的問題,需要的朋友可以參考下2021-11-11
這篇文章主要介紹了用Python批量處理圖片大小尺寸的方法，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習吧2022-11-11
今天小編就為大家分享一篇python 實現return返回多個值，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2019-11-11
這篇文章主要介紹了python用Configobj模塊讀取配置文件，幫助大家更好的利用python處理文件，感興趣的朋友可以了解下2020-09-09
這篇文章主要介紹了基于Python執(zhí)行dos命令并獲取輸出的結果,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2019-12-12
這篇文章主要介紹了Python3.6簡單反射操作,結合實例形式分析了Python3反射的概念、原理、相關操作技巧與注意事項,需要的朋友可以參考下2018-06-06
Python實現經典算法拓撲排序、字符串匹配算法和最小生成樹實例
這篇文章主要介紹了Python實現經典算法拓撲排序、字符串匹配算法和最小生成樹實例,拓撲排序、字符串匹配算法和最小生成樹是計算機科學中常用的數據結構和算法，它們在解決各種實際問題中具有重要的應用價值,需要的朋友可以參考下2023-08-08
今天小編就為大家分享一篇python 字典訪問的三種方法小結，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2019-12-12