Options
All
  • Public
  • Public/Protected
  • All
Menu

Class ArraySchema

Schema to validate arrays.

Example

let schema = new ArraySchema(TypeCode.String);

schema.validate(["A", "B", "C"]);    // Result: no errors
schema.validate([1, 2, 3]);          // Result: element type mismatch
schema.validate("A");                // Result: type mismatch

Hierarchy

Index

Constructors

constructor

  • Creates a new instance of validation schema and sets its values.

    see

    TypeCode

    Parameters

    • Optional valueType: any

      a type of array elements. Null means that elements may have any type.

    • Optional required: boolean

      (optional) true to always require non-null values.

    • Optional rules: IValidationRule[]

      (optional) a list with validation rules.

    Returns ArraySchema

Methods

getRules

  • Gets validation rules to check values against.

    Returns IValidationRule[]

    a list with validation rules.

getValueType

  • getValueType(): any
  • Gets the type of array elements. Null means that elements may have any type.

    Returns any

    the type of array elements.

isRequired

  • isRequired(): boolean
  • Gets a flag that always requires non-null values. For null values it raises a validation error.

    Returns boolean

    true to always require non-null values and false to allow null values.

makeOptional

  • Makes validated values optional. Validation for null values will be skipped.

    This method returns reference to this exception to implement Builder pattern to chain additional calls.

    see

    makeRequired

    Returns Schema

    this validation schema

makeRequired

  • Makes validated values always required (non-null). For null values the schema will raise errors.

    This method returns reference to this exception to implement Builder pattern to chain additional calls.

    see

    makeOptional

    Returns Schema

    this validation schema

Protected performTypeValidation

  • performTypeValidation(path: string, type: any, value: any, results: ValidationResult[]): void
  • Validates a given value to match specified type. The type can be defined as a Schema, type, a type name or TypeCode When type is a Schema, it executes validation recursively against that Schema.

    see

    performValidation

    Parameters

    • path: string

      a dot notation path to the value.

    • type: any

      a type to match the value type

    • value: any

      a value to be validated.

    • results: ValidationResult[]

      a list with validation results to add new results.

    Returns void

Protected performValidation

  • performValidation(path: string, value: any, results: ValidationResult[]): void
  • Validates a given value against the schema and configured validation rules.

    Parameters

    • path: string

      a dot notation path to the value.

    • value: any

      a value to be validated.

    • results: ValidationResult[]

      a list with validation results to add new results.

    Returns void

setRequired

  • setRequired(value: boolean): void
  • Sets a flag that always requires non-null values.

    Parameters

    • value: boolean

      true to always require non-null values and false to allow null values.

    Returns void

setRules

  • Sets validation rules to check values against.

    Parameters

    Returns void

setValueType

  • setValueType(value: any): void
  • Sets the type of array elements. Null means that elements may have any type.

    Parameters

    • value: any

      a type of array elements.

    Returns void

validate

  • Validates the given value and results validation results.

    see

    ValidationResult

    Parameters

    • value: any

      a value to be validated.

    Returns ValidationResult[]

    a list with validation results.

validateAndReturnException

  • validateAndReturnException(correlationId: string, value: any, strict?: boolean): ValidationException
  • Validates the given value and returns a ValidationException if errors were found.

    Parameters

    • correlationId: string

      (optional) transaction id to trace execution through call chain.

    • value: any

      a value to be validated.

    • Default value strict: boolean = false

      true to treat warnings as errors.

    Returns ValidationException

validateAndThrowException

  • validateAndThrowException(correlationId: string, value: any, strict?: boolean): void

withRule

  • Adds validation rule to this schema.

    This method returns reference to this exception to implement Builder pattern to chain additional calls.

    Parameters

    Returns Schema

    this validation schema.

Generated using TypeDoc