Перейти к основному содержимому

Правила переписывания

Правила переписывания состоят из двух частей: правила сопоставления (какие запросы переписывать) и правила переписывания (как переписывать).

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 и изменение регулярными выражениями​

Подробную документацию смотрите в примере документа.

5.2. Декодирование как JSON для изменения​

Подробную документацию смотрите в примере документа.

5.3. Декодирование как x-www-form-urlencoded для изменения​

Подробную документацию смотрите в примере документа.

5.4. Декодирование как multipart/form-data для изменения​

Подробную документацию смотрите в примере документа.

6. Замена Body для «HTTP»​

Прямая замена раздела Body до отправки запроса приложением на сервер и до возврата данных сервера приложению.

7. Переписывание Code для «HTTP»​

Hodor может изменять коды состояния HTTP, а также перенаправлять через коды HTTP-ответов, выбирая из 301, 302, 307, 308 с настраиваемым адресом перенаправления.

8. Мокирование для «HTTP»​

В основном используется для возврата определенного контента на конкретный запрос; можно считать это локальным HTTP-сервером, возвращающим предустановленный контент для совпадающих запросов.

9. Изменение данных для «TCP&WebSocket»​

Преобразуйте восходящий и нисходящий поток данных TCP или WebSocket в строку или hex16, затем используйте регулярные выражения для изменения этих данных. Подробную документацию смотрите в примере документа.