Skip to content

Latest commit

 

History

History
595 lines (298 loc) · 12.6 KB

FunctionParser.md

File metadata and controls

595 lines (298 loc) · 12.6 KB

tsukikoDocs


tsukiko / FunctionParser

Class: FunctionParser<T>

Parser for function values.

Extends

Type Parameters

T extends (...args) => unknown

The function type.

Constructors

new FunctionParser()

new FunctionParser<T>(): FunctionParser<T>

Returns

FunctionParser<T>

Inherited from

Parser.constructor

Properties

defaultValue?

protected optional defaultValue: T

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


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/standard/function.ts:26

Methods

args()

args(count): FunctionParser<T>

Sets the expected number of arguments for the function.

Parameters

count: number

The number of arguments.

Returns

FunctionParser<T>

The current FunctionParser instance.

Defined in

src/parsers/standard/function.ts:83


arrow()

arrow(isArrow): FunctionParser<T>

Configures the parser to expect arrow functions.

Parameters

isArrow: boolean = true

Whether the function should be an arrow function. Defaults to true.

Returns

FunctionParser<T>

The current FunctionParser instance.

Defined in

src/parsers/standard/function.ts:63


async()

async(isAsync): FunctionParser<T>

Configures the parser to expect async functions.

Parameters

isAsync: boolean = true

Whether the function should be async. Defaults to true.

Returns

FunctionParser<T>

The current FunctionParser instance.

Defined in

src/parsers/standard/function.ts:53


check()

check(input): input is T

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

Parameters

input: unknown

The input to check.

Returns

input is T

True if the input is valid, false otherwise.

Inherited from

Parser.check

Defined in

src/parser.ts:99


constructed()

constructed(isConstructor): FunctionParser<T>

Configures the parser to expect constructor functions.

Parameters

isConstructor: boolean = true

Whether the function should be a constructor. Defaults to true.

Returns

FunctionParser<T>

The current FunctionParser instance.

Defined in

src/parsers/standard/function.ts:103


default()

default(value): Parser<T>

Sets a default value for the parser.

Parameters

value: T

The default value.

Returns

Parser<T>

The current Parser instance.

Inherited from

Parser.default

Defined in

src/parser.ts:118


defaultHandle()

protected defaultHandle(input): T

Parameters

input: T

Returns

T

Inherited from

Parser.defaultHandle

Defined in

src/parser.ts:34


describe()

describe(description): FunctionParser<T>

Sets a description for the parser.

Parameters

description: string

The description to set.

Returns

FunctionParser<T>

The current Parser instance.

Inherited from

Parser.describe

Defined in

src/parser.ts:138


empty()

empty(): FunctionParser<T>

Configures the parser to allow undefined but not null.

Returns

FunctionParser<T>

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


generator()

generator(isGenerator): FunctionParser<T>

Configures the parser to expect generator functions.

Parameters

isGenerator: boolean = true

Whether the function should be a generator. Defaults to true.

Returns

FunctionParser<T>

The current FunctionParser instance.

Defined in

src/parsers/standard/function.ts:73


lang()

lang(value): FunctionParser<T>

Parameters

value: langType = DEFAULT_LANG

Returns

FunctionParser<T>

Inherited from

Parser.lang

Defined in

src/utils/lang.ts:8


name()

name(parser): FunctionParser<T>

Sets a parser for the function name.

Parameters

parser: StringParser

The StringParser to use for the function name.

Returns

FunctionParser<T>

The current FunctionParser instance.

Defined in

src/parsers/standard/function.ts:93


optional()

optional(): Parser<undefined | T>

Makes the parser optional.

Returns

Parser<undefined | T>

The current Parser instance.

Inherited from

Parser.optional

Defined in

src/parser.ts:107


parse()

parse(input): T

Parses the input and returns the result.

Parameters

input: unknown

The input to parse.

Returns

T

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<T>

Safely parses the input and returns a result object.

Parameters

input: unknown

The input to parse.

Returns

ParserSafeReturn<T>

An object containing the parsing result or error.

Inherited from

Parser.parseSafe

Defined in

src/parser.ts:72


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


title()

title(title): FunctionParser<T>

Sets a title for the parser.

Parameters

title: string

The title to set.

Returns

FunctionParser<T>

The current Parser instance.

Inherited from

Parser.title

Defined in

src/parser.ts:148