# 安裝 Playwright Python 包
pip install playwright
# 安裝瀏覽器二進(jìn)制文件
playwright install

# 在項(xiàng)目目錄中創(chuàng)建 requirements.txt
echo "playwright" > requirements.txt
# 創(chuàng)建基本的測(cè)試結(jié)構(gòu)
mkdir tests
touch tests/test_example.py

from playwright.sync_api import sync_playwright
def run_sync():
    with sync_playwright() as p:
        browser = p.chromium.launch(headless=False)
        page = browser.new_page()
        page.goto('https://example.com')
        browser.close()
run_sync()

import asyncio
from playwright.async_api import async_playwright
async def run_async():
    async with async_playwright() as p:
        browser = await p.chromium.launch(headless=False)
        page = await browser.new_page()
        await page.goto('https://example.com')
        await browser.close()
asyncio.run(run_async())

# 各種瀏覽器啟動(dòng)選項(xiàng)
browser = p.chromium.launch(
    headless=False,           # 顯示瀏覽器界面
    slow_mo=100,             # 操作間延遲（毫秒）
    args=['--start-maximized'],  # 瀏覽器參數(shù)
    executable_path='/path/to/chrome',  # 指定瀏覽器路徑
    timeout=30000,            # 超時(shí)時(shí)間
    devtools=True,            # 打開(kāi)開(kāi)發(fā)者工具
    proxy={
        'server': 'http://proxy.example.com:8080',
        'username': 'user',
        'password': 'pass'
    }
)

# 基本導(dǎo)航
page.goto('https://example.com')
# 帶選項(xiàng)的導(dǎo)航
page.goto('https://example.com', 
    timeout=30000,           # 超時(shí)時(shí)間
    wait_until='networkidle', # 等待條件：'load'|'domcontentloaded'|'networkidle'
    referer='https://google.com' # 設(shè)置referer
)
# 導(dǎo)航事件處理
page.on('load', lambda: print('Page loaded!'))
# 前進(jìn)和后退
page.go_back()
page.go_forward()
# 重新加載
page.reload()

# 等待元素出現(xiàn)
page.wait_for_selector('#element-id', timeout=10000)
# 等待特定條件
page.wait_for_function('document.querySelector(".content").innerText.includes("Hello")')
# 等待超時(shí)
page.wait_for_timeout(3000)  # 等待3秒
# 等待導(dǎo)航完成
with page.expect_navigation():
    page.click('a#submit')
# 等待彈出窗口
with page.expect_popup() as popup_info:
    page.click('a[target="_blank"]')
popup = popup_info.value

# CSS選擇器
page.click('button.submit')
page.fill('input#username', 'myuser')
# XPath選擇器
page.click('//button[text()="Submit"]')
# 文本選擇器
page.click('text=Login')
page.click('text="Click here"')  # 精確匹配
# 組合選擇器
page.click('div.container >> text=Submit')
# 根據(jù)屬性選擇
page.click('[data-testid="submit-button"]')
# 根據(jù)可見(jiàn)性選擇
page.click('button:visible')
# 根據(jù)狀態(tài)選擇
page.click('button:enabled')
page.click('input:checked')

# 點(diǎn)擊操作
page.click('button')
page.dblclick('button')
page.click('button', button='right')  # 右鍵點(diǎn)擊
page.click('button', modifiers=['Shift'])  # 帶修飾鍵點(diǎn)擊
# 輸入操作
page.fill('input#name', 'John Doe')
page.type('input#name', 'Hello World', delay=100)  # 模擬按鍵延遲
# 選擇操作
page.select_option('select#colors', 'red')
page.select_option('select#colors', index=1)  # 按索引選擇
page.select_option('select#colors', value=['red', 'blue'])  # 多選
# 復(fù)選框和單選按鈕
page.check('input#agree')
page.uncheck('input#subscribe')
# 文件上傳
page.set_input_files('input[type=file]', 'path/to/file.txt')
page.set_input_files('input[type=file]', ['file1.txt', 'file2.txt'])  # 多文件
# 聚焦和模糊
page.focus('input#search')
page.blur('input#search')
# 懸停
page.hover('div.menu-item')
# 拖放
page.drag_and_drop('#source', '#target')

# 檢查元素存在
if page.query_selector('div.error'):
    print('Error element exists')
# 檢查元素可見(jiàn)性
is_visible = page.is_visible('div.popup')
is_hidden = page.is_hidden('div.loading')
# 檢查元素狀態(tài)
is_enabled = page.is_enabled('button.submit')
is_checked = page.is_checked('input#agree')
is_editable = page.is_editable('input#name')
# 獲取元素屬性
value = page.get_attribute('img#logo', 'src')
class_name = page.get_attribute('div.container', 'class')
# 獲取元素文本
text = page.text_content('div.message')
inner_text = page.inner_text('div.message')
# 獲取元素HTML
html = page.inner_html('div.container')
# 獲取輸入值
input_value = page.input_value('input#email')

