Symulowanie losowych błędów dla własnej aplikacji

Z tego samouczka dowiesz się, jak używać serwera proxy deweloperów do symulowania losowych błędów dla własnej aplikacji.

Wymagania wstępne

W tej części samouczka założono, że na maszynie zainstalowano i skonfigurowano serwer proxy deweloperów. Jeśli nie, zrób to teraz.

Do wykonania kroków tego samouczka potrzebna jest aplikacja, która wywołuje interfejsy API. Musisz również znać adresy URL interfejsów API wywoływanych przez aplikację.

Serwer proxy deweloperów można używać z dowolnym typem aplikacji i stosu technologii. Poniżej przedstawiono instrukcje dotyczące konfigurowania serwera proxy deweloperów za pomocą kilku popularnych technologii.

JavaScript

Używanie serwera proxy deweloperów z:

• aplikacjeNode.js
• Node.js aplikacji na platformie Docker
• Azure Functions JavaScript
• rozwiązania SharePoint Framework (SPFx)

.NET

Używanie serwera proxy deweloperów z:

• Aplikacje .NET
• Aplikacje .NET na platformie Docker
• Aplikacje .NET Aspire

Jeśli używasz serwera proxy deweloperskiego z aplikacją .NET 4.8, musisz zarejestrować serwer proxy deweloperów w systemie przy użyciu polecenia netsh.

Inne

Jeśli chcesz używać serwera proxy deweloperów z aplikacją po stronie klienta, zazwyczaj nie musisz wykonywać żadnych dodatkowych kroków. Po uruchomieniu serwera proxy deweloperów program automatycznie przechwytuje wszystkie żądania z twojej maszyny.

Jeśli chcesz używać serwera proxy deweloperskiego z aplikacją po stronie serwera utworzoną z technologią, która nie została wymieniona w tym miejscu, może być konieczne wykonanie dodatkowych kroków w celu skonfigurowania aplikacji do korzystania z serwera proxy deweloperów. Zapoznaj się z dokumentacją dotyczącą technologii, aby dowiedzieć się, jak skonfigurować ją do korzystania z serwera proxy sieci. Jeśli masz jakiekolwiek pytania, poproś o pomoc w społeczności serwera proxy deweloperów w witrynie Discord.

Uruchamianie usługi Dev Proxy z monitorowaniem adresów URL

Uruchom usługę Dev Proxy i monitoruj adresy URL interfejsów API wywoływanych przez aplikację. Jeśli na przykład aplikacja wywołuje interfejs API znajdujący się w https://api.contoso.com/v1/customerslokalizacji , uruchom serwer proxy deweloperów i monitoruj wzorzec https://api.contoso.com/*adresu URL .

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

Parametr --urls-to-watch informuje serwer proxy dev, który żąda przechwycenia. Symbol wieloznaczny * na końcu adresu URL informuje serwer proxy dewelopera o przechwyceniu wszystkich żądań do adresów URL rozpoczynających się od https://api.contoso.com/.

Zacznij korzystać z aplikacji, jak zwykle. Serwer proxy dewelopera przechwytuje wszystkie żądania do określonych adresów URL. W wierszu polecenia są wyświetlane komunikaty dotyczące żądań przechwytujących serwer proxy deweloperów.

```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

Ważne

Jeśli w wierszu polecenia nie widzisz żadnych komunikatów, upewnij się, że aplikacja została prawidłowo skonfigurowana do korzystania z serwera proxy deweloperów. Sprawdź również, czy serwer proxy deweloperów przechwytuje żądania do adresów URL interfejsu API używanych przez aplikację. Jeśli masz jakiekolwiek pytania, poproś o pomoc w społeczności serwera proxy deweloperów w witrynie Discord.

Tworzenie własnych plików konfiguracji

Domyślnie serwer proxy deweloperów devproxyrc.json używa pliku w folderze instalacyjnym serwera proxy deweloperów na potrzeby ustawień konfiguracji. Plik jest skonfigurowany do symulowania losowych błędów dla interfejsu API symbolu zastępczego JSON. Aby uzyskać bardziej realistyczne wyniki, utwórz własne pliki konfiguracji z błędami, które są bardziej istotne dla aplikacji i używanych przez nią interfejsów API, i używaj ich z serwerem proxy deweloperów.

Rozważmy, że chcesz zapisać plik konfiguracji w folderze projektu dla aplikacji, aby udostępnić ustawienia konfiguracji pozostałej części zespołu.

1. W folderze instalacyjnym serwera proxy deweloperów skopiuj devproxyrc.json pliki i devproxy-errors.json.
2. W folderze projektu wklej pliki.

W przypadku korzystania z pliku konfiguracji przechowywanego poza plikiem instalacyjnym serwera proxy deweloperów należy upewnić się, że pluginPath odwołania są poprawne. Zamiast trwale kodować ścieżki do folderu instalacyjnego serwera Dev Proxy w pliku konfiguracji, można użyć na ~appFolder początku ścieżki, aby dołączyć dynamiczne odwołanie z powrotem do folderu instalacji serwera proxy deweloperów.

1. W edytorze tekstów otwórz devproxyrc.json plik.
2. Znajdź wtyczkę GenericRandomErrorPlugin w tablicy plugins .
3. Zaktualizuj element pluginPath na ~appFolder/plugins/dev-proxy-plugins.dll.
4. Znajdź wtyczkę RetryAfterPlugin w tablicy plugins .
5. Zaktualizuj element pluginPath na ~appFolder/plugins/dev-proxy-plugins.dll.
6. W wierszu polecenia zmień katalog roboczy na folder projektu.
7. Wprowadź devproxy --config-file devproxyrc.json i naciśnij klawisz Enter , aby uruchomić serwer proxy deweloperów przy użyciu pliku konfiguracji.
8. Wyślij żądanie do interfejsu API symbolu zastępczego JSON z wiersza polecenia i wyświetl dane wyjściowe.
9. Naciśnij klawisze Ctrl + C, aby bezpiecznie zatrzymać serwer proxy deweloperów.

Porada

Zainstaluj rozszerzenie Dev Proxy Toolkit dla Visual Studio Code co ułatwia tworzenie i aktualizowanie plików konfiguracji.

Następny krok

Serwer proxy deweloperów obsługuje wiele różnych scenariuszy, które ułatwiają tworzenie bardziej niezawodnych aplikacji. Zapoznaj się z przewodnikami z instrukcjami, aby dowiedzieć się, jak używać różnych funkcji serwera proxy deweloperów i ulepszać aplikację.

Eksplorowanie przewodników z instrukcjami