为自己的应用程序模拟随机错误

  • 项目

本教程介绍如何使用开发代理为自己的应用程序模拟随机错误。

先决条件

本教程的这一部分假定你在计算机上安装并配置了开发代理。 如果没有， 请立即执行此操作。

若要遵循本教程，需要一个调用 API 的应用程序。 还需要知道应用程序调用的 API 的 URL。

可以将开发代理与任何类型的应用程序和技术堆栈一起使用。 下面是有关如何使用一些常用技术设置开发代理的说明。

将开发代理用于：

通过监视 URL 启动开发代理

启动开发代理并监视应用程序调用的 API 的 URL。 例如，如果应用程序调用 位于 的 https://api.contoso.com/v1/customersAPI，请启动开发代理并监视 URL 模式 https://api.contoso.com/*。

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

参数 --urls-to-watch 告知开发代理要截获的请求。 URL 末尾的通配符 * 指示开发代理截获以 开头 https://api.contoso.com/的 URL 的所有请求。

开始像平时一样使用应用程序。 开发代理会截获对指定 URL 的所有请求。 在命令提示符中，可以看到有关开发人员代理截获的请求的消息。

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

重要

如果在命令提示符中看不到任何消息，请确保将应用程序正确配置为使用开发代理。 此外，检查开发代理是否截获应用程序使用的 API URL 的请求。 如果有任何疑问，请在 Discord 上的开发代理社区 中寻求帮助。

创建自己的配置文件

默认情况下，开发代理使用 devproxyrc.json Dev 代理安装文件夹中的 文件进行其配置设置。 该文件配置为模拟 JSON 占位符 API 的随机错误。 若要获得更真实的结果，请创建自己的配置文件，其中包含与应用程序和它使用的 API 更相关的错误，并将其与开发代理一起使用。

假设你要将配置文件存储在应用的项目文件夹中，以便可以与团队的其他成员共享配置设置。

  1. 在“开发代理安装”文件夹中，复制 devproxyrc.json 和 devproxy-errors.json。
  2. 在项目文件夹中，粘贴文件。

使用存储在开发代理安装文件外部的配置文件时，需要确保 pluginPath 引用正确。 可以使用 ~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 以使用配置文件启动开发代理。
  8. 从命令行向 JSON 占位符 API 发送请求并查看输出。
  9. 按 Ctrl + C 安全地停止开发代理。

提示

安装适用于 Visual Studio Code 的 Dev Proxy Toolkit 扩展，以便轻松创建和更新配置文件。

后续步骤

开发代理支持许多不同的方案，可帮助你构建更可靠的应用程序。 浏览操作指南，了解如何使用不同的开发代理功能和改进应用程序。

浏览操作指南