npm 包 verum 使用教程

阅读时长 4 分钟读完

verum 是一个前端库,专门用于校验表单数据和整体数据结构。它提供了一系列的验证规则,如必选、最小长度、邮箱、数字等等,完全可以满足开发者多元化的需求。在此教程中,我们将一步步教你如何使用 verum

安装 verum

你可以通过 npm 安装 verum

引入 verum 库

在你的代码中引入 verum

Verum 基础使用

使用 Verum 进行验证前,我们需要实例化一个 Verum 对象,并设置验证规则。

以上,我们定义了一个 formValidation 的校验规则对象,里面分别对 emailpasswordrepeatPassword 进行了校验,并且规定了校验规则。规则列表详见官方文档。

接下来,我们使用 testAsync() 方法对表单数据进行校验:

-- -------------------- ---- -------
----- ---- - -
  ------ -------------------
  --------- --------------
  --------------- -------------
-

------------------------------
  -------- -- -
    ---------------- ------ --- --------
  --
  ------------- -- -
    ----------------------- ------ ---- --------- -------
  --
展开代码

以上,我们测试了一个数据对象,如果所有字段都符合规则则返回 then() 条件,否则会抛出错误,可以在 catch() 中捕捉错误。

自定义规则及错误信息

verum 允许你非常方便地自定义规则及错误信息。

-- -------------------- ---- -------
------ ----- ---- -------

-- ---------------- - ------
------------------------ -- ----- -- -- -
  -- -------- -
    -- ---------
    ----- --- ------------------- ------ -- ----- -----
  -
  ----- -------------- - ------------ -- --
  ----- -------------------- - ------------------ -- - - - --- ---
  -- --------------- -- --------------------- -
    ------ ----
  -
  ----- --- ------------------- ------- -- ----- - --- -------------
--

----- -------------- - --- -------
  ----- --------------------- -------------------
  --------- --------------------- -------------------------
  --------------- --------------------- -----------------------------
--

----- ---- - -
  ----- ---------
  --------- ---------
  --------------- --------
-

------------------------------
  -------- -- -
    ---------------- ------ --- --------
  --
  ------------- -- -
    ----------------------- ------ ---- --------- -------
  --
展开代码

以上,我们定义了一个自定义规则:需要至少 6 个奇数字符。我们在验证规则中使用了它,现在运行校验器时,如果名称中至少有 6 个奇数字字符,则不会报错。

语句 throw new Verum.Error('Length should at least 6.'),则可以用来手动抛出错误。错误消息可以自定义,在多语言环境中是非常有用的。因为我们可以根据当前环境动态地加载适合的错误消息。

总结

verum 提供了优秀的数据校验,为表单数据和整体数据结构提供了更简单、更有效的验证方式。将它与 React、Vue 或任何其他框架集成起来几乎是轻而易举的。希望这篇文章对你有所帮助。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005547381e8991b448d1bad

纠错
反馈

纠错反馈