Freigeben über

Simulieren zufälliger Fehler für Ihre eigene Anwendung

  • Artikel

In diesem Tutorial erfahren Sie, wie Sie den Dev-Proxy verwenden, um zufällige Fehler für Ihre eigene Anwendung zu simulieren.

Voraussetzungen

In diesem Teil des Tutorials wird davon ausgegangen, dass Sie den Dev Proxy auf Ihrem Computer installiert und konfiguriert haben. Wenn nicht, tun Sie dies jetzt.

Um dieses Tutorial zu befolgen, benötigen Sie eine Anwendung, die APIs aufruft. Außerdem müssen Sie die URLs der APIs kennen, die Ihre Anwendung aufruft.

Sie können den Dev Proxy mit jedem Anwendungs- und Technologiestapel verwenden. Hier finden Sie Anweisungen zum Einrichten des Dev-Proxys mit einigen beliebten Technologien.

Verwenden Sie den Dev-Proxy mit:

Starten des Dev-Proxys mit Überwachung Ihrer URLs

Starten Sie den Dev Proxy, und überwachen Sie die URLs der APIs, die Ihre Anwendung aufruft. Wenn Ihre Anwendung beispielsweise eine API aufruft, die sich unter https://api.contoso.com/v1/customersbefindet, starten Sie den Dev-Proxy, und überwachen Sie das URL-Muster https://api.contoso.com/*.

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

Der --urls-to-watch Parameter teilt Dev Proxy mit, welche Anforderungen abgefangen werden sollen. Der Platzhalter * am Ende der URL weist den Dev Proxy an, alle Anforderungen an URLs abzufangen, die mit https://api.contoso.com/beginnen.

Beginnen Sie mit der Verwendung Ihrer Anwendung wie gewohnt. Der Dev-Proxy fängt alle Anforderungen an die von Ihnen angegebenen URLs ab. In der Eingabeaufforderung werden Meldungen zu den Anforderungen angezeigt, die der Dev Proxy abfängt.

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

Wichtig

Wenn an der Eingabeaufforderung keine Meldungen angezeigt werden, stellen Sie sicher, dass Sie Ihre Anwendung ordnungsgemäß für die Verwendung des Dev-Proxys konfiguriert haben. Überprüfen Sie außerdem, ob der Dev Proxy Anforderungen an API-URLs abfängt, die Ihre Anwendung verwendet. Wenn Sie Fragen haben, bitten Sie die Dev Proxy-Community auf Discord um Hilfe.

Erstellen eigener Konfigurationsdateien

Standardmäßig verwendet Dev Proxy die devproxyrc.json Datei im Installationsordner Dev Proxy für die Konfigurationseinstellungen. Die Datei ist so konfiguriert, dass zufällige Fehler für die JSON-Platzhalter-API simuliert werden. Um realistischere Ergebnisse zu erhalten, erstellen Sie Ihre eigenen Konfigurationsdateien mit Fehlern, die für Ihre Anwendung und die verwendeten APIs relevanter sind, und verwenden Sie sie mit dem Dev-Proxy.

Betrachten wir, dass Sie eine Konfigurationsdatei im Projektordner für Ihre App speichern möchten, damit Sie die Konfigurationseinstellungen für den Rest Ihres Teams freigeben können.

  1. Kopieren Sie devproxyrc.json im Installationsordner Dev Proxy und devproxy-errors.json.
  2. Fügen Sie die Dateien in Ihren Projektordner ein.

Wenn Sie eine Konfigurationsdatei verwenden, die außerhalb der Dev Proxy-Installationsdatei gespeichert ist, müssen Sie sicherstellen, dass die pluginPath Verweise korrekt sind. Anstatt die Pfade zum Dev Proxy-Installationsordner in Ihrer Konfigurationsdatei hart zu codieren, können Sie den ~appFolder am Anfang des Pfads verwenden, um einen dynamischen Verweis zurück auf den Installationsordner dev Proxy aufzunehmen.

  1. Öffnen Sie in einem Text-Editor die Datei devproxyrc.json.
  2. Suchen Sie das GenericRandomErrorPlugin Plug-In im plugins Array.
  3. Aktualisieren Sie den pluginPath auf ~appFolder/plugins/dev-proxy-plugins.dll.
  4. Suchen Sie das RetryAfterPlugin Plug-In im plugins Array.
  5. Aktualisieren Sie den pluginPath auf ~appFolder/plugins/dev-proxy-plugins.dll.
  6. Ändern Sie an einer Eingabeaufforderung das Arbeitsverzeichnis in Ihren Projektordner.
  7. Geben Sie ein devproxy --config-file devproxyrc.json , und drücken Sie die EINGABETASTE , um den Dev Proxy mit Ihrer Konfigurationsdatei zu starten.
  8. Senden Sie eine Anforderung an die JSON-Platzhalter-API über die Befehlszeile, und zeigen Sie die Ausgabe an.
  9. Drücken Sie STRG + C , um den Dev-Proxy sicher zu beenden.

Tipp

Installieren Sie die Dev Proxy Toolkit-Erweiterung für Visual Studio Code, die das Erstellen und Aktualisieren von Konfigurationsdateien vereinfacht.

Nächster Schritt

Dev Proxy unterstützt viele verschiedene Szenarien, mit denen Sie robustere Anwendungen erstellen können. Sehen Sie sich die Anleitungen an, um zu erfahren, wie Sie die verschiedenen Dev Proxy-Features verwenden und Ihre Anwendung verbessern können.

Anleitungen erkunden