# 鍵盤(pán)輸入
page.keyboard.type('Hello World!')
page.keyboard.press('Enter')
page.keyboard.down('Shift')
page.keyboard.up('Shift')
# 快捷鍵
page.keyboard.press('Control+A')  # 全選
page.keyboard.press('Control+C')  # 復(fù)制
page.keyboard.press('Control+V')  # 粘貼
# 特殊鍵
page.keyboard.press('ArrowLeft')
page.keyboard.press('Tab')
page.keyboard.press('Escape')

# 獲取元素位置
bounding_box = page.query_selector('button').bounding_box()
# 精確鼠標(biāo)控制
page.mouse.move(bounding_box['x'] + bounding_box['width']/2, 
                bounding_box['y'] + bounding_box['height']/2)
page.mouse.click(bounding_box['x'] + bounding_box['width']/2, 
                 bounding_box['y'] + bounding_box['height']/2)
# 鼠標(biāo)拖拽
page.mouse.down()
page.mouse.move(100, 100)
page.mouse.up()

# 觸摸操作
page.touchscreen.tap(100, 100)
# 多點(diǎn)觸控
page.touchscreen.tap_point(100, 100)
page.touchscreen.tap_point(200, 200)

# 獲取所有頁(yè)面
all_pages = context.pages
# 創(chuàng)建新頁(yè)面
new_page = context.new_page()
# 等待新頁(yè)面
with context.expect_page() as new_page_info:
    page.click('a[target="_blank"]')
new_page = new_page_info.value
# 切換到特定頁(yè)面
context.pages[1].bring_to_front()

# 獲取框架
frame = page.frame(name='frame-name')
frame = page.frame(url=r'.*login.*')
# 框架內(nèi)操作
frame.click('button.submit')
frame.fill('input#username', 'user')
# 遍歷所有框架
for frame in page.frames:
    print(frame.name)

# 執(zhí)行JavaScript
page.evaluate('document.title')
result = page.evaluate('([x, y]) => x + y', [1, 2])
# 注入JavaScript
page.add_script_tag(url='https://code.jquery.com/jquery.js')
page.add_script_tag(content='console.log("Hello");')
# 注入樣式
page.add_style_tag(url='https://cdn.example.com/style.css')
page.add_style_tag(content='body { background: red; }')
# 設(shè)置頁(yè)面內(nèi)容
page.set_content('<html><body><h1>Hello</h1></body></html>')

# 路由攔截
def handle_route(route):
    if 'api.example.com' in route.request.url:
        route.fulfill(
            status=200,
            content_type='application/json',
            body='{"success": true}'
        )
    else:
        route.continue_()
page.route('**/*', handle_route)
# 特定模式攔截
page.route('**/*.jpg', lambda route: route.abort())
page.route('**/api/*', handle_route)
# 修改請(qǐng)求頭
page.route('**/*', lambda route: route.continue_(headers={**route.request.headers, 'x-custom': 'value'}))

# 請(qǐng)求事件處理
def log_request(request):
    print(f"Request: {request.method} {request.url}")
def log_response(response):
    print(f"Response: {response.status} {response.url}")
page.on('request', log_request)
page.on('response', log_response)
# 等待請(qǐng)求完成
with page.expect_response('https://example.com/api/data') as response_info:
    page.click('button#load-data')
response = response_info.value
# 等待多個(gè)請(qǐng)求
with page.expect_response(lambda response: response.url.startswith('https://api')) as response_info:
    page.click('button#fetch')

# 使用Playwright發(fā)起API請(qǐng)求
response = page.request.get('https://api.example.com/data')
print(response.json())
# 帶參數(shù)的請(qǐng)求
response = page.request.post(
    'https://api.example.com/login',
    data={'username': 'user', 'password': 'pass'},
    headers={'Content-Type': 'application/json'}
)

# 頁(yè)面標(biāo)題斷言
assert page.title() == 'Expected Title'
# URL斷言
assert page.url == 'https://example.com'
# 元素可見(jiàn)性斷言
assert page.is_visible('div.success')
# 文本內(nèi)容斷言
assert 'Welcome' in page.text_content('body')

# 等待元素出現(xiàn)并斷言
page.wait_for_selector('div.success', state='visible')
assert page.text_content('div.success') == 'Operation successful'
# 等待文本出現(xiàn)
page.wait_for_selector('text=Welcome back')
# 等待函數(shù)條件
page.wait_for_function('() => document.querySelectorAll(".item").length > 5')

