Simulace náhodných chyb pro vaši vlastní aplikaci
V tomto kurzu zjistíte, jak pomocí vývojového proxy serveru simulovat náhodné chyby pro vaši vlastní aplikaci.
Požadavky
V této části kurzu se předpokládá, že jste na počítači nainstalovali a nakonfigurovali dev proxy server. Pokud ne, udělejte to teď.
Abyste mohli postupovat podle tohoto kurzu, potřebujete aplikaci, která volá rozhraní API. Potřebujete také znát adresy URL rozhraní API, která vaše aplikace volá.
Dev Proxy můžete použít s libovolným typem zásobníku aplikací a technologií. Tady jsou pokyny, jak nastavit proxy pro vývojáře s několika oblíbenými technologiemi.
Použití vývojového proxy serveru s:
Spuštění vývojového proxy serveru s monitorováním adres URL
Spusťte dev Proxy a monitorujte adresy URL rozhraní API, která volá vaše aplikace. Pokud například vaše aplikace volá rozhraní API umístěné na adrese https://api.contoso.com/v1/customers
, spusťte dev proxy a monitorujte vzor https://api.contoso.com/*
adresy URL .
devproxy --urls-to-watch "https://api.contoso.com/*"
Parametr --urls-to-watch
sděluje dev proxy serveru, které požadavky se mají zachytit. Zástupný znak *
na konci adresy URL říká proxy serveru pro vývojáře, aby zachytá všechny požadavky na adresy URL, které začínají na https://api.contoso.com/
.
Začněte aplikaci používat obvyklým způsobem. Dev Proxy zachytává všechny požadavky na adresy URL, které jste zadali. Na příkazovém řádku se zobrazí zprávy o požadavcích, které proxy vývojářů zachycuje.
```text
request GET https://api.contoso.com/v1/customers
api ╭ Passed through
╰ GET https://api.contoso.com/v1/customers
request GET https://api.contoso.com/v1/customers
chaos ╭ 403 Forbidden
╰ GET https://api.contoso.com/v1/customers
Důležité
Pokud se na příkazovém řádku nezobrazují žádné zprávy, ujistěte se, že jste aplikaci správně nakonfigurovali tak, aby používala dev proxy. Zkontrolujte také, jestli dev proxy zachytává požadavky na adresy URL rozhraní API, které používá vaše aplikace. Pokud máte nějaké dotazy, požádejte o pomoc v komunitě dev proxy na Discordu.
Vytvoření vlastních konfiguračních souborů
Dev Proxy ve výchozím nastavení používá devproxyrc.json
pro nastavení konfigurace soubor v instalační složce dev proxy. Soubor je nakonfigurovaný tak, aby simuloval náhodné chyby pro rozhraní API pro zástupný symbol JSON. Pokud chcete získat realističtější výsledky, vytvořte vlastní konfigurační soubory s chybami, které jsou relevantnější pro vaši aplikaci a rozhraní API, která používá, a použijte je s vývojovým proxy serverem.
Představte si, že chcete konfigurační soubor uložit do složky projektu vaší aplikace, abyste mohli sdílet nastavení konfigurace se zbytkem týmu.
- V instalační složce dev proxy zkopírujte
devproxyrc.json
adevproxy-errors.json
. - Do složky projektu vložte soubory.
Při použití konfiguračního souboru, který je uložený mimo instalační soubor vývojového proxy serveru, je potřeba zajistit, aby odkazy byly pluginPath
správné. Místo pevného kódování cest k instalační složce vývojového proxy serveru v konfiguračním souboru můžete použít ~appFolder
na začátku cesty dynamický odkaz zpět na instalační složku vývojového proxy serveru.
- V textovém editoru
devproxyrc.json
otevřete soubor . - Vyhledejte modul plug-in
GenericRandomErrorPlugin
v poliplugins
. - Aktualizujte na
pluginPath
~appFolder/plugins/dev-proxy-plugins.dll
. - Vyhledejte modul plug-in
RetryAfterPlugin
v poliplugins
. - Aktualizujte na
pluginPath
~appFolder/plugins/dev-proxy-plugins.dll
. - V příkazovém řádku změňte pracovní adresář na složku projektu.
- Zadejte
devproxy --config-file devproxyrc.json
a stisknutím klávesy Enter spusťte proxy pro vývoj pomocí konfiguračního souboru. - Z příkazového řádku odešlete požadavek do rozhraní API pro zástupné symboly JSON a zobrazte výstup.
- Stisknutím ctrl + C bezpečně zastavte Dev Proxy.
Tip
Nainstalujte rozšíření Dev Proxy Toolkit pro Visual Studio Code, které usnadňuje vytváření a aktualizaci konfiguračních souborů.
Další krok
Dev Proxy podporuje mnoho různých scénářů, které vám pomůžou vytvářet robustnější aplikace. Projděte si návody, abyste se dozvěděli, jak používat různé funkce vývojového proxy serveru a vylepšovat svou aplikaci.