Skip to main content

網路

簡介​

Playwright 提供 API 來監控和修改瀏覽器網路流量，包括 HTTP 和 HTTPS。頁面所做的任何請求，包括 XHRs 和 fetch 請求，都可以被追蹤、修改和處理。

模擬 API​

查看我們的 API mocking 指南 以了解更多資訊。

  • 模擬 API 請求並且不會觸發 API
  • 執行 API 請求並修改回應
  • 使用 HAR 檔案來模擬網路請求。

HTTP 認證​

執行 HTTP 認證。

context = browser.new_context(
    http_credentials={"username": "bill", "password": "pa55w0rd"}
)
page = context.new_page()
page.goto("https://example.com")

HTTP Proxy​

您可以配置頁面通過 HTTP(S) 代理或 SOCKSv5 加載。代理可以為整個瀏覽器全域設置，也可以為每個瀏覽器上下文單獨設置。

您可以選擇性地指定 HTTP(S) 代理的使用者名稱和密碼，您也可以指定要繞過代理的主機。

這裡是一個全域代理的範例:

browser = chromium.launch(proxy={
  "server": "http://myproxy.com:3128",
  "username": "usr",
  "password": "pwd"
})

也可以根據上下文指定它:

browser = chromium.launch()
context = browser.new_context(proxy={"server": "http://myproxy.com:3128"})

網路事件​

你可以監控所有的 Request 和 Response:

from playwright.sync_api import sync_playwright, Playwright

def run(playwright: Playwright):
    chromium = playwright.chromium
    browser = chromium.launch()
    page = browser.new_page()
    # Subscribe to "request" and "response" events.
    page.on("request", lambda request: print(">>", request.method, request.url))
    page.on("response", lambda response: print("<<", response.status, response.url))
    page.goto("https://example.com")
    browser.close()

with sync_playwright() as playwright:
    run(playwright)

或者在按鈕點擊後等待網路回應 page.expect_response()：

# Use a glob url pattern
with page.expect_response("**/api/fetch_data") as response_info:
    page.get_by_text("Update").click()
response = response_info.value

變體​

等待 Responses 使用 page.expect_response()

# Use a regular expression
with page.expect_response(re.compile(r"\.jpeg$")) as response_info:
    page.get_by_text("Update").click()
response = response_info.value

# Use a predicate taking a response object
with page.expect_response(lambda response: token in response.url) as response_info:
    page.get_by_text("Update").click()
response = response_info.value

處理請求​

page.route(
    "**/api/fetch_data",
    lambda route: route.fulfill(status=200, body=test_data))
page.goto("https://example.com")

您可以通過在您的 Playwright 腳本中處理網路請求來模擬 API 端點。

變體​

在整個瀏覽器上下文中使用 browser_context.route() 或頁面使用 page.route() 設定路由。它將應用於彈出視窗和打開的連結。

context.route(
    "**/api/login",
    lambda route: route.fulfill(status=200, body="accept"))
page.goto("https://example.com")

修改請求​

# Delete header
def handle_route(route):
    headers = route.request.headers
    del headers["x-secret"]
    route.continue_(headers=headers)
page.route("**/*", handle_route)

# Continue requests as POST.
page.route("**/*", lambda route: route.continue_(method="POST"))

你可以繼續請求並進行修改。上面的範例從傳出的請求中移除了 HTTP 標頭。

中止請求​

你可以使用 page.route() 和 route.abort() 來中止請求。

page.route("**/*.{png,jpg,jpeg}", lambda route: route.abort())

# Abort based on the request type
page.route("**/*", lambda route: route.abort() if route.request.resource_type == "image"  else route.continue_())

修改回應​

要修改回應，使用 APIRequestContext 取得原始回應，然後將回應傳遞給 route.fulfill()。你可以通過選項覆蓋回應的個別欄位:

def handle_route(route: Route) -> None:
    # Fetch original response.
    response = route.fetch()
    # Add a prefix to the title.
    body = response.text()
    body = body.replace("<title>", "<title>My prefix:")
    route.fulfill(
        # Pass all fields from the response.
        response=response,
        # Override response body.
        body=body,
        # Force content type to be html.
        headers={**response.headers, "content-type": "text/html"},
    )

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

WebSockets​

Playwright 支援 WebSockets 檢查。每次建立 WebSocket 時，會觸發 page.on("websocket") 事件。此事件包含 WebSocket 實例以進一步檢查 web socket 幀:

def on_web_socket(ws):
    print(f"WebSocket opened: {ws.url}")
    ws.on("framesent", lambda payload: print(payload))
    ws.on("framereceived", lambda payload: print(payload))
    ws.on("close", lambda payload: print("WebSocket closed"))

page.on("websocket", on_web_socket)

缺少網路事件和服務工作者​

Playwright 的內建 browser_context.route() 和 page.route() 允許你的測試原生地路由請求並執行模擬和攔截。

  1. 如果你正在使用 Playwright 的原生 browser_context.route() 和 page.route()，並且似乎缺少網路事件，請通過將 browser.new_context.service_workers 設置為 'block' 來停用 Service Workers。
  2. 可能是你正在使用諸如 Mock Service Worker (MSW) 之類的模擬工具。雖然這個工具開箱即用來模擬回應，但它添加了自己的 Service Worker，接管了網路請求，因此使它們對 browser_context.route() 和 page.route() 不可見。如果你對網路測試和模擬都感興趣，請考慮使用內建的 browser_context.route() 和 page.route() 來進行 response mocking。
  3. 如果你不僅僅想使用 Service Workers 進行測試和網路模擬，還想路由和監聽 Service Workers 自己發出的請求，請參見這個實驗性功能。