Правила переписывания
Правила переписывания состоят из двух частей: правила сопоставления (какие запросы переписывать) и правила переписывания (как переписывать).
Rewrite Debug поддерживает переписывание для HTTP(S), WebSocket, TCP и UDP. Вы можете перенаправлять запросы, переписывать path/query/headers/body или мокировать ответы по каждому протоколу — подробности о бинарных потоках см. в Изменении TCP или WebSocket.
1. Перенаправление запросов для «HTTP&WebSocket&TCP»
Перенаправление используется для изменения целевого адреса и порта запроса, а также может определять, использовать ли шифрование SSL/TLS. Это правило особенно полезно при частом переключении между адресами тестового и производственного серверов во время тестирования.
2. Переписывание Path для «HTTP&WebSocket»
HTTP Path — часть URL после имени хоста, используемая для идентификации пути к ресурсам на веб-сервере.
https://example.com/api/user?name=john&age=25
В этом примере /api/user — это Path, обычно начинается с /. При переписывании Path нужно заменить весь путь. Если вы хотите заменить Path пустотой, просто заполните /.
3. Переписывание Query для «HTTP&WebSocket»
HTTP Query — техника передачи данных через URL, позволяющая передавать параметры и значения в URL с помощью символа «?». Query состоит из одной или нескольких пар ключ-значение, разделенных «&».
Например, следующий URL содержит строку запроса с двумя параметрами (name и age):
https://example.com/api/user?name=john&age=25
В этом примере name=john&age=25 — строка запроса, состоящая из нескольких пар ключ-значение, соединенных «&». При переписывании Hodor разбирает Query на пары ключ-значение (обрабатывая порядок и ситуации с массивами) и изменяет соответствующие Key, Value. Кроме того, эти имена параметров и значения должны быть URL-кодированы, например «value 1» кодируется как «value%201». Hodor автоматически выполняет эти преобразования за вас.
4. Переписывание Headers для «HTTP&WebSocket»
HTTP Headers — набор пар ключ-значение. Вы можете добавлять или удалять значения из HTTP-заголовка. Однако есть несколько особых соображений для полей вроде Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding: они контролируются системой и будут неэффективны при ручном заполнении. Если указан Content-Type, он переопределит системную настр ойку mime-type.
5. Изменение Body для «HTTP»
HTTP Body может передавать данные в различных форматах кодирования. Hodor поддерживает декодирование данных в четыре формата (text, JSON, x-www-form-urlencoded, multipart/form-data) и изменение их как пар ключ-значение. Либо вы можете динамически заменить весь раздел Body заранее подготовленными данными.
5.1. Декодирование как text и изменение регулярными выражениями
Подробную документацию смотрите в примере документа.