yaschema
    Preparing search index...

    Interface ObjectSchema_noAutoOptional<ObjectT>

    Requires an object, where each key has it's own schema. Unlike with ObjectSchema, the keys of values that may be undefined are not automatically treated as optional. You may explicitly provide a type parameter when using …_noAutoOptional methods, and that may include optional keys.

    interface ObjectSchema_noAutoOptional<ObjectT extends Record<string, any>> {
        allowNull: () => Schema<null | ObjectT>;
        allowUnknownKeys: boolean;
        clone: () => ObjectSchema_noAutoOptional<ObjectT>;
        cloneValue: SyncCloner<ObjectT>;
        cloneValueAsync: AsyncCloner<ObjectT>;
        description?: string;
        deserialize: SyncDeserializer<ObjectT>;
        deserializeAsync: AsyncDeserializer<ObjectT>;
        estimatedValidationTimeComplexity: () => number;
        example?: string;
        isOrContainsObjectPotentiallyNeedingUnknownKeyRemoval: () => boolean;
        isYaSchema: true;
        map: InferRecordOfSchemasFromRecordOfValues<ObjectT>;
        not: <ExcludeT>(
            notSchema: Schema<ExcludeT>,
            options?: { expectedTypeName?: string },
        ) => Schema<Exclude<ObjectT, ExcludeT>>;
        optional: () => Schema<undefined | ObjectT>;
        parse: SyncParser<ObjectT>;
        parseAsync: AsyncParser<ObjectT>;
        preferredValidationMode: SchemaPreferredValidationMode;
        schemaType: "object";
        serialize: SyncSerializer<ObjectT>;
        serializeAsync: AsyncSerializer<ObjectT>;
        setAllowUnknownKeys: (allow: boolean) => this;
        setDescription: (description?: string) => this;
        setExample: (example?: string) => this;
        setPreferredValidationMode: (
            validationMode: SchemaPreferredValidationMode,
        ) => this;
        stringify: SyncStringifier<ObjectT>;
        stringifyAsync: AsyncStringifier<ObjectT>;
        toString: () => string;
        usesCustomSerDes: () => boolean;
        validate: SyncValidator;
        validateAsync: AsyncValidator;
        valueType: ObjectT;
    }

    Type Parameters

    • ObjectT extends Record<string, any>

    Hierarchy (View Summary)

    Index

    Properties

    allowNull allowUnknownKeys clone cloneValue cloneValueAsync description? deserialize deserializeAsync estimatedValidationTimeComplexity example? isOrContainsObjectPotentiallyNeedingUnknownKeyRemoval isYaSchema map not optional parse parseAsync preferredValidationMode schemaType serialize serializeAsync setAllowUnknownKeys setDescription setExample setPreferredValidationMode stringify stringifyAsync toString usesCustomSerDes validate validateAsync valueType

    Properties

    allowNull: () => Schema<null | ObjectT>

    Returns a new schema that requires that either this schema is satisfied or that the value is null.

    allowUnknownKeys: boolean

    If true, extra keys won't be removed. This effects the directly described value but not sub-values.

    clone: () => ObjectSchema_noAutoOptional<ObjectT>
    cloneValue: SyncCloner<ObjectT>

    Deeply clones a value

    if the schema requires async cloning

    cloneValueAsync: AsyncCloner<ObjectT>

    Deeply clones a value

    description?: string

    A description, which can be used by code generation tools to generate documentation

    deserialize: SyncDeserializer<ObjectT>

    Deserialize (and validate) a value

    if the schema requires async deserialization

    deserializeAsync: AsyncDeserializer<ObjectT>

    Deserialize (and validate) a value

    estimatedValidationTimeComplexity: () => number

    An estimate of the time complexity for validating this element, which should be on the same order of the number of items to be validated

    example?: string

    An example, which can be used by code generation tools to generate documentation

    isOrContainsObjectPotentiallyNeedingUnknownKeyRemoval: () => boolean

    If true, this schema or any sub-elements have the potential to represent an object value that might need unknown-key removal

    isYaSchema: true

    A marker that can be used for testing if this is a YaSchema schema

    map: InferRecordOfSchemasFromRecordOfValues<ObjectT>
    not: <ExcludeT>(
        notSchema: Schema<ExcludeT>,
        options?: { expectedTypeName?: string },
    ) => Schema<Exclude<ObjectT, ExcludeT>>

    Returns a new schema that requires that this schema is satisfied but that the specified schema cannot be satisfied.

    optional: () => Schema<undefined | ObjectT>

    Returns a new schema that requires that either this schema is satisfied or that the value is undefined.

    parse: SyncParser<ObjectT>

    Parse and deserialize a value from a JSON string

    with a DeserializationResult<T> & { error: string } if parsing fails

    if the schema requires async deserialization

    parseAsync: AsyncParser<ObjectT>

    Parse and deserialize a value from a JSON string

    with a DeserializationResult<T> & { error: string } if parsing fails

    preferredValidationMode: SchemaPreferredValidationMode

    The preferred validation mode for this schema.

    The lesser level of the preferred validation mode, which will be applied recursively depending on the depth parameter / unless further re-specified, and the specified validation mode, will be used, where the order is none < soft < hard.

    Special Values:

    • "initial" - use the initially specified validation mode for the current operation (ex. the validation field of the options parameter to deserialize).
    • "inherit" - use the closet applicable mode from an ancestor schema level.
    schemaType: "object"
    serialize: SyncSerializer<ObjectT>

    Serialize (and validate) a value

    if the schema requires async serialization

    serializeAsync: AsyncSerializer<ObjectT>

    Serialize (and validate) a value

    setAllowUnknownKeys: (allow: boolean) => this
    setDescription: (description?: string) => this

    Sets (replaces) the description metadata for this schema and returns the same schema

    setExample: (example?: string) => this

    Sets (replaces) the example metadata for this schema and returns the same schema

    setPreferredValidationMode: (
        validationMode: SchemaPreferredValidationMode,
    ) => this

    Sets (replaces) the preferred validation mode for this schema and returns the same schema.

    The lesser level of the preferred validation mode, which will be applied recursively depending on the depth parameter / unless further re-specified, and the specified validation mode, will be used, where the order is none < soft < hard.

    Type declaration

      • (validationMode: SchemaPreferredValidationMode): this

      • Parameters

        • validationMode: SchemaPreferredValidationMode

          The preferred validation mode for this schema Special Values:

          • "initial" - use the initially specified validation mode for the current operation (ex. the validation field of the options parameter to deserialize).
          • "inherit" - use the closet applicable mode from an ancestor schema level.

        Returns this

    stringify: SyncStringifier<ObjectT>

    Serialize (and validate) and stringify a value

    with a SerializationResult<T> & { error: string } if stringification fails

    if the schema requires async serialization

    stringifyAsync: AsyncStringifier<ObjectT>

    Serialize (and validate) and stringify a value

    with a SerializationResult<T> & { error: string } if stringification fails

    toString: () => string

    Makes a string representation of this schema, mostly for debugging

    usesCustomSerDes: () => boolean

    If true, this schema or any sub-elements have a custom serializer-deserializer

    validate: SyncValidator

    Validate a value. This throws if the schema requires async validation.

    validateAsync: AsyncValidator

    Validate a value

    valueType: ObjectT

    The actual value of this field is always undefined, but this should be used for determining the value type represented by this schema, ex. typeof someSchema.valueType

    Settings

    Member Visibility

    On This Page

    Properties