Class ZodOptional<T>

Readonly_def

Readonly_input

Readonly_output

Readonly_type

spa

description

• get description(): undefined | string

• Returns undefined | string

_getOrReturnCtx

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

• Parameters

  • input: z.ParseInput
  • Optionalctx: z.ParseContext

  Returns z.ParseContext

_getType

• _getType(input: z.ParseInput): string

• Parameters

  • input: z.ParseInput

  Returns string

_parseAsync

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

• Parameters

  • input: z.ParseInput

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

_parseSync

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

• Parameters

  • input: z.ParseInput

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

_processInputParams

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

• Parameters

  • input: z.ParseInput

  Returns { ctx: z.ParseContext; status: z.ParseStatus }

_refinement

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

• Parameters

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

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

and

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

• Type Parameters

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

  Parameters

  • incoming: T

  Returns z.ZodIntersection<z.ZodOptional<T>, T>

array

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

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

brand

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

• Type Parameters

  • B extends string | number | symbol

  Parameters

  • Optionalbrand: B

  Returns z.ZodBranded<z.ZodOptional<T>, B>

catch

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

• Parameters

  • def: undefined | T["_output"]

  Returns z.ZodCatch<z.ZodOptional<T>>

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

• Parameters

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

  Returns z.ZodCatch<z.ZodOptional<T>>

default

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

• Parameters

  • def: z.util.noUndefined<T["_input"]>

  Returns z.ZodDefault<z.ZodOptional<T>>

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

• Parameters

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

  Returns z.ZodDefault<z.ZodOptional<T>>

describe

• describe(description: string): this

• Parameters

  • description: string

  Returns this

isNullable

• isNullable(): boolean

• Returns boolean

isOptional

• isOptional(): boolean

• Returns boolean

nullable

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

• Returns z.ZodNullable<z.ZodOptional<T>>

nullish

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

• Returns z.ZodOptional<z.ZodNullable<z.ZodOptional<T>>>

optional

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

• Returns z.ZodOptional<z.ZodOptional<T>>

or

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

• Type Parameters

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

  Parameters

  • option: T

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

parse

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

• Parameters

  • data: unknown
  • Optionalparams: Partial<z.ParseParams>

  Returns undefined | T["_output"]

parseAsync

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

• Parameters

  • data: unknown
  • Optionalparams: Partial<z.ParseParams>

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

pipe

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

• Type Parameters

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

  Parameters

  • target: T

  Returns z.ZodPipeline<z.ZodOptional<T>, T>

promise

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

• Returns z.ZodPromise<z.ZodOptional<T>>

readonly

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

• Returns z.ZodReadonly<z.ZodOptional<T>>

refine

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

• Type Parameters

  • RefinedOutput extends any

  Parameters

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

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

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

• Parameters

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

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

refinement

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

• Type Parameters

  • RefinedOutput extends any

  Parameters

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

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

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

• Parameters

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

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

safeParse

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

• Parameters

  • data: unknown
  • Optionalparams: Partial<z.ParseParams>

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

safeParseAsync

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

• Parameters

  • data: unknown
  • Optionalparams: Partial<z.ParseParams>

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

superRefine

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

• Type Parameters

  • RefinedOutput extends any

  Parameters

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

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

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

• Parameters

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

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

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

• Parameters

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

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

transform

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

• Type Parameters

  • NewOut

  Parameters

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

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