@vinejs/vine - v4.0.0-next.1
    Preparing search index...

    Class VineLiteral<Value>

    VineLiteral represents a type that matches an exact value

    Type Parameters

    Hierarchy (View Summary)

    Index

    Constructors

    Properties

    "[ITYPE]": Value

    Define the input type of the schema for TypeScript inference

    "[OTYPE]": Value

    The output value type of the field after validation. The property points to a type only and not the real value.

    "[COTYPE]": Value

    Type marker for camelCase output type inference

    dataTypeValidator?: Validation<any>

    The validation to use for validating the schema data type. Using a data type validator guards custom rules to only run when the data type validation passes.

    class StringSchema extends BaseLiteralType {
    dataTypeValidator = stringDataTypeRule
    }
    rules: {
        equals: (
            ...options: [options: { expectedValue: any }],
        ) => Validation<{ expectedValue: any }>;
    } = ...

    Default collection of literal rules

    "[SUBTYPE]": string = 'literal'

    The subtype of the literal schema field

    "[UNIQUE_NAME]": string

    The property must be implemented for "unionOfTypes"

    Methods

    • Define a method to parse the input value. The method is invoked before any validation and hence you must perform type-checking to know the value you are working it.

      Parameters

      • callback: ParseFn

      Returns this

    • Adds a validation rule to the schema's validation chain. Rules are executed in the order they are added.

      Parameters

      Returns this

      This schema instance for method chaining

      vine.string().use(minLength({ length: 3 }))
      vine.number().use(customRule({ strict: true }))
    • Enable/disable bail mode for this field. In bail mode, field validations stop after the first error.

      Parameters

      • state: boolean

        Whether to enable bail mode

      Returns VineLiteral<Value>

      This schema instance for method chaining

      vine.string().bail(false) // Continue validation after first error
      vine.number().bail(true) // Stop after first error (default)
    • Compiles the literal schema type into a compiler node. This method transforms the schema definition into a format that the validation compiler can process.

      Parameters

      • propertyName: string

        Name of the property being compiled

      • refs: RefsStore

        Reference store for the compiler

      • options: ParserOptions

        Parser options including camelCase conversion

      Returns FieldNode & {} & { subtype: string }

      Compiled literal node with subtype information

    • Checks if the value is of string type. The method must be implemented for "unionOfTypes"

      Parameters

      • value: unknown

      Returns boolean