Simulieren Sie zufällige Fehler für Ihre eigene Anwendung

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

Voraussetzungen

In diesem Teil des Lernprogramms wird davon ausgegangen, dass Sie Dev Proxy auf Ihrem Computer installiert und konfiguriert haben. Wenn nicht, dann machen Sie das jetzt.

Um diesem Lernprogramm zu folgen, 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 Dev Proxy mit jedem Anwendungs- und Technologiestapel verwenden. Hier finden Sie Anweisungen zum Einrichten von Dev Proxy mit einigen gängigen Technologien.

JavaScript

Verwenden Sie Dev Proxy mit:

• Node.js-Anwendungen
• Node.js Anwendungen in Docker
• JavaScript-Azure-Funktionen
• SharePoint-Framework(SPFx)-Lösungen

.NETTO

Verwenden Sie Dev Proxy mit:

• .NET-Anwendungen
• .NET-Anwendungen in Docker
• .NET Aspire-Anwendungen

Wenn Sie Dev Proxy mit einer .NET 4.8-App verwenden, müssen Sie Dev Proxy auf Ihrem System mithilfe netshvon .NET 4.8 registrieren.

Andere

Wenn Sie Dev Proxy mit einer clientseitigen Anwendung verwenden möchten, müssen Sie in der Regel keine zusätzlichen Schritte ausführen. Nachdem Sie Dev Proxy gestartet haben, werden automatisch alle Anforderungen von Ihrem Rechner abgefangen.

Wenn Sie Dev Proxy mit einer serverseitigen Anwendung verwenden möchten, die mit einer hier nicht aufgeführten Technologie erstellt wurde, müssen Sie möglicherweise zusätzliche Schritte ausführen, um Ihre Anwendung für die Verwendung von Dev Proxy zu konfigurieren. Lesen Sie die Dokumentation für Ihre Technologie, um zu erfahren, wie Sie sie für die Verwendung eines Netzwerkproxys konfigurieren. Wenn Sie Fragen haben, bitten Sie in der Dev Proxy-Community unter Discord um Hilfe.

Starten sie Dev Proxy mit der Überwachung Ihrer URLs

Starten Sie Dev Proxy, und überwachen Sie die URLs der APIs, die Ihre Anwendung aufruft. Wenn Ihre Anwendung z. B. eine API https://api.contoso.com/v1/customersaufruft, starten Sie 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 weist Dev Proxy an, welche Anforderungen abgefangen werden sollen. Der Platzhalter * am Ende der URL weist Dev Proxy an, alle Anforderungen zu URLs abzufangen, die mit https://api.contoso.com/ beginnen.

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

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

Von Bedeutung

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

Erstellen eigener Konfigurationsdateien

Standardmäßig verwendet Dev Proxy die devproxyrc.json Datei im Dev Proxy-Installationsordner 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 erzielen, erstellen Sie eigene Konfigurationsdateien mit Fehlern, die für Ihre Anwendung und die verwendeten APIs relevanter sind, und verwenden Sie sie mit 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 und devproxy-errors.json im Installationsordner von Dev Proxy.
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 zu Beginn des Pfads ~appFolder verwenden, um einen dynamischen Verweis zurück zum Dev Proxy-Installationsordner einzufügen.

1. Öffnen Sie die devproxyrc.json Datei in einem Text-Editor.
2. Suchen Sie das GenericRandomErrorPlugin Plug-In im plugins Array.
3. Aktualisieren Sie pluginPath zu ~appFolder/plugins/DevProxy.Plugins.dll.
4. Suchen Sie das RetryAfterPlugin Plug-In im plugins Array.
5. Aktualisieren Sie pluginPath auf ~appFolder/plugins/DevProxy.Plugins.dll.
6. Ändern Sie das Arbeitsverzeichnis an einer Eingabeaufforderung in Ihren Projektordner.
7. Geben Sie devproxy --config-file devproxyrc.json ein und drücken Sie die EINGABETASTE, um 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 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, die Ihnen helfen, robustere Anwendungen zu erstellen. In den Anleitungen erfahren Sie, wie Sie die verschiedenen Dev Proxy-Features verwenden und Ihre Anwendung verbessern können.

So geht's: Anleitungen erkunden