Class ZodNullable<T>

constructor

• new ZodNullable<T extends ZodTypeAny>(def: ZodNullableDef): ZodNullable<T>

  Type Parameters

  • T extends ZodTypeAny

  Parameters

  • def: ZodNullableDef

  Returns ZodNullable<T>

Readonly_def

Readonly_input

Readonly_output

Readonly_type

~standard

spa

Staticcreate

description

• get description(): string | undefined

  Returns string | undefined

_getOrReturnCtx

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

  Parameters

  • input: ParseInput
  • Optionalctx: ParseContext

  Returns ParseContext

_getType

• _getType(input: ParseInput): string

  Parameters

  • input: ParseInput

  Returns string

_parse

• _parse(input: ParseInput): ParseReturnType<T["_output"] | null>

  Parameters

  • input: ParseInput

  Returns ParseReturnType<T["_output"] | null>

_parseAsync

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

  Parameters

  • input: ParseInput

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

_parseSync

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

  Parameters

  • input: ParseInput

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

_processInputParams

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

  Parameters

  • input: ParseInput

  Returns { ctx: ParseContext; status: ParseStatus }

_refinement

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

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, T["_output"] | null, T["_input"] | null>

~validate

• "~validate"(
      data: unknown,
  ): Result<T["_output"] | null> | Promise<Result<T["_output"] | null>>

  Parameters

  • data: unknown

  Returns Result<T["_output"] | null> | Promise<Result<T["_output"] | null>>

and

• and<T extends ZodTypeAny>(incoming: T): ZodIntersection<ZodNullable<T>, T>

  Type Parameters

  • T extends ZodTypeAny

  Parameters

  • incoming: T

  Returns ZodIntersection<ZodNullable<T>, T>

array

• array(): ZodArray<ZodNullable<T>>

  Returns ZodArray<ZodNullable<T>>

brand

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

  Type Parameters

  • B extends string | number | symbol

  Parameters

  • Optionalbrand: B

  Returns ZodBranded<ZodNullable<T>, B>

catch

• catch(def: T["_output"] | null): ZodCatch<ZodNullable<T>>

  Parameters

  • def: T["_output"] | null

  Returns ZodCatch<ZodNullable<T>>

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

  Parameters

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

  Returns ZodCatch<ZodNullable<T>>

default

• default(def: noUndefined<T["_input"]> | null): ZodDefault<ZodNullable<T>>

  Parameters

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

  Returns ZodDefault<ZodNullable<T>>

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

  Parameters

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

  Returns ZodDefault<ZodNullable<T>>

describe

• describe(description: string): this

  Parameters

  • description: string

  Returns this

isNullable

• isNullable(): boolean

  Returns boolean

isOptional

• isOptional(): boolean

  Returns boolean

nullable

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

  Returns ZodNullable<ZodNullable<T>>

nullish

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

  Returns ZodOptional<ZodNullable<ZodNullable<T>>>

optional

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

  Returns ZodOptional<ZodNullable<T>>

or

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

  Type Parameters

  • T extends ZodTypeAny

  Parameters

  • option: T

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

parse

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

  Parameters

  • data: unknown
  • Optionalparams: InexactPartial<ParseParams>

  Returns T["_output"] | null

parseAsync

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

  Parameters

  • data: unknown
  • Optionalparams: InexactPartial<ParseParams>

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

pipe

• pipe<T extends ZodTypeAny>(target: T): ZodPipeline<ZodNullable<T>, T>

  Type Parameters

  • T extends ZodTypeAny

  Parameters

  • target: T

  Returns ZodPipeline<ZodNullable<T>, T>

promise

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

  Returns ZodPromise<ZodNullable<T>>

readonly

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

  Returns ZodReadonly<ZodNullable<T>>

refine

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

  Type Parameters

  • RefinedOutput extends any

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, RefinedOutput, T["_input"] | null>

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

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, T["_output"] | null, T["_input"] | null>

refinement

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

  Type Parameters

  • RefinedOutput extends any

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, RefinedOutput, T["_input"] | null>

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

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, T["_output"] | null, T["_input"] | null>

safeParse

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

  Parameters

  • data: unknown
  • Optionalparams: InexactPartial<ParseParams>

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

safeParseAsync

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

  Parameters

  • data: unknown
  • Optionalparams: InexactPartial<ParseParams>

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

superRefine

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

  Type Parameters

  • RefinedOutput extends any

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, RefinedOutput, T["_input"] | null>

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

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, T["_output"] | null, T["_input"] | null>

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

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, T["_output"] | null, T["_input"] | null>

transform

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

  Type Parameters

  • NewOut

  Parameters

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

  Returns ZodEffects<ZodNullable<T>, NewOut>

unwrap

• unwrap(): T

  Returns T