npm 包 @zeit/schemas 使用教程

阅读时长 6 分钟读完

简介

在前端开发中,经常需要进行数据校验,传统的方式是编写大量的 if else 语句和正则表达式进行校验。但随着数据校验的复杂度不断提高,这种方式已经无法满足需求。此时,我们可以使用现成的数据校验工具来提高效率和准确性。

@zeit/schemas 是一款基于 json schema 的数据校验工具,由 Zeit 公司开发维护,并已上传 npm。该工具支持从 json schema 文件中生成 TypeScript 类型,并提供了众多自定义校验规则,如必填项、最大值、最小值等等,并支持嵌套校验。

在本文中,我们将详细介绍 @zeit/schemas 的使用方法,并提供示例代码以方便学习和使用。

使用方法

在使用 @zeit/schemas 前,首先需要安装它。我们可以在终端或命令行中使用以下命令进行安装:

安装完成后,即可使用该工具进行数据校验。

基本用法

下面,我们来看一下 @zeit/schemas 的基本用法:

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

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

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

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

我们首先定义了一个 json schema,其中包含两个属性:name 和 age,它们的类型分别为 string 和 number,并定义了一些自定义规则。然后,我们定义了一个数据对象 data,它满足上述 json schema 的定义,即它包含 name 和 age 两个属性且满足相应的类型和规则。最后,我们使用 validate 方法进行校验,它会返回一个布尔值表示校验结果。

自定义校验规则

@zeit/schemas 还支持自定义校验规则。例如,我们要对一个字符串进行判断,它必须是传统的英文名字格式,即名字由大小写字母组成,且第一个字母为大写。我们可以使用以下代码:

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

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

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

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

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

我们首先定义了一个普通的 json schema,它的类型为 string,并规定了字符串的最大长度为 50。然后,我们自定义了一个格式校验规则 formats.name,它接收一个字符串作为参数,返回布尔值表示是否符合格式要求。在自定义规则后,我们可以使用 validate 方法进行校验,它会自动使用自定义规则。

内嵌校验

@zeit/schemas 还支持内嵌校验。例如,我们有一个简单的学生信息表单,它包含姓名、年龄和地址三个字段,其中地址由省、市、区三个字段组成。我们可以使用以下代码进行校验:

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

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

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

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

我们首先定义了一个 json schema,它包含了三个属性:name、age 和 address。其中 address 是一个嵌套的对象,它包含了三个属性:province、city 和 district,并且这三个属性都是必填项。然后,我们定义了一个数据对象 data,它符合上述 json schema 的定义。注意,我们可以在嵌套对象中添加其他属性,而它们不会被校验。最后,我们使用 validate 方法进行校验,它会自动进行内嵌校验。

总结

@zeit/schemas 是一款基于 json schema 的数据校验工具,可以大大提高数据校验的效率和准确性。本文详细介绍了 @zeit/schemas 的使用方法,包括基本用法、自定义校验规则和内嵌校验,并提供了示例代码。希望本文对读者学习和使用 @zeit/schemas 有所帮助。

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

纠错
反馈

纠错反馈