Class ZodUnion<T>

constructor

• new ZodUnion<T>(def): ZodUnion<T>

• Type Parameters

  • T extends readonly [ZodTypeAny, ZodTypeAny]

  Parameters

  • def: ZodUnionDef<T>

  Returns ZodUnion<T>

Readonly _def

Readonly _input

Readonly _output

Readonly _type

spa

description

• get description(): undefined | string

• Returns undefined | string

_getOrReturnCtx

• _getOrReturnCtx(input, ctx?): ParseContext

• Parameters

  • input: ParseInput
  • Optional ctx: ParseContext

  Returns ParseContext

_getType

• _getType(input): string

• Parameters

  • input: ParseInput

  Returns string

_parseAsync

• _parseAsync(input): AsyncParseReturnType<T[number]["_output"]>

• Parameters

  • input: ParseInput

  Returns AsyncParseReturnType<T[number]["_output"]>

_parseSync

• _parseSync(input): SyncParseReturnType<T[number]["_output"]>

• Parameters

  • input: ParseInput

  Returns SyncParseReturnType<T[number]["_output"]>

_processInputParams

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

• Parameters

  • input: ParseInput

  Returns {
      ctx: ParseContext;
      status: ParseStatus;
  }

  • ctx: ParseContext

  • status: ParseStatus

_refinement

• _refinement(refinement): ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

• Parameters

  • refinement: ((arg, ctx) => any)
    • • (arg, ctx): any

      • Parameters

        • arg: T[number]["_output"]
        • ctx: RefinementCtx

        Returns any

  Returns ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

and

• and<T>(incoming): ZodIntersection<ZodUnion<T>, T>

• Type Parameters

  • T extends ZodTypeAny

  Parameters

  • incoming: T

  Returns ZodIntersection<ZodUnion<T>, T>

array

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

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

brand

• brand<B>(brand?): ZodBranded<ZodUnion<T>, B>

• Type Parameters

  • B extends string | number | symbol

  Parameters

  • Optional brand: B

  Returns ZodBranded<ZodUnion<T>, B>

catch

• catch(def): ZodCatch<ZodUnion<T>>

• Parameters

  • def: T[number]["_output"]

  Returns ZodCatch<ZodUnion<T>>

• catch(def): ZodCatch<ZodUnion<T>>

• Parameters

  • def: ((ctx) => T[number]["_output"])
    • • (ctx): T[number]["_output"]

      • Parameters

        • ctx: {
              error: ZodError<any>;
              input: T[number]["_input"];
          }

          • error: ZodError<any>

          • input: T[number]["_input"]

        Returns T[number]["_output"]

  Returns ZodCatch<ZodUnion<T>>

default

• default(def): ZodDefault<ZodUnion<T>>

• Parameters

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

  Returns ZodDefault<ZodUnion<T>>

• default(def): ZodDefault<ZodUnion<T>>

• Parameters

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

      • Returns noUndefined<T[number]["_input"]>

  Returns ZodDefault<ZodUnion<T>>

describe

• describe(description): this

• Parameters

  • description: string

  Returns this

isNullable

• isNullable(): boolean

• Returns boolean

isOptional

• isOptional(): boolean

• Returns boolean

nullable

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

• Returns ZodNullable<ZodUnion<T>>

nullish

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

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

optional

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

• Returns ZodOptional<ZodUnion<T>>

or

• or<T>(option): ZodUnion<[ZodUnion<T>, T]>

• Type Parameters

  • T extends ZodTypeAny

  Parameters

  • option: T

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

parse

• parse(data, params?): T[number]["_output"]

• Parameters

  • data: unknown
  • Optional params: Partial<ParseParams>

  Returns T[number]["_output"]

parseAsync

• parseAsync(data, params?): Promise<T[number]["_output"]>

• Parameters

  • data: unknown
  • Optional params: Partial<ParseParams>

  Returns Promise<T[number]["_output"]>

pipe

• pipe<T>(target): ZodPipeline<ZodUnion<T>, T>

• Type Parameters

  • T extends ZodTypeAny

  Parameters

  • target: T

  Returns ZodPipeline<ZodUnion<T>, T>

promise

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

• Returns ZodPromise<ZodUnion<T>>

readonly

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

