typecasts v3.2.0

typecasts

类型转换并验证转换结果是否满足条件，并且支持 TypeScript 类型输出

使用样例

import { typeCast } from "typecasts";

const var1 = typeCast("123", { type: "int" });

console.log(var1); // 123
console.log(typeof var1); // number

使用 typeCastPick 挑选对象中的多个数据

import { typeCastPick } from "typecasts";

// 输入数据
const inputData = {
  a: 1,
  b: 'yes',
  c: 'str  ',
  d: '1,2,3,4',
  e: '2021-5-13 13:11:22',
  f: 'http://test',
  obj: {
    g: 2,
    h: 'a,b,c,d'
  }
};

// 类型处理
const v = typeCastPick(inputData, {
  a: '!int',  // 整数类型，! 感叹号开头表示此项必须并且不能为null
  b: 'bool',
  c: 'trim',
  d: 'int[]', // 如果以 [] 结尾则代表转换为类型数组形式
  e: 'date',
  f: {
    // 如果不使用快捷类型，可以分别指定类型的转换规则
    type: 'trim',         // 目标类型
    default: 'not-url',   // 默认值
    splitter: ',',        // 是否切割为数组，定义切割字符
    minItems: 1,          // 切割数组后最少需要的元素数量
    maxItems: 10,         // 切割数组后最多不能超过的元素数量
    // 数据验证规则
    validate: {
      url: true, // 验证是否符合链接格式
      maxLength: 500, // 字符串长度不能超过 500
      // 更多规则参照下表 “支持的数据验证”
    },
  },
  obj: {
    // 嵌套对象
    type: {
      g: '!int',
      g: '~trim[]'
    }
  }
});

console.log(v);

// 输出
{
  a: 1,
  b: true,
  c: 'str',
  d: [ 1, 2, 3, 4 ],
  e: new Date('2021-5-13 13:11:22'),
  f: 'http://test',
  obj: {
    g: 2,
    h: [ 'a', 'b', 'c', 'd' ]
  }
}

类型规则快捷方式

例如 int 类型名称，可以写成 !int 或者 int[] 或两者的组合 !int[]

类型前缀规则 | 前缀 | 可传入类型 | --- | --------- | 无 | 非必填, 允许 null | ? | 非必填, 不允许 null | ~ | 必填, 允许 null | ! | 必填, 不允许 null

支持的转换类型

支持的数据验证