Simulace náhodných chyb pro vlastní aplikaci

V tomto kurzu se naučíte, jak pomocí dev proxy simulovat náhodné chyby pro vlastní aplikaci.

Požadavky

V této části kurzu se předpokládá, že jste na počítači nainstalovali a nakonfigurovali Dev Proxy. Pokud ne, udělejte to nyní.

Pokud chcete 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 aplikačního a technologického zásobníku. Tady jsou pokyny, jak nastavit Dev Proxy s několika oblíbenými technologiemi.

JavaScriptu

Použijte Dev Proxy s:

• Node.js aplikace
• Node.js aplikace v Dockeru
• JavaScript Azure Functions
• Řešení SharePoint Framework (SPFx)

.NET

Použijte Dev Proxy s:

• aplikace .NET
• aplikace .NET v prostředí Dockeru
• aplikace .NET Aspire

Pokud používáte Dev Proxy s aplikací .NET 4.8, musíte zaregistrovat Dev Proxy v systému pomocí netsh.

Jiné

Pokud chcete používat dev proxy server s aplikací na straně klienta, obvykle nemusíte provádět žádné další kroky. Jakmile spustíte Dev Proxy, automaticky zachytí všechny požadavky z vašeho počítače.

Pokud chcete používat Dev Proxy s aplikací na straně serveru sestavenou s technologií, která tu není uvedená, možná budete muset provést další kroky ke konfiguraci aplikace pro použití dev proxy serveru. V dokumentaci pro vaši technologii se dozvíte, jak ji nakonfigurovat tak, aby používala síťový proxy server. Pokud máte nějaké dotazy, požádejte o pomoc v komunitě Dev Proxy na Discordu.

Spuštění dev proxy serveru s monitorováním adres URL

Spusťte Dev Proxy a monitorujte adresy URL rozhraní API, která vaše aplikace volá. Pokud vaše aplikace například volá rozhraní API umístěné v https://api.contoso.com/v1/customers, spusťte Dev Proxy a sledujte vzor adresy URL https://api.contoso.com/*.

devproxy --urls-to-watch "https://api.contoso.com/*"

Parametr --urls-to-watch sděluje Dev Proxy, které požadavky se mají zachytit. Zástupný znak * na konci adresy URL říká dev proxy serveru, aby zachytil všechny požadavky na adresy URL, které začínají https://api.contoso.com/.

Začněte používat aplikaci stejně, jako byste to normálně používali. Dev Proxy zachytí všechny požadavky na adresy URL, které jste zadali. Na příkazovém řádku se zobrazí zprávy o požadavcích, které dev proxy zachytí.

```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 na příkazovém řádku nevidíte žádné zprávy, ujistěte se, že jste aplikaci správně nakonfigurovali tak, aby používala dev proxy server. Zkontrolujte také, jestli dev proxy zachycuje požadavky na adresy URL rozhraní API, které vaše aplikace používá. 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 soubor v instalační složce Dev Proxy. Soubor je nakonfigurovaný tak, aby simuloval náhodné chyby pro zástupné rozhraní API JSON. Pokud chcete získat realističtější výsledky, vytvořte vlastní konfigurační soubory s chybami, které jsou pro vaši aplikaci relevantnější, a rozhraní API, která používá, a použijte je s dev proxy serverem.

Předpokládejme, že chcete uložit konfigurační soubor do složky projektu pro vaši aplikaci, abyste mohli nastavení konfigurace sdílet se zbytkem týmu.

1. V instalační složce Dev Proxy zkopírujte devproxyrc.json a devproxy-errors.json.
2. Do složky projektu vložte soubory.

Pokud používáte konfigurační soubor, který je uložený mimo instalační soubor dev proxy, musíte zajistit správnost pluginPath odkazů. Místo pevného kódování cest k instalační složce dev proxy v konfiguračním souboru můžete použít ~appFolder na začátku cesty a zahrnout dynamický odkaz zpět do instalační složky Dev Proxy.

1. V textovém editoru otevřete soubor devproxyrc.json.
2. Vyhledejte plugin GenericRandomErrorPlugin v poli plugins.
3. Aktualizujte pluginPath na ~appFolder/plugins/DevProxy.Plugins.dll.
4. Vyhledejte plugin RetryAfterPlugin v poli plugins.
5. Aktualizujte pluginPath na ~appFolder/plugins/DevProxy.Plugins.dll.
6. Na příkazovém řádku změňte pracovní adresář na složku projektu.
7. Zadejte devproxy --config-file devproxyrc.json a stisknutím klávesy Enter spusťte vývojový proxy server pomocí konfiguračního souboru.
8. Odešlete požadavek do zástupného rozhraní API JSON z příkazového řádku a zobrazte výstup.
9. Stisknutím kláves Ctrl + C bezpečně zastavíte dev proxy server.

Spropitné

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 sestavovat robustnější aplikace. Projděte si průvodce postupy, ve které se dozvíte, jak používat různé funkce dev proxy serveru a jak vylepšit aplikaci.

Prozkoumej návody