模擬您自己的應用程式隨機錯誤

在本教學課程中，您將瞭解如何使用 Dev Proxy 來模擬您自己的應用程式隨機錯誤。

必要條件

本教學課程的這個部分假設您已在計算機上安裝及設定開發 Proxy。 如果沒有， 請立即這麼做。

若要遵循本教學課程，您需要呼叫 API 的應用程式。 您也需要知道應用程式所呼叫之 API 的 URL。

您可以使用 Dev Proxy 搭配任何類型的應用程式和技術堆疊。 以下是如何使用一些熱門技術來設定開發 Proxy 的指示。

JavaScript

搭配下列方式使用 Dev Proxy：

• Node.js 應用程式
• 在 Docker 中Node.js 應用程式
• JavaScript Azure Functions
• SharePoint 架構 (SPFx) 解決方案

.NET

搭配下列方式使用 Dev Proxy：

• .NET 應用程式
• Docker 中的 .NET 應用程式
• .NET Aspire 應用程式

如果您使用開發 Proxy 搭配 .NET 4.8 應用程式，則必須使用 netsh在系統上註冊 Dev Proxy。

其他

如果您想要搭配用戶端應用程式使用Dev Proxy，通常不需要採取任何額外的步驟。 啟動 Dev Proxy 之後，它會自動攔截來自您電腦的所有要求。

如果您想要將 Dev Proxy 與以此處未列出的技術所建置的伺服器端應用程式搭配使用，您可能需要採取額外的步驟來設定應用程式以使用 Dev Proxy。 請查看技術的文件，瞭解如何將其設定為使用網路 Proxy。 如果您有任何問題，請在 Discord 上的 開發人員 Proxy 社群 中尋求協助。

啟動開發 Proxy 以監視URL

啟動開發 Proxy，並監視應用程式所呼叫之 API 的 URL。 例如，如果您的應用程式呼叫位於的 https://api.contoso.com/v1/customersAPI，請啟動 Dev Proxy 並監視 URL 模式 https://api.contoso.com/*。

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

參數 --urls-to-watch 會告知 Dev Proxy，這是要攔截的要求。 URL 結尾的通配符 * 會告訴 Dev Proxy 攔截開頭為 https://api.contoso.com/的 URL 的所有要求。

像平常一樣開始使用您的應用程式。 Dev Proxy 會攔截您指定之 URL 的所有要求。 在命令提示字元中，您會看到有關開發 Proxy 攔截之要求的訊息。

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

重要

如果您在命令提示字元中看不到任何訊息，請確定您已正確將應用程式設定為使用 Dev Proxy。 此外，請檢查開發 Proxy 是否攔截應用程式所使用的 API URL 要求。 如果您有任何問題，請在 Discord 上的 開發人員 Proxy 社群 中尋求協助。

建立您自己的組態檔

根據預設，Dev Proxy 會使用 devproxyrc.json Dev Proxy 安裝資料夾中的檔案進行其組態設定。 檔案已設定為模擬 JSON 佔位元 API 的隨機錯誤。 若要取得更實際的結果，請建立您自己的組態檔，其中包含與應用程式及其使用之 API 更相關的錯誤，並將它們與開發 Proxy 搭配使用。

讓我們考慮要將組態檔儲存在應用程式的項目資料夾中，以便與小組的其餘部分共用組態設定。

1. 在 [開發人員 Proxy 安裝] 資料夾中，複製 devproxyrc.json 與 devproxy-errors.json。
2. 在您的項目資料夾中，貼上檔案。

使用儲存在開發 Proxy 安裝檔案外部的組態檔時，您必須確定 pluginPath 參考正確無誤。 您可以使用路徑開頭的 ，將路徑硬式編碼成組態檔中的 Dev Proxy 安裝資料夾， ~appFolder 以包含動態參考回 Dev Proxy 安裝資料夾。

1. 在文字編輯器中開啟 devproxyrc.json 檔案。
2. GenericRandomErrorPlugin在數位中plugins找出外掛程式。
3. pluginPath更新為 ~appFolder/plugins/dev-proxy-plugins.dll。
4. RetryAfterPlugin在數位中plugins找出外掛程式。
5. pluginPath更新為 ~appFolder/plugins/dev-proxy-plugins.dll。
6. 在命令提示字元中，將工作目錄變更為項目資料夾。
7. 輸入 devproxy --config-file devproxyrc.json ，然後按 Enter 以使用您的組態檔啟動 Dev Proxy。
8. 從命令行將要求傳送至 JSON 佔位元 API，並檢視輸出。
9. 按 Ctrl + C 以安全地停止開發 Proxy。

提示

安裝適用於 Visual Studio Code 的 Dev Proxy Toolkit 擴充功能，可讓您輕鬆地建立和更新組態檔。

後續步驟

Dev Proxy 支援許多不同的案例，可協助您建置更強大的應用程式。 探索操作指南，瞭解如何使用不同的 Dev Proxy 功能並改善您的應用程式。

探索操作指南