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');
});
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 |