Skip to content

Latest commit

 

History

History
629 lines (315 loc) · 14.2 KB

ObjectParser.md

File metadata and controls

629 lines (315 loc) · 14.2 KB

tsukikoDocs


tsukiko / ObjectParser

Class: ObjectParser<S>

Represents a parser for object values with configurable validation options.

Extends

Type Parameters

S extends ObjectParserConfig

The object parser configuration type.

Constructors

new ObjectParser()

new ObjectParser<S>(types): ObjectParser<S>

Creates a new instance of ObjectParser.

Parameters

types: S

The configuration for the object parser.

Returns

ObjectParser<S>

Overrides

Parser.constructor

Defined in

src/parsers/object.ts:102

Properties

defaultValue?

protected optional defaultValue: ObjectParserInfer<S>

Inherited from

Parser.defaultValue

Defined in

src/parser.ts:49


isOptional

protected isOptional: boolean = false

Inherited from

Parser.isOptional

Defined in

src/parser.ts:44


isStrict

protected isStrict: boolean = false

Defined in

src/parsers/object.ts:68


langType

protected langType: langType = DEFAULT_LANG

Inherited from

Parser.langType

Defined in

src/utils/lang.ts:6


rules

protected rules: ParserFunction[]

Overrides

Parser.rules

Defined in

src/parsers/object.ts:23

Methods

check()

check(input): input is ObjectParserInfer<S>

Checks if the input is valid according to the parser's rules.

Parameters

input: unknown

The input to check.

Returns

input is ObjectParserInfer<S>

True if the input is valid, false otherwise.

Inherited from

Parser.check

Defined in

src/parser.ts:99


default()

default(value): Parser<ObjectParserInfer<S>>

Sets a default value for the parser.

Parameters

value: ObjectParserInfer<S>

The default value.

Returns

Parser<ObjectParserInfer<S>>

The current Parser instance.

Inherited from

Parser.default

Defined in

src/parser.ts:118


defaultHandle()

protected defaultHandle(input): ObjectParserInfer<S>

Parameters

input: ObjectParserInfer<S>

Returns

ObjectParserInfer<S>

Overrides

Parser.defaultHandle

Defined in

src/parsers/object.ts:70


describe()

describe(description): ObjectParser<S>

Sets a description for the parser.

Parameters

description: string

The description to set.

Returns

ObjectParser<S>

The current Parser instance.

Inherited from

Parser.describe

Defined in

src/parser.ts:138


empty()

empty(): ObjectParser<S>

Configures the parser to allow undefined but not null.

Returns

ObjectParser<S>

The current Parser instance.

Inherited from

Parser.empty

Defined in

src/parser.ts:128


error()

protected error(lang, data?): TsuError

Parameters

lang: "not_string" | "not_a_email" | "not_a_domain" | "not_a_url" | "illegal_match_string" | "illegal_starts_with" | "illegal_ends_with" | "too_long" | "too_short" | "not_number" | "not_integer_number" | "not_odd_number" | "not_even_number" | "not_natural_number" | "not_positive_number" | "not_negative_number" | "not_percentage" | "too_bigger" | "too_bigger_has" | "too_smaller" | "too_smaller_has" | "not_multiple_number" | "is_a_NaN" | "not_boolean" | "not_true" | "not_false" | "not_null" | "not_undefined" | "not_never" | "not_an_array" | "array_error" | "too_many_items" | "too_few_items" | "not_a_tuple" | "illegal_tuple_length" | "tuple_error" | "not_an_object" | "object_is_null" | "object_is_an_array" | "object_not_instance_of_constructor" | "object_keys_too_many" | "object_keys_too_few" | "object_error" | "object_key_error" | "intersection_error" | "union_error" | "literal_only" | "literal_number_error" | "literal_string_error" | "literal_boolean_error" | "custom_error" | "not_a_function" | "not_a_constructor" | "not_an_async_function" | "not_a_generator_function" | "not_an_async_generator_function" | "not_an_arrow_function" | "function_args_count_mismatch" | "function_name_mismatch" | "not_a_class" | "class_args_count_mismatch" | "class_name_mismatch" | "class_prototype_error"

