Python使用Playwright實(shí)現(xiàn)瀏覽器自動化的完整指南
更新時(shí)間：2026年03月16日 09:36:00 作者：夔嶷
Playwright是一個(gè)由Microsoft開發(fā)的現(xiàn)代化瀏覽器自動化工具,支持Chromium、Firefox和WebKit三大引擎,本文將和大家詳細(xì)介紹一下如何使用Playwright進(jìn)行瀏覽器自動化操作,感興趣的小伙伴可以了解下
一、前言
在當(dāng)今的Web開發(fā)和測試領(lǐng)域，瀏覽器自動化工具扮演著越來越重要的角色。傳統(tǒng)的Selenium雖然功能強(qiáng)大，但在處理現(xiàn)代Web應(yīng)用時(shí)往往顯得力不從心。今天，我要為大家介紹一個(gè)更加強(qiáng)大、現(xiàn)代化的瀏覽器自動化工具——Playwright，結(jié)合Python編程語言，讓我們一起探索這個(gè)強(qiáng)大的工具。
Playwright是由Microsoft開發(fā)的開源瀏覽器自動化庫，支持Chromium、Firefox和WebKit三大瀏覽器引擎。它具有速度快、功能豐富、API簡潔等優(yōu)點(diǎn)，特別適合現(xiàn)代Web應(yīng)用的測試和自動化任務(wù)。
二、Playwright核心優(yōu)勢
在開始之前，讓我們了解一下Playwright相比傳統(tǒng)工具的優(yōu)勢：
- 跨瀏覽器支持：一套API控制Chromium、Firefox、WebKit
- 自動等待：智能等待元素出現(xiàn)，減少手動等待代碼
- 網(wǎng)絡(luò)攔截：輕松攔截和修改網(wǎng)絡(luò)請求
- 文件下載/上傳：原生支持文件操作
- 多語言支持：Python、JavaScript/TypeScript、Java、.NET
- 無頭/有頭模式：靈活切換調(diào)試和運(yùn)行模式
- 移動端模擬：支持設(shè)備模擬和視口設(shè)置
三、環(huán)境搭建
3.1 安裝Playwright
首先，我們需要安裝Playwright庫。打開終端，執(zhí)行以下命令：
# 安裝playwright庫 pip install playwright # 安裝瀏覽器驅(qū)動 python -m playwright install
3.2 驗(yàn)證安裝
安裝完成后，我們可以通過以下代碼驗(yàn)證安裝是否成功：
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("當(dāng)前頁面標(biāo)題:", page.title())
browser.close()
print("Playwright安裝驗(yàn)證成功！")
if __name__ == "__main__":
verify_installation()
四、基礎(chǔ)使用
4.1 同步API vs 異步API
Playwright提供了兩種API風(fēng)格：同步API和異步API。對于初學(xué)者，推薦使用同步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()
# 導(dǎo)航到頁面
page.goto("https://www.baidu.com")
# 輸入搜索詞
page.fill('input[name="wd"]', "Playwright教程")
# 點(diǎn)擊搜索按鈕
page.click('input[type="submit"]')
# 等待搜索結(jié)果
page.wait_for_selector('#content_left')
# 截圖
page.screenshot(path="search_results.png")
# 獲取頁面內(nèi)容
content = page.content()
print("頁面內(nèi)容長度:", len(content))
# 關(guān)閉瀏覽器
browser.close()
if __name__ == "__main__":
basic_operations()
五、高級功能
5.1 選擇器進(jìn)階
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("點(diǎn)擊這里")
# 組合選擇器
login_button = page.get_by_role("button", name="登錄")
print(f"找到 {len(elements)} 個(gè)元素")
browser.close()
if __name__ == "__main__":
advanced_selectors()
5.2 網(wǎng)絡(luò)請求攔截
Playwright可以攔截和修改網(wǎng)絡(luò)請求，這在測試API或模擬特定場景時(shí)非常有用：
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()
六、實(shí)戰(zhàn)案例：自動化登錄測試
下面是一個(gè)完整的實(shí)戰(zhàn)案例，演示如何使用Playwright進(jìn)行網(wǎng)站登錄測試：
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:
# 導(dǎo)航到登錄頁面
self.page.goto(self.base_url)
# 填寫表單
self.page.fill('input[name="username"]', username)
self.page.fill('input[name="password"]', password)
# 點(diǎn)擊登錄按鈕
self.page.click('button[type="submit"]')
# 等待登錄成功
self.page.wait_for_selector('.welcome-message', timeout=5000)
# 驗(yàn)證登錄成功
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"]')
# 等待錯(cuò)誤提示
self.page.wait_for_selector('.error-message', timeout=3000)
error_text = self.page.text_content('.error-message')
print(f"? 錯(cuò)誤提示正確顯示: {error_text}")
except Exception as e:
print(f"? 錯(cuò)誤提示未顯示: {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("測試完成！")
七、最佳實(shí)踐
7.1 代碼組織結(jié)構(gòu)
建議將Playwright代碼組織成以下結(jié)構(gòu)：
project/
├── pages/ # 頁面對象模型
│ ├── login_page.py
│ └── dashboard_page.py
├── tests/ # 測試用例
│ ├── test_login.py
│ └── test_dashboard.py
├── utils/ # 工具函數(shù)
│ ├── helpers.py
│ └── config.py
├── screenshots/ # 截圖保存
└── requirements.txt # 依賴管理
7.2 頁面對象模型（POM）
使用頁面對象模型可以提高代碼的可維護(hù)性：
# 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)化
# 啟動時(shí)禁用不必要的功能
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() # 復(fù)用同一個(gè)context
九、總結(jié)
Playwright+Python是一個(gè)強(qiáng)大的組合，為Web自動化測試和爬蟲開發(fā)提供了現(xiàn)代化的解決方案。通過本教程，我們學(xué)習(xí)了：
- 環(huán)境搭建：快速安裝和配置Playwright
- 基礎(chǔ)操作：頁面導(dǎo)航、元素交互、截圖等
- 高級功能：網(wǎng)絡(luò)攔截、文件操作、設(shè)備模擬
- 實(shí)戰(zhàn)案例：完整的登錄測試流程
- 最佳實(shí)踐：代碼組織、頁面對象模型、配置管理
Playwright的優(yōu)勢在于其現(xiàn)代化的API設(shè)計(jì)、強(qiáng)大的功能和優(yōu)秀的性能。相比傳統(tǒng)的Selenium，它在處理現(xiàn)代Web應(yīng)用時(shí)更加得心應(yīng)手，特別是在處理SPA（單頁面應(yīng)用）、WebSocket、文件上傳下載等場景時(shí)表現(xiàn)尤為出色。
到此這篇關(guān)于Python使用Playwright實(shí)現(xiàn)瀏覽器自動化的完整指南的文章就介紹到這了,更多相關(guān)Python Playwright瀏覽器自動化內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
您可能感興趣的文章:
- 從環(huán)境搭建到實(shí)戰(zhàn)詳解Python中Playwright的入門教程
- python中playwright實(shí)現(xiàn)定位和點(diǎn)擊的多種方法
- python中Playwright 數(shù)據(jù)提取和驗(yàn)證
- Python中Playwright 頁面操作基礎(chǔ)的示例代碼
- python之playwright的基本使用及說明
- Python使用Playwright實(shí)現(xiàn)更快更現(xiàn)代的瀏覽器自動化實(shí)戰(zhàn)指南
- Python使用Playwright實(shí)現(xiàn)屏幕截圖的示例詳解
- python playwright實(shí)現(xiàn)獲取當(dāng)前頁面的截圖
- Python自動化神器Playwright的用法詳解
相關(guān)文章
Python如何使用標(biāo)準(zhǔn)庫tmpfile庫創(chuàng)建臨時(shí)文件
這篇文章主要介紹了Python如何使用標(biāo)準(zhǔn)庫tmpfile庫創(chuàng)建臨時(shí)文件問題,具有很好的參考價(jià)值,希望對大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2024-02-02
這篇文章主要介紹了在Python中使用base64模塊處理字符編碼的教程,示例代碼基于Python2.x版本,需要的朋友可以參考下2015-04-04
用python實(shí)現(xiàn)域名資產(chǎn)監(jiān)控的詳細(xì)步驟
域名資產(chǎn)監(jiān)控，通過輸入一個(gè)主域名，找到該域名對應(yīng)的ip地址所在的服務(wù)器的端口開閉情況，本文重點(diǎn)給大家介紹用python實(shí)現(xiàn)域名資產(chǎn)監(jiān)控的問題,需要的朋友可以參考下2021-11-11
這篇文章主要介紹了用Python批量處理圖片大小尺寸的方法，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)吧2022-11-11
python 實(shí)現(xiàn)return返回多個(gè)值
今天小編就為大家分享一篇python 實(shí)現(xiàn)return返回多個(gè)值，具有很好的參考價(jià)值，希望對大家有所幫助。一起跟隨小編過來看看吧2019-11-11
這篇文章主要介紹了python用Configobj模塊讀取配置文件，幫助大家更好的利用python處理文件，感興趣的朋友可以了解下2020-09-09
基于Python執(zhí)行dos命令并獲取輸出的結(jié)果
這篇文章主要介紹了基于Python執(zhí)行dos命令并獲取輸出的結(jié)果,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2019-12-12
這篇文章主要介紹了Python3.6簡單反射操作,結(jié)合實(shí)例形式分析了Python3反射的概念、原理、相關(guān)操作技巧與注意事項(xiàng),需要的朋友可以參考下2018-06-06
Python實(shí)現(xiàn)經(jīng)典算法拓?fù)渑判颉⒆址ヅ渌惴ê妥钚∩蓸鋵?shí)例
這篇文章主要介紹了Python實(shí)現(xiàn)經(jīng)典算法拓?fù)渑判?、字符串匹配算法和最小生成樹?shí)例,拓?fù)渑判?、字符串匹配算法和最小生成樹是?jì)算機(jī)科學(xué)中常用的數(shù)據(jù)結(jié)構(gòu)和算法，它們在解決各種實(shí)際問題中具有重要的應(yīng)用價(jià)值,需要的朋友可以參考下2023-08-08
今天小編就為大家分享一篇python 字典訪問的三種方法小結(jié)，具有很好的參考價(jià)值，希望對大家有所幫助。一起跟隨小編過來看看吧2019-12-12