@traversable/schema
    Preparing search index...

    Interface ZodArray

    interface ZodArray {
        _def: $ZodArrayDef<
            $ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>,
        >;
        _input: unknown[];
        _output: unknown[];
        _zod: $ZodArrayInternals;
        "~standard": $ZodStandardSchema<ZodArray>;
        def: $ZodArrayDef<
            $ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>,
        >;
        description?: string;
        element: $ZodType;
        spa: (
            data: unknown,
            params?: ParseContext<$ZodIssue>,
        ) => Promise<ZodSafeParseResult<unknown[]>>;
        type: "array";
        and<T extends SomeType>(incoming: T): ZodIntersection<ZodArray, T>;
        array(): ZodArray<ZodArray>;
        brand<T extends PropertyKey = PropertyKey>(
            value?: T,
        ): PropertyKey extends T ? ZodArray : $ZodBranded<ZodArray, T>;
        catch(def: unknown[]): ZodCatch<ZodArray>;
        catch(def: (ctx: $ZodCatchCtx) => unknown[]): ZodCatch<ZodArray>;
        check(...checks: (CheckFn<unknown[]> | $ZodCheck<unknown[]>)[]): this;
        clone(
            def?: $ZodArrayDef<
                $ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>,
            >,
            params?: { parent: boolean },
        ): this;
        default(def: unknown[]): ZodDefault<ZodArray>;
        default(def: () => unknown[]): ZodDefault<ZodArray>;
        describe(description: string): this;
        isNullable(): boolean;
        isOptional(): boolean;
        length(
            len: number,
            params?:
                | string
                | {
                    abort?: boolean;
                    error?: | string
                    | $ZodErrorMap<
                        NonNullable<
                            $ZodIssueTooSmall<HasLength>
                            | $ZodIssueTooBig<HasLength>,
                        >,
                    >;
                    message?: string;
                },
        ): this;
        max(
            maxLength: number,
            params?:
                | string
                | {
                    abort?: boolean;
                    error?: string
                    | $ZodErrorMap<$ZodIssueTooBig<HasLength>>;
                    message?: string;
                },
        ): this;
        meta(): | undefined
        | {
            deprecated?: boolean;
            description?: string;
            id?: string;
            title?: string;
            [key: string]: unknown;
        };
        meta(
            data: {
                deprecated?: boolean;
                description?: string;
                id?: string;
                title?: string;
                [key: string]: unknown;
            },
        ): this;
        min(
            minLength: number,
            params?:
                | string
                | {
                    abort?: boolean;
                    error?: string
                    | $ZodErrorMap<$ZodIssueTooSmall<HasLength>>;
                    message?: string;
                },
        ): this;
        nonempty(
            params?:
                | string
                | {
                    abort?: boolean;
                    error?: string
                    | $ZodErrorMap<$ZodIssueTooSmall<HasLength>>;
                    message?: string;
                },
        ): this;
        nonoptional(
            params?:
                | string
                | {
                    error?: string
                    | $ZodErrorMap<$ZodIssueInvalidType<unknown>>;
                    message?: string;
                },
        ): ZodNonOptional<ZodArray>;
        nullable(): ZodNullable<ZodArray>;
        nullish(): ZodOptional<ZodNullable<ZodArray>>;
        optional(): ZodOptional<ZodArray>;
        or<T extends SomeType>(option: T): ZodUnion<[ZodArray, T]>;
        overwrite(fn: (x: unknown[]) => unknown[]): this;
        parse(data: unknown, params?: ParseContext<$ZodIssue>): unknown[];
        parseAsync(
            data: unknown,
            params?: ParseContext<$ZodIssue>,
        ): Promise<unknown[]>;
        pipe<T extends $ZodType<any, unknown[], $ZodTypeInternals<any, unknown[]>>>(
            target: T | $ZodType<any, unknown[], $ZodTypeInternals<any, unknown[]>>,
        ): ZodPipe<ZodArray, T>;
        prefault(def: () => unknown[]): ZodPrefault<ZodArray>;
        prefault(def: unknown[]): ZodPrefault<ZodArray>;
        readonly(): ZodReadonly<ZodArray>;
        refine(
            check: (arg: unknown[]) => unknown,
            params?:
                | string
                | {
                    abort?: boolean;
                    error?: string
                    | $ZodErrorMap<NonNullable<$ZodIssue>>;
                    message?: string;
                    params?: Record<string, any>;
                    path?: PropertyKey[];
                    when?: (payload: ParsePayload) => boolean;
                },
        ): this;
        register<
            R extends
                $ZodRegistry<
                    MetadataType,
                    $ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>,
                >,
        >(
            registry: R,
            ...meta: ZodArray extends R["_schema"]
                ? undefined extends R["_meta"]
                    ? [$replace<R["_meta"], R["_schema"] & ZodArray>?]
                    : [$replace<R["_meta"], R["_schema"] & ZodArray>]
                : ["Incompatible schema"],
        ): this;
        safeParse(
            data: unknown,
            params?: ParseContext<$ZodIssue>,
        ): ZodSafeParseResult<unknown[]>;
        safeParseAsync(
            data: unknown,
            params?: ParseContext<$ZodIssue>,
        ): Promise<ZodSafeParseResult<unknown[]>>;
        superRefine(
            refinement: (
                arg: unknown[],
                ctx: RefinementCtx<unknown[]>,
            ) => void | Promise<void>,
        ): this;
        transform<NewOut>(
            transform: (
                arg: unknown[],
                ctx: RefinementCtx<unknown[]>,
            ) => NewOut | Promise<NewOut>,
        ): ZodPipe<ZodArray, ZodTransform<Awaited<NewOut>, unknown[]>>;
        unwrap(): $ZodType;
    }

    Hierarchy

    • ZodArray
      • ZodArray
    Index

    Properties

    _def _input _output _zod ~standard def description? element spa type

    Methods

    and array brand catch check clone default describe isNullable isOptional length max meta min nonempty nonoptional nullable nullish optional or overwrite parse parseAsync pipe prefault readonly refine register safeParse safeParseAsync superRefine transform unwrap

    Properties

    _def

    _def: $ZodArrayDef<
        $ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>,
    >

    Use .def instead.

    _input

    _input: unknown[]

    Use z.input<typeof schema> instead.

    _output

    _output: unknown[]

    Use z.output<typeof schema> instead.

    _zod

    _zod: $ZodArrayInternals
    "~standard": $ZodStandardSchema<ZodArray>
    def: $ZodArrayDef<
        $ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>,
    >
    description?: string
    element: $ZodType
    spa: (
        data: unknown,
        params?: ParseContext<$ZodIssue>,
    ) => Promise<ZodSafeParseResult<unknown[]>>
    type: "array"

    Methods

    • Type Parameters

      • T extends SomeType

      Parameters

      • incoming: T

      Returns ZodIntersection<ZodArray, T>

    • Returns ZodArray<ZodArray>

    • Type Parameters

      • T extends PropertyKey = PropertyKey

      Parameters

      • Optionalvalue: T

      Returns PropertyKey extends T ? ZodArray : $ZodBranded<ZodArray, T>

    • Parameters

      • def: unknown[]

      Returns ZodCatch<ZodArray>

    • Parameters

      • def: (ctx: $ZodCatchCtx) => unknown[]

      Returns ZodCatch<ZodArray>

    • Parameters

      • ...checks: (CheckFn<unknown[]> | $ZodCheck<unknown[]>)[]

      Returns this

    • Parameters

      • Optionaldef: $ZodArrayDef<$ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>>
      • Optionalparams: { parent: boolean }

      Returns this

    • Parameters

      • def: unknown[]

      Returns ZodDefault<ZodArray>

    • Parameters

      • def: () => unknown[]

      Returns ZodDefault<ZodArray>

    • Returns a new instance that has been registered in z.globalRegistry with the specified description

      Parameters

      • description: string

      Returns this

    • Returns boolean

      Try safe-parsing null (this is what isNullable does internally):

      const schema = z.string().nullable();
      const isNullable = schema.safeParse(null).success; // true

    • Returns boolean

      Try safe-parsing undefined (this is what isOptional does internally):

      const schema = z.string().optional();
      const isOptional = schema.safeParse(undefined).success; // true

    • Parameters

      • len: number
      • Optionalparams:
            | string
            | {
                abort?: boolean;
                error?: | string
                | $ZodErrorMap<
                    NonNullable<$ZodIssueTooSmall<HasLength> | $ZodIssueTooBig<HasLength>>,
                >;
                message?: string;
            }
        • string
        • {
              abort?: boolean;
              error?:
                  | string
                  | $ZodErrorMap<
                      NonNullable<$ZodIssueTooSmall<HasLength> | $ZodIssueTooBig<HasLength>>,
                  >;
              message?: string;
          }
          • Optionalabort?: boolean

            If true, no later checks will be executed if this check fails. Default false.

          • Optionalerror?:
                | string
                | $ZodErrorMap<
                    NonNullable<$ZodIssueTooSmall<HasLength> | $ZodIssueTooBig<HasLength>>,
                >
          • Optionalmessage?: string

            This parameter is deprecated. Use error instead.

      Returns this

    • Parameters

      • maxLength: number
      • Optionalparams:
            | string
            | {
                abort?: boolean;
                error?: string
                | $ZodErrorMap<$ZodIssueTooBig<HasLength>>;
                message?: string;
            }
        • string
        • {
              abort?: boolean;
              error?: string | $ZodErrorMap<$ZodIssueTooBig<HasLength>>;
              message?: string;
          }
          • Optionalabort?: boolean

            If true, no later checks will be executed if this check fails. Default false.

          • Optionalerror?: string | $ZodErrorMap<$ZodIssueTooBig<HasLength>>
          • Optionalmessage?: string

            This parameter is deprecated. Use error instead.

      Returns this

    • Returns the metadata associated with this instance in z.globalRegistry

      Returns
          | undefined
          | {
              deprecated?: boolean;
              description?: string;
              id?: string;
              title?: string;
              [key: string]: unknown;
          }

    • Returns a new instance that has been registered in z.globalRegistry with the specified metadata

      Parameters

      • data: {
            deprecated?: boolean;
            description?: string;
            id?: string;
            title?: string;
            [key: string]: unknown;
        }

      Returns this

    • Parameters

      • minLength: number
      • Optionalparams:
            | string
            | {
                abort?: boolean;
                error?: string
                | $ZodErrorMap<$ZodIssueTooSmall<HasLength>>;
                message?: string;
            }
        • string
        • {
              abort?: boolean;
              error?: string | $ZodErrorMap<$ZodIssueTooSmall<HasLength>>;
              message?: string;
          }
          • Optionalabort?: boolean

            If true, no later checks will be executed if this check fails. Default false.

          • Optionalerror?: string | $ZodErrorMap<$ZodIssueTooSmall<HasLength>>
          • Optionalmessage?: string

            This parameter is deprecated. Use error instead.

      Returns this

    • Parameters

      • Optionalparams:
            | string
            | {
                abort?: boolean;
                error?: string
                | $ZodErrorMap<$ZodIssueTooSmall<HasLength>>;
                message?: string;
            }
        • string
        • {
              abort?: boolean;
              error?: string | $ZodErrorMap<$ZodIssueTooSmall<HasLength>>;
              message?: string;
          }
          • Optionalabort?: boolean

            If true, no later checks will be executed if this check fails. Default false.

          • Optionalerror?: string | $ZodErrorMap<$ZodIssueTooSmall<HasLength>>
          • Optionalmessage?: string

            This parameter is deprecated. Use error instead.

      Returns this

    • Parameters

      • Optionalparams:
            | string
            | {
                error?: string
                | $ZodErrorMap<$ZodIssueInvalidType<unknown>>;
                message?: string;
            }
        • string
        • {
              error?: string | $ZodErrorMap<$ZodIssueInvalidType<unknown>>;
              message?: string;
          }
          • Optionalerror?: string | $ZodErrorMap<$ZodIssueInvalidType<unknown>>
          • Optionalmessage?: string

            This parameter is deprecated. Use error instead.

      Returns ZodNonOptional<ZodArray>

    • Returns ZodNullable<ZodArray>

    • Returns ZodOptional<ZodNullable<ZodArray>>

    • Returns ZodOptional<ZodArray>

    • Type Parameters

      • T extends SomeType

      Parameters

      • option: T

      Returns ZodUnion<[ZodArray, T]>

    • Parameters

      • fn: (x: unknown[]) => unknown[]

      Returns this

    • Parameters

      • data: unknown
      • Optionalparams: ParseContext<$ZodIssue>

      Returns unknown[]

    • Parameters

      • data: unknown
      • Optionalparams: ParseContext<$ZodIssue>

      Returns Promise<unknown[]>

    • Type Parameters

      • T extends $ZodType<any, unknown[], $ZodTypeInternals<any, unknown[]>>

      Parameters

      • target: T | $ZodType<any, unknown[], $ZodTypeInternals<any, unknown[]>>

      Returns ZodPipe<ZodArray, T>

    • Parameters

      • def: () => unknown[]

      Returns ZodPrefault<ZodArray>

    • Parameters

      • def: unknown[]

      Returns ZodPrefault<ZodArray>

    • Returns ZodReadonly<ZodArray>

    • Parameters

      • check: (arg: unknown[]) => unknown
      • Optionalparams:
            | string
            | {
                abort?: boolean;
                error?: string
                | $ZodErrorMap<NonNullable<$ZodIssue>>;
                message?: string;
                params?: Record<string, any>;
                path?: PropertyKey[];
                when?: (payload: ParsePayload) => boolean;
            }
        • string
        • {
              abort?: boolean;
              error?: string | $ZodErrorMap<NonNullable<$ZodIssue>>;
              message?: string;
              params?: Record<string, any>;
              path?: PropertyKey[];
              when?: (payload: ParsePayload) => boolean;
          }
          • Optionalabort?: boolean

            If true, no later checks will be executed if this check fails. Default false.

          • Optionalerror?: string | $ZodErrorMap<NonNullable<$ZodIssue>>
          • Optionalmessage?: string

            This parameter is deprecated. Use error instead.

          • Optionalparams?: Record<string, any>
          • Optionalpath?: PropertyKey[]
          • Optionalwhen?: (payload: ParsePayload) => boolean

            If provided, this check will only be executed if the function returns true. Defaults to payload => z.util.isAborted(payload).

      Returns this

    • Type Parameters

      • R extends $ZodRegistry<
            MetadataType,
            $ZodType<unknown, unknown, $ZodTypeInternals<unknown, unknown>>,
        >

      Parameters

      • registry: R
      • ...meta: ZodArray extends R["_schema"]
            ? undefined extends R["_meta"]
                ? [$replace<R["_meta"], R["_schema"] & ZodArray>?]
                : [$replace<R["_meta"], R["_schema"] & ZodArray>]
            : ["Incompatible schema"]

      Returns this

    • Parameters

      • data: unknown
      • Optionalparams: ParseContext<$ZodIssue>

      Returns ZodSafeParseResult<unknown[]>

    • Parameters

      • data: unknown
      • Optionalparams: ParseContext<$ZodIssue>

      Returns Promise<ZodSafeParseResult<unknown[]>>

    • Parameters

      • refinement: (arg: unknown[], ctx: RefinementCtx<unknown[]>) => void | Promise<void>

      Returns this

      Use .check() instead.

    • Type Parameters

      • NewOut

      Parameters

      • transform: (arg: unknown[], ctx: RefinementCtx<unknown[]>) => NewOut | Promise<NewOut>

      Returns ZodPipe<ZodArray, ZodTransform<Awaited<NewOut>, unknown[]>>

    • Returns $ZodType

    Settings

    Member Visibility

    On This Page

    Properties
    Methods