Playwright Netzwerkabfangen

Playwrights Netzwerkinterzeption ist eine sehr nützliche Funktion in Szenarien für automatisiertes Testen und Web Scraping, mit der wir Netzwerkanfragen und -antworten abfangen, ändern und simulieren können.

Playwright bietetpage.route()undpage.on('request') / page.on('response')und andere APIs, die Folgendes können:

  • Anfragen abfangen: entscheiden, ob erlaubt, URL/Headers/Body ändern oder direkt Mock-Antworten zurückgeben.
  • Anfragen/Antworten überwachen: Anfrage-URL, Methode, Header, Antwort-Statuscode, Antwort-Body usw. anzeigen.
  • Netzwerkfehler simulieren: Anfragen blockieren, Fehlercodes zurückgeben, die Fehlertoleranzlogik der Anwendung testen.

Häufige Anwendungsfälle:

  • Mock-API: Frontend-UI-Tests ohne Backend-APIs ausführen.
  • Anfragen ändern: zum Beispiel Token hinzufügen, abnormale Header testen.
  • Performance-Debugging: Anfragen zählen, Antwortzeit.
  • Fehlerinjektion: Serverfehler wie 500/404 simulieren.

Anfragen abfangen:page.route()

await page.route('**/api/todos', async route => {
  // 拦截匹配的请求
  console.log('拦截到请求:', route.request().url());

  // 1. 直接放行(继续请求)
  await route.continue();

  // 2. 修改请求
  // await route.continue({ headers: { ...route.request().headers(), 'X-Test': 'true' } });

  // 3. 返回 mock 响应
  // await route.fulfill({
  //   status: 200,
  //   contentType: 'application/json',
  //   body: JSON.stringify([{ id: 1, text: 'mock todo', done: false }]),
  // });

  // 4. 拒绝请求
  // await route.abort();
});

Parameterbeschreibung:

  • page.route(url, handler): einen Interceptor registrieren,urlunterstützt String, Regex oder**Wildcard.
  • route.request(): das Request-Objekt abrufen.
  • route.continue([options]): die Anfrage zulassen, Methode, Header, postData können geändert werden.
  • route.fulfill(response): direkt eine gefälschte Antwort zurückgeben.
  • route.abort([errorCode]): die Anfrage abbrechen, gängige Fehlercodes wie z. B."failed", "aborted", "timedout"。

Anfragen und Antworten überwachen

// 监听所有请求
page.on('request', req => {
  console.log(`➡️ 请求: ${req.method()} ${req.url()}`);
});

// 监听所有响应
page.on('response', async res => {
  console.log(`⬅️ 响应: ${res.status()} ${res.url()}`);
});

// 获取响应 body
const response = await page.waitForResponse('**/api/data');
console.log('响应内容:', await response.text());

Häufig verwendete Methoden:

  • request.url() / request.method() / request.headers() / request.postData()
  • response.status() / response.headers() / response.text() / response.json()

Netzwerkumgebung simulieren

Beispiele

// Netzwerkfehler simulieren
await page.route('**/*.png', route => route.abort('failed'));

// Verzögerung simulieren
await page.route('**/api/**', async route => {
  await new Promise(r => setTimeout(r, 2000));
  await route.continue();
});
</pre>
<hr>
<h2>Vollständiges Beispiel: Mock-API</h2>
import { test, expect } from '@playwright/test';

test('API abfangen und mocken', async ({ page }) => {
  // /api/todos-Anfrage abfangen und feste Daten zurückgeben
  await page.route('**/api/todos', async route => {
    await route.fulfill({
      status: 200,
      contentType: 'application/json',
      body: JSON.stringify([
        { id: 1, text: 'Playwright lernen', done: false },
        { id: 2, text: 'Automatisierte Tests schreiben', done: wahr },
      ]),
    });
  });

  await page.goto('https://example-todo-app.com');
  const items = await page.locator('.todo-item').allTextContents();
  console.log('Geladene Todo-Einträge:', items);

  // Prüfen, dass die UI Mock-Daten anzeigt
  await expect(page.locator('.todo-item')).toHaveCount(2);
  await expect(page.locator('.todo-item').first()).toContainText('Playwright Learning');
});

Netzwerk-Interception-bezogene APIs

API Zweck Allgemeine Parameter/Beschreibung
page.route(url, handler) Request-Interception registrieren urlKann String/Regex/Wildcard sein
route.request() Request-Objekt abrufen Gibt zurückRequest
route.continue([options]) Request zulassen, kann geändert werden { method, headers, postData }
route.fulfill(response) Benutzerdefinierte Antwort zurückgeben { status, headers, body, contentType }
route.abort([errorCode]) Anfrage abbrechen Allgemein:'failed', 'aborted', 'timedout'
page.unroute(url, handler?) Abfangregel entfernen
page.on('request', cb) Anfrage überwachen
page.on('response', cb) Antwort überwachen
request.url()/method()/headers()/postData() Anfrageinformationen
response.status()/headers()/text()/json() Antwortinformationen
page.waitForResponse(urlOrPredicate) Auf eine bestimmte Antwort warten Kann URL oder Funktion übergeben
Weitere Erweiterungen