data?

Returns

TsuError

Inherited from

Parser.error

Defined in

src/parser.ts:39


index()

index<T>(value, key): Parser<Record<string, ParserInfer<T>>>

Configures the parser to handle additional properties with a specified value parser and key parser.

Type Parameters

T extends Parser<unknown>

Parameters

value: T

The parser for additional property values.

key: StringParser = ...

The parser for additional property keys. Defaults to a new StringParser instance.

Returns

Parser<Record<string, ParserInfer<T>>>

A new Parser instance for the indexed object.

Defined in

src/parsers/object.ts:131


instance()

instance(Constructor): ObjectParser<S>

Adds a constructor to the list of allowed instance types.

Parameters

Constructor: Constructor

The constructor function to add.

Returns

ObjectParser<S>

The current ObjectParser instance.

Defined in

src/parsers/object.ts:146


lang()

lang(value): ObjectParser<S>

Parameters

value: langType = DEFAULT_LANG

Returns

ObjectParser<S>

Inherited from

Parser.lang

Defined in

src/utils/lang.ts:8


max()

max(value): ObjectParser<S>

Sets the maximum number of properties allowed in the object.

Parameters

value: number

The maximum number of properties.

Returns

ObjectParser<S>

The current ObjectParser instance.

Defined in

src/parsers/object.ts:156


min()

min(value): ObjectParser<S>

Sets the minimum number of properties required in the object.

Parameters

value: number

The minimum number of properties.

Returns

ObjectParser<S>

The current ObjectParser instance.

Defined in

src/parsers/object.ts:167


optional()

optional(): Parser<undefined | ObjectParserInfer<S>>

Makes the parser optional.

Returns

Parser<undefined | ObjectParserInfer<S>>

The current Parser instance.

Inherited from

Parser.optional

Defined in

src/parser.ts:107


parse()

parse(input): ObjectParserInfer<S>

Parses the input and returns the result.

Parameters

input: unknown

The input to parse.

Returns

ObjectParserInfer<S>

The parsed result.

Throws

If parsing fails.

Inherited from

Parser.parse

Defined in

src/parser.ts:61


parseAsync()

parseAsync(input): Promise<unknown>

Asynchronously parses the input.

Parameters

input: unknown

The input to parse.

Returns

Promise<unknown>

A promise that resolves with the parsed result or rejects with an error.

Inherited from

Parser.parseAsync

Defined in

src/parser.ts:86


parseSafe()

parseSafe(input): ParserSafeReturn<ObjectParserInfer<S>>

Safely parses the input and returns a result object.

Parameters

input: unknown

The input to parse.

Returns

ParserSafeReturn<ObjectParserInfer<S>>

An object containing the parsing result or error.

Inherited from

Parser.parseSafe

Defined in

src/parser.ts:72


range()

range(min, max): ObjectParser<S>

Sets both the minimum and maximum number of properties allowed in the object.

Parameters

min: number

The minimum number of properties.

max: number

The maximum number of properties.

Returns

ObjectParser<S>

The current ObjectParser instance.

Defined in

src/parsers/object.ts:179


schema()

schema(bringSchema): JsonSchema

Generates a JSON schema for the parser.

Parameters

bringSchema: boolean = true

Whether to include the $schema property. Defaults to true.

Returns

JsonSchema

The generated JSON schema.

Inherited from

Parser.schema

Defined in

src/parser.ts:158


setMeta()

protected setMeta(metadata): void

Parameters

metadata: Partial<SchemaMetadata>

Returns

void

Inherited from

Parser.setMeta

Defined in

src/parser.ts:51


strict()

strict(isStrict): ObjectParser<S>

Sets whether the parser should be strict in its object property checking.

Parameters

isStrict: boolean = true

Whether to enable strict mode. Defaults to true.

Returns

ObjectParser<S>

The current ObjectParser instance.

Defined in

src/parsers/object.ts:115


title()

title(title): ObjectParser<S>

Sets a title for the parser.

Parameters

title: string

The title to set.

Returns

ObjectParser<S>

The current Parser instance.

Inherited from

Parser.title

Defined in

src/parser.ts:148