bupkis
    Preparing search index...

    Interface ZodArray<T>

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

    Type Parameters

    Hierarchy (View Summary)

    Index

    Properties

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

    Methods

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

    Properties

    element: T
    def: $ZodArrayDef<T>
    type: "array"

    _def

    _def: $ZodArrayDef<T>

    Use .def instead.

    _output

    _output: z.core.output<T>[]

    Use z.output<typeof schema> instead.

    _input

    _input: z.core.input<T>[]

    Use z.input<typeof schema> instead.

    spa: (
        data: unknown,
        params?: ParseContext<$ZodIssue>,
    ) => Promise<ZodSafeParseResult<z.core.output<T>[]>>
    description?: string

    _zod

    _zod: $ZodArrayInternals
    "~standard": $ZodStandardSchema<z.ZodArray<T>>

    Methods

    • Parameters

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

      Returns this

    • Parameters

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

      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

    • Parameters

      Returns this

    • Returns T

    • Parameters

      Returns this

    • Parameters

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

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

          • Optionalwhen?: (payload: ParsePayload) => boolean

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

          • Optionalpath?: PropertyKey[]
          • Optionalparams?: Record<string, any>
          • Optionalerror?: string | $ZodErrorMap<NonNullable<$ZodIssue>>
          • Optionalmessage?: string

            This parameter is deprecated. Use error instead.

      Returns this

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

      Parameters

      • description: string

      Returns this

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

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

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

      Parameters

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

      Returns this

    • Returns boolean

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

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

    • Returns boolean

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

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

    Settings

    Member Visibility

    On This Page

    Properties
    Methods