Mock-Antwort

Chute kann Mock-Daten für übereinstimmende HTTP/HTTPS-Anfragen zurückgeben. Für entschlüsselte HTTP/2-Streams wird die Mock-Antwort lokal beantwortet, ohne die Anfrage weiterzuleiten; bei HTTP/1.1-Anfragen (einfaches Proxying und MitM HTTP/1.1) wird die Anfrage weiterhin an den echten Server gesendet, und die echte Antwort wird durch die Mock-Daten ersetzt, bevor sie den Client erreicht. Dies ist nützlich für Tests, Entwicklung oder das Blockieren unerwünschter Inhalte mit einer benutzerdefinierten Antwort.

Mock-Regeln werden im Abschnitt [Map Local] definiert.

Pro Anfrage wird nur eine Mock-Regel angewendet — die erste Regel, deren URL-Muster übereinstimmt.

Map-Local-Format

Zum Bereitstellen von Mock-Antworten aus lokalen Dateien oder mit base64-kodierten Inhalten:

[Map Local]
^https://example\.com/api.* data="/path/to/mock-response.json"
^https://example\.com/page.* data="/path/to/page.html" header="SGVhZGVyOiBWYWx1ZQ=="
^https://example\.com/pixel.* base64="R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7"

Hinweis: Der reguläre Ausdruck für die URL muss die vollständige Anfrage-URL abgleichen, nicht nur einen Teilstring davon. Muster sollten in der Regel mit .* enden, damit URLs mit beliebigem Pfad und Query-String abgeglichen werden.

Map-Local-Parameter

Mindestens einer der Parameter data= oder base64= muss angegeben werden.

Hinweis: Beim Parsen von header= werden alle Leerzeichen entfernt und jede Zeile muss genau Key:Value mit einem einzigen Doppelpunkt sein. Header-Werte, die selbst einen Doppelpunkt enthalten (etwa URLs), werden stillschweigend verworfen, und Leerzeichen innerhalb von Werten gehen verloren.

Vorlagenvariablen

Bei Verwendung von data= oder base64= unterstützt der Antwort-Body die Ersetzung von Vorlagenvariablen:

Beispiel einer Mock-Antwortdatei (response.json):

{
    "requested_url": "{{ "{{url}}" }}",
    "host": "{{ "{{host}}" }}",
    "method": "{{ "{{method}}" }}"
}

Hinweis: Für HTTPS-Anfragen muss die MitM-Entschlüsselung für den übereinstimmenden Hostnamen aktiviert sein. Mock-Regeln für HTTPS-Verkehr ohne MitM werden ignoriert.