Réponse simulée

Chute peut renvoyer des données simulées pour les requêtes HTTP/HTTPS correspondantes. Pour les flux HTTP/2 déchiffrés, la réponse simulée est fournie localement sans transmettre la requête ; pour les requêtes HTTP/1.1 (proxy simple et MitM HTTP/1.1), la requête est tout de même envoyée au serveur réel, et la réponse réelle est remplacée par les données simulées avant d'atteindre le client. C'est utile pour les tests, le développement ou pour bloquer du contenu indésirable avec une réponse personnalisée.

Les règles de mock sont définies dans la section [Map Local].

Une seule règle de mock est appliquée par requête — la première dont le motif d'URL correspond.

Format de Map Local

Pour servir des réponses simulées depuis des fichiers locaux ou avec un contenu encodé en base64 :

[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"

Remarque : l'expression régulière d'URL doit correspondre à l'URL de requête complète, et non à une simple sous-chaîne. Les motifs devraient généralement se terminer par .* afin que les URL comportant n'importe quel chemin et n'importe quelle chaîne de requête soient prises en compte.

Paramètres de Map Local

Au moins l'un des paramètres data= ou base64= doit être indiqué.

Remarque : lors de l'analyse de header=, toutes les espaces sont supprimées et chaque ligne doit être exactement Clé:Valeur avec un seul deux-points. Les valeurs d'en-tête contenant elles-mêmes un deux-points (comme les URL) sont silencieusement supprimées, et les espaces à l'intérieur des valeurs sont perdues.

Variables de modèle

Avec data= ou base64=, le corps de la réponse prend en charge la substitution de variables de modèle :

Exemple de fichier de réponse simulée (response.json) :

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

Remarque : pour les requêtes HTTPS, le déchiffrement MitM doit être activé pour le nom d'hôte correspondant. Les règles de mock visant du trafic HTTPS sans MitM seront ignorées.