Reglas de reescritura
Las reglas de reescritura constan de dos partes: reglas de coincidencia (qué solicitudes se reescriben) y reglas de reescritura (cómo se reescriben).
La depuración de reescritura admite reescribir HTTP(S), WebSocket, TCP y UDP. Puedes redirigir solicitudes, reescribir path/query/headers/body o simular (mock) respuestas por protocolo — para los flujos binarios ver modificar TCP o WebSocket.
1. Redirigir solicitudes para «HTTP&WebSocket&TCP»
La redirección sirve para cambiar la dirección y el puerto de destino de una solicitud, y también determina si se usa cifrado SSL/TLS. Esta regla es especialmente útil cuando durante las pruebas se cambia con frecuencia entre las direcciones del servidor de pruebas y el de producción.
2. Reescribir el path para «HTTP&WebSocket»
El path HTTP es la parte de la URL que sigue al nombre de host; identifica la ruta de los recursos en el servidor web.
https://example.com/api/user?name=john&age=25
En este ejemplo, /api/user es el path, normalmente comenzando por /. Al reescribir el path se reemplaza el path completo. Si quieres dejarlo vacío, escribe simplemente /.
3. Reescribir los query params para «HTTP&WebSocket»
El query HTTP es una técnica para pasar datos por la URL: con el símbolo «?» pueden pasarse parámetros y valores en la URL. Los queries constan de uno o más pares clave-valor separados por «&».
Por ejemplo, la siguiente URL contiene un query string con dos parámetros (name y age):
https://example.com/api/user?name=john&age=25
En este ejemplo, name=john&age=25 es el query string, compuesto por varios pares clave-valor unidos por «&». Al reescribir, Hodor analiza el query en pares clave-valor (considerando el orden y los casos de arrays) y modifica la clave y el valor correspondientes. Además, estos nombres y valores de parámetro deben ir codificados en URL: por ejemplo, «value 1» se codifica como «value%201». Hodor gestiona esas conversiones por ti.
4. Reescribir los headers para «HTTP&WebSocket»
Los headers HTTP son un conjunto de pares clave-valor. Puedes añadir o quitar valores del header HTTP. Sin embargo, hay consideraciones especiales para campos como Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding y Transfer-Encoding, controlados por el sistema y que no surten efecto si se rellenan a mano. Si se indica Content-Type, prevalecerá sobre el mime-type del sistema.
5. Modificar el body para «HTTP»
El body HTTP puede transmitir datos en varios formatos de codificación. Hodor admite decodificar los datos en cuatro formatos (text, JSON, x-www-form-urlencoded, multipart/form-data) y modificarlos como pares clave-valor. También puedes reemplazar dinámicamente la sección completa del body con datos preparados de antemano.
5.1. Decodificar como text y modificar con expresiones regulares
La documentación detallada está en el documento de ejemplo.
5.2. Decodificar como JSON para modificarlo
La documentación detallada está en el documento de ejemplo.
5.3. Decodificar como x-www-form-urlencoded para modificarlo
La documentación detallada está en el documento de ejemplo.
5.4. Decodificar como multipart/form-data para modificarlo
La documentación detallada está en el documento de ejemplo.
6. Reemplazar el body para «HTTP»
Reemplaza directamente la sección del body antes de que la app envíe la solicitud al servidor y antes de que los datos del servidor vuelvan a la app.
7. Reescribir el código para «HTTP»
Hodor puede cambiar los códigos de estado HTTP y también redirigir mediante los códigos de respuesta HTTP, eligiendo entre 301, 302, 307 y 308 con direcciones de redirección configurables.
8. Mock para «HTTP»
Se usa principalmente para devolver un contenido concreto a una solicitud determinada: puedes verlo como un servidor HTTP local que devuelve contenido predefinido para las solicitudes coincidentes.
9. Modificar datos para «TCP&WebSocket»
Convierte el flujo de datos ascendente y descendente de TCP o WebSocket en texto o hex16, y usa expresiones regulares para modificar esos datos. La documentación detallada está en el documento de ejemplo.