Перейти до основного вмісту

Правила перезапису

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

Rewrite Debug підтримує перезапис для HTTP(S), WebSocket, TCP та UDP. Можна перенаправляти запити, перезаписувати path/query/headers/body або імітувати відповіді (mock) для кожного протоколу — подробиці про бінарні потоки дивіться в TCP або WebSocket зміна.

1. Перенаправлення запитів для "HTTP&WebSocket&TCP"​

Перенаправлення використовується для зміни цільової адреси та порту запиту, а також може визначати, чи застосовувати шифрування SSL/TLS. Це правило особливо корисне під час тестування при частих перемиканнях між адресами тестового та робочого серверів.

2. Перезапис шляхів для "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. Перезапис заголовків для "HTTP&WebSocket"​

HTTP Headers — набір пар ключ-значення. Можна додавати або вилучати значення з HTTP Header. Але для полів на кшталт Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding є особливі застереження: ними керує система, і вручну заповнені значення будуть недійсними. Якщо вказано Content-Type, він перекриє системне налаштування mime-type.

5. Зміна тіла для "HTTP"​

HTTP Body може передавати дані в різних форматах кодування. Hodor підтримує декодування даних у чотири формати (text, JSON, x-www-form-urlencoded, multipart/form-data) та їх зміну як пар ключ-значення. Альтернативно можна динамічно замінити весь розділ тіла заздалегідь підготовленими даними.

5.1. Декодування як text і зміна регулярними виразами​

Детальну документацію дивіться в прикладі документації.

5.2. Декодування як JSON і зміна​

Детальну документацію дивіться в прикладі документації.

5.3. Декодування як x-www-form-urlencoded і зміна​

Детальну документацію дивіться в прикладі документації.

5.4. Декодування як multipart/form-data і зміна​

Детальну документацію дивіться в прикладі документації.

6. Заміна тіла для "HTTP"​

Безпосередньо замінюйте розділ тіла до надсилання запиту застосунком на сервер і до повернення даних сервера застосунку.

7. Перезапис коду для "HTTP"​

Hodor може змінювати коди стану HTTP, а також перенаправляти через коди відповідей HTTP, обираючи з 301, 302, 307, 308 з налаштовуваною адресою перенаправлення.

8. Імітація (Mock) для "HTTP"​

Використовується переважно для повернення конкретного вмісту для певного запиту; можна уявити це як локальний HTTP-сервер, що повертає попередньо заданий вміст для збігних запитів.

9. Зміна даних для "TCP&WebSocket"​

Перетворіть потік даних TCP або WebSocket вгору/вниз на рядок або hex16, а потім змінюйте ці дані регулярними виразами. Детальну документацію дивіться в прикладі документації.