Playwright 2026: Selenium보다 3배 빠른 크로스 브라우저 자동화 도구 — 설치 가이드

pip install playwright==1.51.0

# 브라우저 바이너리 설치(Chromium, Firefox, WebKit)
playwright install

# 선택: 더 빠른 설정을 위해 Chromium만 설치
playwright install chromium

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto("https://httpbin.org/get")
    print(f"Title: {page.title()}")
    browser.close()

print("Playwright is ready!")

from playwright.sync_api import sync_playwright

def test_login_flow():
    with sync_playwright() as p:
        browser = p.chromium.launch(headless=True)
        context = browser.new_context(
            viewport={"width": 1920, "height": 1080}
        )
        page = context.new_page()
        
        # 로그인 페이지로 이동
        page.goto("https://httpbin.org/forms/post")
        
        # 양식 필드 채우기 (요소 자동 대기)
        page.fill("[name='custname']", "John Doe")
        page.fill("[name='custtel']", "555-1234")
        page.fill("[name='custemail']", "john@example.com")
        
        # 양식 제출
        page.click("input[type='submit']")
        
        # 결과 검증
        assert "John Doe" in page.content()
        
        context.close()
        browser.close()

if __name__ == "__main__":
    test_login_flow()
    print("Test passed!")

# 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=True)
        yield browser
        browser.close()

@pytest.fixture
def page(browser):
    context = browser.new_context(
        viewport={"width": 1920, "height": 1080}
    )
    page = context.new_page()
    yield page
    context.close()

# test_ecommerce.py
def test_add_to_cart(page):
    page.goto("https://example.com/products")
    page.click("button[data-testid='add-to-cart']")
    
    # 장바구니 배지 업데이트를 자동으로 대기
    cart_count = page.inner_text(".cart-badge")
    assert cart_count == "1"

def test_search_results(page):
    page.goto("https://example.com")
    page.fill("[name='q']", "laptop")
    page.press("[name='q']", "Enter")
    
    # 결과 로딩 대기
    page.wait_for_selector(".search-result")
    results = page.query_selector_all(".search-result")
    assert len(results) > 0

# .github/workflows/playwright.yml
name: Playwright Tests
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: pip install playwright==1.51.0 pytest
      - run: playwright install chromium
      - run: pytest --tracing=retain-on-failure
      - uses: actions/upload-artifact@v4
        if: failure()
        with:
          name: playwright-traces
          path: test-results/

# codegen을 시작하고 상호작용을 녹화
playwright codegen https://example.com

# 특정 뷰포트로 녹화
playwright codegen --viewport-size="1920,1080" https://example.com

# 특정 언어로 녹화
playwright codegen --target=python https://example.com

import asyncio
from playwright.async_api import async_playwright

async def scrape_multiple_pages():
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        
        # 5개 페이지를 동시에 실행
        tasks = []
        for i in range(5):
            context = await browser.new_context()
            page = await context.new_page()
            task = page.goto(f"https://httpbin.org/get?page={i}")
            tasks.append(task)
        
        await asyncio.gather(*tasks)
        print("All pages loaded!")
        await browser.close()

asyncio.run(scrape_multiple_pages())

# 병렬 테스트 실행기 설치
pip install pytest-xdist

# 4개의 병렬 워커에서 테스트 실행
pytest -n 4 --headed

# 디버깅을 위한 추적 활성화
pytest --tracing=on -n auto

# Dockerfile
FROM mcr.microsoft.com/playwright/python:v1.51.0-jammy

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY tests/ ./tests/
CMD ["pytest", "-n", "4", "--tracing=retain-on-failure"]

from playwright.sync_api import sync_playwright

def test_with_mocked_api():
    with sync_playwright() as p:
        browser = p.chromium.launch()
        page = browser.new_page()
        
        # API 응답 가로채기 및 모킹
        page.route("**/api/products", lambda route: route.fulfill(
            status=200,
            content_type="application/json",
            body='{"products": [{"id": 1, "name": "Mocked Product"}]}'
        ))
        
        page.goto("https://example.com/products")
        assert "Mocked Product" in page.content()
        browser.close()

from playwright.sync_api import sync_playwright
import json

def save_auth_state():
    with sync_playwright() as p:
        browser = p.chromium.launch()
        context = browser.new_context()
        page = context.new_page()
        
        # 한 번만 로그인 수행
        page.goto("https://example.com/login")
        page.fill("#username", "admin")
        page.fill("#password", "secret")
        page.click("#login-button")
        page.wait_for_url("**/dashboard")
        
        # 인증 상태 저장
        context.storage_state(path="auth.json")
        browser.close()

def test_with_saved_auth():
    with sync_playwright() as p:
        browser = p.chromium.launch()
        # 저장된 인증 재사용
        context = browser.new_context(storage_state="auth.json")
        page = context.new_page()
        
        # 이미 로그인됨 - 로그인 플로우 건너뛰기
        page.goto("https://example.com/dashboard")
        assert "Welcome" in page.content()
        browser.close()

from playwright.sync_api import sync_playwright

def test_visual_regression():
    with sync_playwright() as p:
        browser = p.chromium.launch()
        page = browser.new_page(viewport={"width": 1920, "height": 1080})
        
        page.goto("https://example.com/landing")
        
        # 스크린샷 캡처 및 비교
        page.screenshot(path="landing.png", full_page=True)
        
        # pixelmatch 또는 유사 도구로 기준과 비교
        # assert compare_images("landing-baseline.png", "landing.png") < 0.1
        
        browser.close()

from playwright.sync_api import sync_playwright

iphone = sync_playwright().start().devices["iPhone 14 Pro Max"]

def test_mobile_viewport():
    with sync_playwright() as p:
        browser = p.chromium.launch()
        context = browser.new_context(**p.devices["iPhone 14 Pro Max"])
        page = context.new_page()
        
        page.goto("https://example.com")
        page.screenshot(path="mobile-view.png")
        
        # 햄버거 메뉴 상호작용 테스트
        page.click("[aria-label='Menu']")
        assert page.is_visible("nav.mobile-menu")
        
        browser.close()

from playwright.sync_api import sync_playwright

def test_api_contract():
    with sync_playwright() as p:
        browser = p.chromium.launch()
        page = browser.new_page()
        
        responses = []
        page.on("response", lambda r: responses.append(r))
        
        page.goto("https://example.com")
        
        # 특정 API 호출이 수행되었는지 확인
        api_calls = [r for r in responses if "/api/data" in r.url]
        assert len(api_calls) > 0
        
        # 응답 상태 확인
        assert api_calls[0].status == 200
        
        # 응답 본문 구조 확인
        body = api_calls[0].json()
        assert "data" in body
        
        browser.close()

from playwright.sync_api import sync_playwright

def scrape_with_stealth():
    with sync_playwright() as p:
        browser = p.chromium.launch(
            headless=True,
            args=["--disable-blink-features=AutomationControlled"]
        )
        context = browser.new_context(
            user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
        )
        
        # 자동화 플래그를 숨기는 스텔스 스크립트 주입
        page = context.new_page()
        page.add_init_script("""
            Object.defineProperty(navigator, 'webdriver', {
                get: () => undefined
            });
        """)
        
        page.goto("https://example.com")
        print(page.title())
        browser.close()

pip install --upgrade playwright==1.51.0
playwright install