Saltar al contenido principal

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.