# 頁(yè)面截圖
page.screenshot(path='screenshot.png')
# 元素截圖
page.locator('div.chart').screenshot(path='chart.png')
# 截圖選項(xiàng)
page.screenshot(
    path='fullpage.png',
    full_page=True,           # 截取完整頁(yè)面
    type='jpeg',              # 圖片類(lèi)型：'png'|'jpeg'
    quality=80,               # JPEG質(zhì)量（0-100）
    omit_background=True,     # 隱藏默認(rèn)背景
    timeout=10000             # 超時(shí)時(shí)間
)

# 生成PDF
page.pdf(
    path='page.pdf',
    scale=0.8,                # 縮放比例
    format='A4',              # 紙張格式
    margin={'top': '1cm', 'bottom': '1cm'},  # 邊距
    print_background=True,    # 打印背景
    landscape=False           # 橫向/縱向
)

# 模擬移動(dòng)設(shè)備
from playwright.sync_api import sync_playwright
def test_mobile():
    with sync_playwright() as p:
        # 獲取設(shè)備描述符
        iPhone = p.devices['iPhone 12 Pro']
        # 使用設(shè)備模擬創(chuàng)建上下文
        browser = p.chromium.launch()
        context = browser.new_context(**iPhone)
        page = context.new_page()
        page.goto('https://example.com')
        # 移動(dòng)端測(cè)試代碼...
        browser.close()

# 模擬地理位置
context = browser.new_context(
    geolocation={'longitude': 116.397128, 'latitude': 39.916697},
    permissions=['geolocation']
)
# 模擬權(quán)限
context = browser.new_context(
    permissions=['notifications', 'microphone']
)

# 設(shè)置Cookie
context.add_cookies([{
    'name': 'session',
    'value': 'abc123',
    'url': 'https://example.com',
    'domain': 'example.com',
    'path': '/',
    'httpOnly': True,
    'secure': True,
    'expires': int(time.time()) + 3600  # 1小時(shí)后過(guò)期
}])
# 獲取Cookie
cookies = context.cookies()

# conftest.py
import pytest
from playwright.sync_api import sync_playwright
@pytest.fixture(scope='session')
def browser():
    with sync_playwright() as p:
        browser = p.chromium.launch(headless=False)
        yield browser
        browser.close()
@pytest.fixture
def page(browser):
    context = browser.new_context()
    page = context.new_page()
    yield page
    context.close()
# test_example.py
def test_login(page):
    page.goto('https://example.com/login')
    page.fill('input#username', 'testuser')
    page.fill('input#password', 'password')
    page.click('button#submit')
    assert page.url == 'https://example.com/dashboard'

# 頁(yè)面對(duì)象模型
class LoginPage:
    def __init__(self, page):
        self.page = page
        self.username_input = page.locator('input#username')
        self.password_input = page.locator('input#password')
        self.submit_button = page.locator('button#submit')
    def navigate(self):
        self.page.goto('https://example.com/login')
    def login(self, username, password):
        self.username_input.fill(username)
        self.password_input.fill(password)
        self.submit_button.click()
# 使用頁(yè)面對(duì)象
def test_login(page):
    login_page = LoginPage(page)
    login_page.navigate()
    login_page.login('testuser', 'password')
    assert page.url == 'https://example.com/dashboard'

# 啟用調(diào)試模式
browser = p.chromium.launch(headless=False, devtools=True)
# 暫停執(zhí)行
page.pause()
# 慢速模式
browser = p.chromium.launch(headless=False, slow_mo=1000)
# 記錄控制臺(tái)輸出
page.on('console', lambda msg: print(f'CONSOLE: {msg.text}'))
# 記錄頁(yè)面錯(cuò)誤
page.on('pageerror', lambda err: print(f'PAGE ERROR: {err}'))
# 記錄請(qǐng)求失敗
page.on('requestfailed', lambda req: print(f'REQUEST FAILED: {req.url} {req.failure}'))

# 高亮匹配元素
page.locator('button').highlight()
# 評(píng)估選擇器
count = page.locator('button').count()
print(f'Found {count} buttons')
# 調(diào)試選擇器
try:
    page.wait_for_selector('button:visible', timeout=5000)
except:
    print('Button not found within 5 seconds')

# 復(fù)用瀏覽器上下文
context = browser.new_context()
# 在不同測(cè)試中復(fù)用
def test_1(context):
    page = context.new_page()
    # 測(cè)試代碼...
def test_2(context):
    page = context.new_page()
    # 測(cè)試代碼...
# 清理上下文
context.clear_cookies()
context.clear_permissions()

# 使用多線(xiàn)程并行測(cè)試
import concurrent.futures
def run_test(test_func, browser_type):
    with sync_playwright() as p:
        browser = getattr(p, browser_type).launch()
        context = browser.new_context()
        page = context.new_page()
        test_func(page)
        browser.close()
with concurrent.futures.ThreadPoolExecutor() as executor:
    futures = []
    for _ in range(3):
        futures.append(executor.submit(run_test, test_function, 'chromium'))
    for future in concurrent.futures.as_completed(futures):
        future.result()