Question

我们可以给组件的 data 指定校验规则。如果传入的数据不符合规则，那么 san 会抛出异常。当组件给其他人使用时，这很有用。

指定校验规则，需要使用 DataTypes 进行声明：

import san, {DataTypes} from 'san';

let MyComponent = san.defineComponent({

    dataTypes: {
        name: DataTypes.string
    }

});

DataTypes 提供了一系列校验器，可以用来保证组件得到的数据是合法的。在上边的示例中，我们使用了 DataTypes.string。当一个 name 得到了一个不合法的数据值时，san 会抛出异常。

考虑到性能原因，dataTypes 只会在 development 模式下进行数据校验。

请参考这里来确认在不同的 san 发布版本中数据校验功能的支持情况。

DataTypes

下边是 DataTypes 提供的各种校验的一个示例代码：

import san, {DataTypes} from 'san';

san.defineComponent({

    // 你可以声明数据为 JS 原生类型。
    // 默认的以下这些数据是可选的。
    optionalArray: DataTypes.array,
    optionalBool: DataTypes.bool,
    optionalFunc: DataTypes.func,
    optionalNumber: DataTypes.number,
    optionalObject: DataTypes.object,
    optionalString: DataTypes.string,
    optionalSymbol: DataTypes.symbol,

    // 你也可以声明数据为指定类的实例。
    // 这里会使用 instanceof 进行判断。
    optionalMessage: DataTypes.instanceOf(Message),

    // 如果你可以确定你的数据是有限的几个值之一，那么你可以将它声明为枚举类型。
    optionalEnum: DataTypes.oneOf(['News', 'Photos']),

    // 可以是指定的几个类型之一
    optionalUnion: DataTypes.oneOfType([
        DataTypes.string,
        DataTypes.number,
        DataTypes.instanceOf(Message)
    ]),

    // 数组中每个元素都必须是指定的类型
    optionalArrayOf: DataTypes.arrayOf(DataTypes.number),

    // 对象的所有属性值都必须是指定的类型
    optionalObjectOf: DataTypes.objectOf(DataTypes.number),

    // 具有特定形状的对象
    optionalObjectWithShape: DataTypes.shape({
        color: DataTypes.string,
        fontSize: DataTypes.number
    }),

    // 以上所有校验器都拥有 `isRequired` 方法，来确保此数据必须被提供
    requiredFunc: DataTypes.func.isRequired,
    requiredObject: DataTypes.shape({
        color: DataTypes.string
    }).isRequired,

    // 一个必须的但可以是任何类型的数据
    requiredAny: DataTypes.any.isRequired,

    // 你也可指定一个自定义的校验器。
    // 如果校验失败，它应该丢出一个异常。
    customProp: function (props, propName, componentName) {
        if (!/matchme/.test(props[propName])) {
            throw new Error(
                'Invalid prop `' + propName + '` supplied to' +
                ' `' + componentName + '`. Validation failed.'
            );
        }
    },

    // 你也可以给 `arrayOf` 和 `objectOf` 提供一个自定义校验器。
    // 如果校验失败，那么应该当抛出一个异常。
    // 对于数组或者对象中的每个元素都会调用校验器进行校验。
    // 第一个参数是这个数组或者对象，第二个参数是元素的 key。
    customArrayProp: DataTypes.arrayOf(function (dataValue, key, componentName, dataFullName) {
        if (!/matchme/.test(dataValue[key])) {
            throw new Error(
                'Invalid prop `' + dataFullName + '` supplied to' +
                ' `' + componentName + '`. Validation failed.'
            );
        }
    })

});