Class ZodOptional<T>

Readonly_def

Readonly_input

Readonly_output

Readonly_type

spa

description

• get description(): undefined | string

• Returns undefined | string

_getOrReturnCtx

• _getOrReturnCtx(input: ParseInput, ctx?: ParseContext): ParseContext

• Parameters

  • input: ParseInput
  • Optionalctx: ParseContext

  Returns ParseContext

_getType

• _getType(input: ParseInput): string

• Parameters

  • input: ParseInput

  Returns string

_parseAsync

• _parseAsync(input: ParseInput): AsyncParseReturnType<undefined | T["_output"]>

• Parameters

  • input: ParseInput

  Returns AsyncParseReturnType<undefined | T["_output"]>

_parseSync

• _parseSync(input: ParseInput): SyncParseReturnType<undefined | T["_output"]>

• Parameters

  • input: ParseInput

  Returns SyncParseReturnType<undefined | T["_output"]>

_processInputParams

• _processInputParams(
      input: ParseInput,
  ): { ctx: ParseContext; status: ParseStatus }

• Parameters

  • input: ParseInput

  Returns { ctx: ParseContext; status: ParseStatus }

_refinement

• _refinement(
      refinement: (arg: undefined | T["_output"], ctx: RefinementCtx) => any,
  ): ZodEffects<
      ZodOptional<T>,
      undefined | T["_output"],
      undefined | T["_input"],
  >

• Parameters

  • refinement: (arg: undefined | T["_output"], ctx: RefinementCtx) => any

  Returns ZodEffects<ZodOptional<T>, undefined | T["_output"], undefined | T["_input"]>

and

• and<T extends ZodType<any, any, any, T>>(
      incoming: T,
  ): ZodIntersection<ZodOptional<T>, T>

• Type Parameters

  • T extends ZodType<any, any, any, T>

  Parameters

  • incoming: T

  Returns ZodIntersection<ZodOptional<T>, T>

array

• array(): ZodArray<ZodOptional<T>, "many">

• Returns ZodArray<ZodOptional<T>, "many">

brand

• brand<B extends string | number | symbol>(
      brand?: B,
  ): ZodBranded<ZodOptional<T>, B>

• Type Parameters

  • B extends string | number | symbol

  Parameters

  • Optionalbrand: B

  Returns ZodBranded<ZodOptional<T>, B>

catch

• catch(def: undefined | T["_output"]): ZodCatch<ZodOptional<T>>

• Parameters

  • def: undefined | T["_output"]

  Returns ZodCatch<ZodOptional<T>>

• catch(
      def: (
          ctx: { error: ZodError<any>; input: undefined | T["_input"] },
      ) => undefined | T["_output"],
  ): ZodCatch<ZodOptional<T>>

• Parameters

  • def: (
        ctx: { error: ZodError<any>; input: undefined | T["_input"] },
    ) => undefined | T["_output"]

  Returns ZodCatch<ZodOptional<T>>

default

• default(def: noUndefined<T["_input"]>): ZodDefault<ZodOptional<T>>

• Parameters

  • def: noUndefined<T["_input"]>

  Returns ZodDefault<ZodOptional<T>>

• default(def: () => noUndefined<T["_input"]>): ZodDefault<ZodOptional<T>>

• Parameters

  • def: () => noUndefined<T["_input"]>

  Returns ZodDefault<ZodOptional<T>>

describe

• describe(description: string): this

• Parameters

  • description: string

  Returns this

isNullable

• isNullable(): boolean

• Returns boolean

isOptional

• isOptional(): boolean

• Returns boolean

nullable

• nullable(): ZodNullable<ZodOptional<T>>

• Returns ZodNullable<ZodOptional<T>>

nullish

• nullish(): ZodOptional<ZodNullable<ZodOptional<T>>>

• Returns ZodOptional<ZodNullable<ZodOptional<T>>>

optional

• optional(): ZodOptional<ZodOptional<T>>

• Returns ZodOptional<ZodOptional<T>>

or

• or<T extends ZodType<any, any, any, T>>(
      option: T,
  ): ZodUnion<[ZodOptional<T>, T]>

• Type Parameters

  • T extends ZodType<any, any, any, T>

  Parameters

  • option: T

  Returns ZodUnion<[ZodOptional<T>, T]>

parse

• parse(data: unknown, params?: Partial<ParseParams>): undefined | T["_output"]

• Parameters

  • data: unknown
  • Optionalparams: Partial<ParseParams>

  Returns undefined | T["_output"]

parseAsync

• parseAsync(
      data: unknown,
      params?: Partial<ParseParams>,
  ): Promise<undefined | T["_output"]>

• Parameters

  • data: unknown
  • Optionalparams: Partial<ParseParams>

  Returns Promise<undefined | T["_output"]>

pipe

• pipe<T extends ZodType<any, any, any, T>>(
      target: T,
  ): ZodPipeline<ZodOptional<T>, T>

• Type Parameters

  • T extends ZodType<any, any, any, T>

  Parameters

  • target: T

  Returns ZodPipeline<ZodOptional<T>, T>

promise

• promise(): ZodPromise<ZodOptional<T>>

• Returns ZodPromise<ZodOptional<T>>

readonly

• readonly(): ZodReadonly<ZodOptional<T>>

• Returns ZodReadonly<ZodOptional<T>>

refine

• refine<RefinedOutput extends any>(
      check: (arg: undefined | T["_output"]) => arg is RefinedOutput,
      message?:
          | string
          | Partial<Omit<ZodCustomIssue, "code">>
          | (arg: undefined | T["_output"]) => Partial<Omit<ZodCustomIssue, "code">>,
  ): ZodEffects<ZodOptional<T>, RefinedOutput, undefined | T["_input"]>

