动态值表达式

动态值表达式（或称为“动态变量”）允许你在调试接口时自动生成或构造一些特定的数据，如用户名、地址等。这些动态值可以根据预定义的规则在每次发送请求时生成新的值，从而简化调试过程，并确保每个请求都包含唯一的数据。

Apifox 动态值基于 Faker.js v9.0.0-rc.1 构建，针对 API 测试工作流程进行了增强和优化。Apifox 在保留 Faker.js 强大功能的同时，为生成逼真的测试数据提供了更直观、更高效的体验。如果你已经熟悉 Faker.js，那么过渡到 Apifox 动态值将会轻而易举。

全面的动态值库

为了便于参考，Apifox 为每个动态值类别提供了带有示例的文档，其结构与 Faker.js 相同：

地点和位置

随机文本单词

Apifox 动态值的主要增强功能

以下是使 Apifox 动态值更加强大和用户友好的主要变化：

1. 简化的表达式语法，方便访问

Apifox 使用简洁直观的语法来调用动态值：

Faker.js: faker.finance.accountName()

Apifox: {{$finance.accountName}}

只需在 Apifox 中输入 {{% 即可触发自动补全，轻松浏览可用的动态值。

2. 优化的对象和数组输出 - 提高灵活性

Apifox 通过为最初在 Faker.js 中返回对象或数组的方法返回 JSON 字符串来简化数据处理，从而可以直接访问特定值：

示例 1：提取机场数据

Faker.js: faker.airline.airport() 返回一个对象：

Apifox: 直接访问特定字段：

示例 2：处理多个日期

Faker.js: faker.date.betweens() 返回一个数组：

Apifox: 返回 JSON 字符串化数组，以便于数据处理：

提示

有关调整后的方法及其参数的完整概述，请参阅 Apifox 文档。

3. 增强型区域设置控制，用于生成本地化数据

Apifox 提供了对区域设置的增强控制，以便生成特定于区域的数据：

函数级设置： 为每个动态值函数单独定义区域设置。

项目级默认值： 为整个 Apifox 项目设置默认区域设置。

日期格式覆盖： 在与日期相关的函数中使用 format 方法来应用特定于区域的格式覆盖。

4. 常用用例的预设参数 - 简化工作流程

Apifox 通过为常用方法提供预设参数（可根据需要自定义）来提高效率：

{{$helpers.fromRegExp('[A-Z0-9]{4}-[A-Z0-9]{4}')}} // 生成与正则表达式匹配的字符串

{{$helpers.arrayElement(['abc','123'])}} // 从数组中随机选择一个元素

{{$helpers.arrayElements(['abc','123'])}} // 从数组中选择多个随机元素

{{$helpers.replaceSymbols('##??**')}} // 用随机字符替换特殊符号

{{$helpers.slugify('abc 123')}} // 生成 URL 友好的 slug

5. 扩展的动态值库，提供更广泛的覆盖范围

Apifox 通过新的类别和方法丰富了你的数据生成功能：

新类别：food 用于生成各种与食物相关的数据。示例：{{$food.vegetable}}

新方法：

{{$date.timeZone}} 用于生成时区数据。

{{$music.album}} 用于创建逼真的音乐专辑名称。

{{$music.artist}} 用于生成艺术家姓名。

增强型方法参数：

{{$phone.number(style='human')}} 用于生成人类可读的电话号码，例如：(555) 123-4567。

{{$number.int(multipleOf=3)}} 用于生成可被指定数字整除的整数。

6. 无限拼接 - 释放你的创造力

Apifox 允许你无限制地无缝组合模拟数据和动态值，从而提供最终的灵活性，使你能够创建丰富而逼真的测试场景。

7. 扩展的日期功能，用于强大的日期操作

Apifox 扩展了日期相关的函数，增加了用于格式化、偏移量计算等的新参数，以满足各种复杂测试需求。

修改于 2024-11-29 08:14:48