Apifox 帮助文档
帮助文档
常见问题
IDEA 插件
更新日志
Road Map
开放 API
私有化部署
Apifox 官网
下载
Apifox 帮助文档

    logoPowered by Apifox

    新建测试场景

    在自动化测试中，测试场景是最基本的单元，类似于 Postman 中的集合 （Collection）。当你需要连续发送多个请求、构建一系列的测试流程，或使用不同的测试数据重复请求时，可以创建一个测试场景，并向其中添加所需的接口或接口用例。

    使用 Apifox 的测试场景功能，可以轻松满足各种 API 测试需求：

    1. 按顺序发起请求

      按指定顺序组织并执行多个请求，模拟用户操作或业务流程。

    2. 测试报告

      自动生成详细报告，清晰展示断言结果和每个请求的执行情况。

    3. CI/CD 集成

      将测试场景集成到 CI/CD 流水线中，实现自动化测试，帮助在开发过程中及时发现问题。

    4. 性能测试

      在不同负载条件下评估 API 性能，生成趋势分析，揭示响应行为随时间变化的规律。

    5. 动态参数测试

      使用动态生成的参数多次执行请求，测试 API 如何处理不同的输入。

    6. 读取前置步骤数据

      利用前置步骤的数据发送请求，模拟真实操作场景，验证 API 响应是否符合预期。

    7. 测试步骤间数据传递

      自动将一个测试步骤的输出传递给下一个步骤，确保数据流畅传递。

    8. 根据逻辑编排测试步骤

      配置 if、for 和 foreach 等逻辑条件，根据前一步的结果或特定条件控制测试流程。

    这些功能帮助你搭建灵活且高效的测试环境，确保 API 稳定可靠、高质量地运行。

    新建测试场景

    在项目中点击左侧菜单栏中的 “自动化测试”，点击搜索栏右侧的 + 号按钮，选择所归属的目录与设置优先级后完成创建。

    CleanShot 2024-12-05 at 14.51.23@2x.png

    若希望调整测试场景的所在目录，可以在创建测试场景时点击 “目录” 中的 “新建目录” 按钮或选择已有目录进行调整。

    <img src="https://api.apifox.com/api/v1/projects/5097254/resources/481579/image-preview" style="width: 340px" />

    你也可以给测试场景设置标签，在左上角的搜索框中通过标签来搜索测试场景。

    <img src="https://api.apifox.com/api/v1/projects/5097254/resources/481581/image-preview" style="width: 340px" />

    在测试场景中添加测试步骤

    创建测试场景后可以在其中添加测试步骤。测试步骤中支持导入接口、接口用例、自定义请求和从 cURL 导入接口，并且你还可以在步骤中设置测试条件等附加操作。

    进入测试场景后，点击 “添加步骤” 并添加接口。你可以选择 “从接口导入” 和 “从接口用例导入”。

    image.png

    从接口导入

    你可以从当前项目中导入接口作为测试场景的步骤。导入接口时有两种同步模式：“手动同步” 和 “自动同步”。具体说明请参阅从接口/用例同步数据。

    • 手动同步

      在此模式下，项目内的 “接口文档” 发生数据变化时，测试步骤中的接口数据不会自动更新。只有当测试人员点击 “手动同步” 按钮时，测试步骤中的接口数据才会与接口文档中的数据同步。如果测试步骤中的接口数据发生了变化，点击 “手动同步” 按钮后，数据不会同步回接口文档，而是重新抓取接口文档中的数据并与之同步。

    • 自动同步

      在此模式下，当项目内的 “接口文档” 数据发生变化时，测试步骤中的接口数据将自动更新。

      image.png

    如果你需要在一个测试场景中测试其它项目的接口，可以参考跨项目导入接口/用例。

    从接口用例导入

    你可以选择从当前项目或其他项目导入接口用例。导入接口用例时有两种模式：分别是 “复制” 和 “引用” 模式。

    • 复制

      以 “复制” 方式导入接口用例时，接口用例中的参数也会一并复制到测试步骤中，且与原项目内的接口用例数据相互独立。两者的改动互不影响。

    • 引用

      以 “引用” 方式导入接口用例时，将直接使用原项目内的接口用例进行请求。

      image.png

      如果是从接口用例引用的测试步骤，点击进入这个步骤后，会显示一个明确的提示。这个提示会告知你：修改当前步骤的内容不仅会影响原始的接口用例，还会同时影响所有引用了该接口用例的其他测试步骤。

      image.png

    添加自定义请求

    在业务流程中，可能会遇到需要调用外部项目接口的情况，例如调用第三方支付接口。你可以在测试步骤中添加自定义请求，自定义请求可以是任意 HTTP 请求类型，包括常见的 GET、POST、PUT、DELETE 等。

    image.png

    从 cURL 导入

    在实际业务流程中，许多 API 请求以 cURL 命令行的形式呈现。你可以将 cURL 请求一键导入到测试步骤中。

    image.png

    流程控制条件

    你可以在测试场景中新增流程控制条件 （如分组、条件分支、ForEach 循环、For 循环和等待时间），以应对更复杂的测试场景和流程配置需求，最终通过自动化测试功能解决复杂场景的测试工作。

    image.png

    从其它测试场景导入

    你可以将当前项目中其他测试场景的测试步骤或流程控制条件复制导入到当前测试场景。

    image.png

    引用其它测试场景

    你可以在测试场景中引用其他测试场景，将其作为一个测试步骤。以下是该功能的适用场景：

    1. 当业务流程中有一些公共且可复用的步骤时，可以将这些步骤组合成一个小型测试场景，然后在其他较大的测试场景中直接引用。

    2. 如果需要执行全产品的主流程回归测试，可以在一个测试场景中引用各个子测试场景进行组装，从而实现一键测试全部主流程，完成回归工作。

      image.png

    :::caution[]
    为防止出现无限循环或测试场景无法正常停止的情况，该功能不可引用当前测试场景本身。
    :::

    编排测试场景

    点击任意测试步骤即可进入编排模式。在该模式下，你将拥有更大的操作页面 （点击左上角的放大图标可将页面方放大），便于更高效地填写每个测试步骤的详细内容。页面左侧显示测试场景的整体流程，右侧显示选中测试步骤的详细信息。接口请求和流程组件将根据其类型展示不同的详情。

    你可以在此模式中使用“⬆️”“⬇️”按键来快速切换选中的测试步骤。

    image.png

    在编排模式中，你可以同时编辑多个步骤，并通过点击左上角的 “全部保存” 按钮一次性保存所有步骤的详细信息。如果某个步骤的详细内容未保存，该步骤将在左侧列表中标记一个小圆点。请务必注意并及时保存已填写的内容。

    最后修改时间： 1 个月前