• Type Parameters

  • RefinedOutput extends any

  Parameters

  • check: (arg: undefined | T["_output"]) => arg is RefinedOutput
  • Optionalmessage:
        | string
        | Partial<Omit<ZodCustomIssue, "code">>
        | (arg: undefined | T["_output"]) => Partial<Omit<ZodCustomIssue, "code">>

  Returns ZodEffects<ZodOptional<T>, RefinedOutput, undefined | T["_input"]>

• refine(
      check: (arg: undefined | T["_output"]) => unknown,
      message?:
          | string
          | Partial<Omit<ZodCustomIssue, "code">>
          | (arg: undefined | T["_output"]) => Partial<Omit<ZodCustomIssue, "code">>,
  ): ZodEffects<
      ZodOptional<T>,
      undefined | T["_output"],
      undefined | T["_input"],
  >

• Parameters

  • check: (arg: undefined | T["_output"]) => unknown
  • Optionalmessage:
        | string
        | Partial<Omit<ZodCustomIssue, "code">>
        | (arg: undefined | T["_output"]) => Partial<Omit<ZodCustomIssue, "code">>

  Returns ZodEffects<ZodOptional<T>, undefined | T["_output"], undefined | T["_input"]>

refinement

• refinement<RefinedOutput extends any>(
      check: (arg: undefined | T["_output"]) => arg is RefinedOutput,
      refinementData:
          | IssueData
          | (arg: undefined | T["_output"], ctx: RefinementCtx) => IssueData,
  ): ZodEffects<ZodOptional<T>, RefinedOutput, undefined | T["_input"]>

• Type Parameters

  • RefinedOutput extends any

  Parameters

  • check: (arg: undefined | T["_output"]) => arg is RefinedOutput
  • refinementData: IssueData | (arg: undefined | T["_output"], ctx: RefinementCtx) => IssueData

  Returns ZodEffects<ZodOptional<T>, RefinedOutput, undefined | T["_input"]>

• refinement(
      check: (arg: undefined | T["_output"]) => boolean,
      refinementData:
          | IssueData
          | (arg: undefined | T["_output"], ctx: RefinementCtx) => IssueData,
  ): ZodEffects<
      ZodOptional<T>,
      undefined | T["_output"],
      undefined | T["_input"],
  >

• Parameters

  • check: (arg: undefined | T["_output"]) => boolean
  • refinementData: IssueData | (arg: undefined | T["_output"], ctx: RefinementCtx) => IssueData

  Returns ZodEffects<ZodOptional<T>, undefined | T["_output"], undefined | T["_input"]>

safeParse

• safeParse(
      data: unknown,
      params?: Partial<ParseParams>,
  ): SafeParseReturnType<undefined | T["_input"], undefined | T["_output"]>

• Parameters

  • data: unknown
  • Optionalparams: Partial<ParseParams>

  Returns SafeParseReturnType<undefined | T["_input"], undefined | T["_output"]>

safeParseAsync

• safeParseAsync(
      data: unknown,
      params?: Partial<ParseParams>,
  ): Promise<
      SafeParseReturnType<undefined | T["_input"], undefined | T["_output"]>,
  >

• Parameters

  • data: unknown
  • Optionalparams: Partial<ParseParams>

  Returns Promise<SafeParseReturnType<undefined | T["_input"], undefined | T["_output"]>>

superRefine

• superRefine<RefinedOutput extends any>(
      refinement: (
          arg: undefined | T["_output"],
          ctx: RefinementCtx,
      ) => arg is RefinedOutput,
  ): ZodEffects<ZodOptional<T>, RefinedOutput, undefined | T["_input"]>

• Type Parameters

  • RefinedOutput extends any

  Parameters

  • refinement: (arg: undefined | T["_output"], ctx: RefinementCtx) => arg is RefinedOutput

  Returns ZodEffects<ZodOptional<T>, RefinedOutput, undefined | T["_input"]>

• superRefine(
      refinement: (arg: undefined | T["_output"], ctx: RefinementCtx) => void,
  ): ZodEffects<
      ZodOptional<T>,
      undefined | T["_output"],
      undefined | T["_input"],
  >

• Parameters

  • refinement: (arg: undefined | T["_output"], ctx: RefinementCtx) => void

  Returns ZodEffects<ZodOptional<T>, undefined | T["_output"], undefined | T["_input"]>

• superRefine(
      refinement: (
          arg: undefined | T["_output"],
          ctx: RefinementCtx,
      ) => Promise<void>,
  ): ZodEffects<
      ZodOptional<T>,
      undefined | T["_output"],
      undefined | T["_input"],
  >

• Parameters

  • refinement: (arg: undefined | T["_output"], ctx: RefinementCtx) => Promise<void>

  Returns ZodEffects<ZodOptional<T>, undefined | T["_output"], undefined | T["_input"]>

transform

• transform<NewOut>(
      transform: (
          arg: undefined | T["_output"],
          ctx: RefinementCtx,
      ) => NewOut | Promise<NewOut>,
  ): ZodEffects<ZodOptional<T>, NewOut, undefined | T["_input"]>

• Type Parameters

  • NewOut

  Parameters

  • transform: (arg: undefined | T["_output"], ctx: RefinementCtx) => NewOut | Promise<NewOut>

  Returns ZodEffects<ZodOptional<T>, NewOut, undefined | T["_input"]>