• Returns ZodReadonly<ZodUnion<T>>

refine

• refine<RefinedOutput>(check, message?): ZodEffects<ZodUnion<T>, RefinedOutput, T[number]["_input"]>

• Type Parameters

  • RefinedOutput extends any

  Parameters

  • check: ((arg) => arg is RefinedOutput)
    • • (arg): arg is RefinedOutput

      • Parameters

        • arg: T[number]["_output"]

        Returns arg is RefinedOutput

  • Optional message: string | Partial<Omit<ZodCustomIssue, "code">> | ((arg) => Partial<Omit<ZodCustomIssue, "code">>)

  Returns ZodEffects<ZodUnion<T>, RefinedOutput, T[number]["_input"]>

• refine(check, message?): ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

• Parameters

  • check: ((arg) => unknown)
    • • (arg): unknown

      • Parameters

        • arg: T[number]["_output"]

        Returns unknown

  • Optional message: string | Partial<Omit<ZodCustomIssue, "code">> | ((arg) => Partial<Omit<ZodCustomIssue, "code">>)

  Returns ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

refinement

• refinement<RefinedOutput>(check, refinementData): ZodEffects<ZodUnion<T>, RefinedOutput, T[number]["_input"]>

• Type Parameters

  • RefinedOutput extends any

  Parameters

  • check: ((arg) => arg is RefinedOutput)
    • • (arg): arg is RefinedOutput

      • Parameters

        • arg: T[number]["_output"]

        Returns arg is RefinedOutput

  • refinementData: IssueData | ((arg, ctx) => IssueData)

  Returns ZodEffects<ZodUnion<T>, RefinedOutput, T[number]["_input"]>

• refinement(check, refinementData): ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

• Parameters

  • check: ((arg) => boolean)
    • • (arg): boolean

      • Parameters

        • arg: T[number]["_output"]

        Returns boolean

  • refinementData: IssueData | ((arg, ctx) => IssueData)

  Returns ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

safeParse

• safeParse(data, params?): SafeParseReturnType<T[number]["_input"], T[number]["_output"]>

• Parameters

  • data: unknown
  • Optional params: Partial<ParseParams>

  Returns SafeParseReturnType<T[number]["_input"], T[number]["_output"]>

safeParseAsync

• safeParseAsync(data, params?): Promise<SafeParseReturnType<T[number]["_input"], T[number]["_output"]>>

• Parameters

  • data: unknown
  • Optional params: Partial<ParseParams>

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

superRefine

• superRefine<RefinedOutput>(refinement): ZodEffects<ZodUnion<T>, RefinedOutput, T[number]["_input"]>

• Type Parameters

  • RefinedOutput extends any

  Parameters

  • refinement: ((arg, ctx) => arg is RefinedOutput)
    • • (arg, ctx): arg is RefinedOutput

      • Parameters

        • arg: T[number]["_output"]
        • ctx: RefinementCtx

        Returns arg is RefinedOutput

  Returns ZodEffects<ZodUnion<T>, RefinedOutput, T[number]["_input"]>

• superRefine(refinement): ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

• Parameters

  • refinement: ((arg, ctx) => void)
    • • (arg, ctx): void

      • Parameters

        • arg: T[number]["_output"]
        • ctx: RefinementCtx

        Returns void

  Returns ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

• superRefine(refinement): ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

• Parameters

  • refinement: ((arg, ctx) => Promise<void>)
    • • (arg, ctx): Promise<void>

      • Parameters

        • arg: T[number]["_output"]
        • ctx: RefinementCtx

        Returns Promise<void>

  Returns ZodEffects<ZodUnion<T>, T[number]["_output"], T[number]["_input"]>

transform

• transform<NewOut>(transform): ZodEffects<ZodUnion<T>, NewOut, T[number]["_input"]>

• Type Parameters

  • NewOut

  Parameters

  • transform: ((arg, ctx) => NewOut | Promise<NewOut>)
    • • (arg, ctx): NewOut | Promise<NewOut>

      • Parameters

        • arg: T[number]["_output"]
        • ctx: RefinementCtx

        Returns NewOut | Promise<NewOut>

  Returns ZodEffects<ZodUnion<T>, NewOut, T[number]["_input"]>