架构验证工具包的最新版本 0.9 - ajv-ts 带来了一系列增强功能,以提高开发人员的工作效率并确保更好的验证准确性。无论您是构建复杂的数据模型还是仅处理基本输入,这些更新都有助于通过更强大的功能和示例简化架构定义。以下是此版本中引入的关键更新的概述,以及对版本 0.7.
的重大更改的回顾
0.9 版的主要更新之一是为每种数据类型引入了模式示例。此功能允许开发人员直接在其架构定义中包含特定示例,从而提供更高的透明度和易用性。您还可以将其与任何参数长度一起使用。
// valid examples for a string schema const mystring = s.string().examples(["hello", "world"]); mystring.schema // // {type: 'string', examples: ['hello', 'world']} s.string().examples("hello", "world"); // oks
// valid examples for a number schema const mynum1 = s.number().examples(null, 2, 3); mynum1.schema // {type: 'number', examples: [1,2,3]} // typescript error for invalid number types // @ts-ignore fails ts, but schema still ok const mynum2 = s.number().examples(["abc", "123"]); mynum2.schema // {type: "number", examples: ["abc", "123"] }
此更改有助于验证正确的数据类型并改进代码中的文档,使团队更容易理解期望的值。
还值得强调的是之前版本 0.8 中引入的一些重大更改,这些更改带来了更严格的数字验证:
s.number().format("float").int(); // error: incompatible format and type s.number().int().format("double"); // error: 'double' format not allowed for integers
s.number().min(5).max(3); // Error: max cannot be smaller than min s.number().min(1).max(10).const(15); // Error: constant is out of specified range
这些增强功能有助于防止架构定义期间出现逻辑错误,并确保数据验证更加一致。
release 0.9 和 release 0.8 更新通过提供更好的示例、更严格的验证和增强的错误显着改善了开发人员体验处理——尤其是对于 typescript 用户。这些功能使架构定义更加直观、可靠,并且在复杂项目中更易于维护。请务必探索新功能,以使您的验证工作流程更加高效!
项目链接:https://github.com/vitalics/ajv-ts