Class ZodString

Hierarchy (View Summary)

ZodType<string, ZodStringDef>
- ZodString

Constructors

constructor

new ZodString(def: ZodStringDef): ZodString
Parameters
- def: ZodStringDef
Returns ZodString
Inherited from ZodType.constructor
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:73

Properties

`Readonly`_def

_def: ZodStringDef

`Readonly`_input

_input: string

`Readonly`_output

_output: string

`Readonly`_type

_type: string

spa

spa: (
data: unknown,
params?: Partial<ParseParams>,
) => Promise<SafeParseReturnType<string, string>>

Alias of safeParseAsync

`Static`create

create: (
    params?: {
        description?: string;
        errorMap?: ZodErrorMap;
        invalid_type_error?: string;
        required_error?: string;
    } & { coerce?: true },
) => ZodString

Accessors

description

get description(): string | undefined
Returns string | undefined
Inherited from ZodType.description
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:49

isCUID

get isCUID(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:214

isCUID2

get isCUID2(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:215

isDatetime

get isDatetime(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:209

isEmail

get isEmail(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:210

isEmoji

get isEmoji(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:212

isIP

get isIP(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:217

isULID

get isULID(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:216

isURL

get isURL(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:211

isUUID

get isUUID(): boolean
Returns boolean
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:213

maxLength

get maxLength(): number | null
Returns number | null
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:219

minLength

get minLength(): number | null
Returns number | null
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:218

Methods

_addCheck

_addCheck(check: ZodStringCheck): ZodString
Parameters
- check: ZodStringCheck
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:174

_getOrReturnCtx

_getOrReturnCtx(input: ParseInput, ctx?: ParseContext): ParseContext
Parameters
- input: ParseInput
- Optionalctx: ParseContext
Returns ParseContext
Inherited from ZodType._getOrReturnCtx
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:52

_getType

_getType(input: ParseInput): string
Parameters
- input: ParseInput
Returns string
Inherited from ZodType._getType
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:51

_parse

_parse(input: ParseInput): ParseReturnType<string>
Parameters
- input: ParseInput
Returns ParseReturnType<string>
Overrides ZodType._parse
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:172

_parseAsync

_parseAsync(input: ParseInput): AsyncParseReturnType<string>
Parameters
- input: ParseInput
Returns AsyncParseReturnType<string>
Inherited from ZodType._parseAsync
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:58

_parseSync

_parseSync(input: ParseInput): SyncParseReturnType<string>
Parameters
- input: ParseInput
Returns SyncParseReturnType<string>
Inherited from ZodType._parseSync
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:57

_processInputParams

_processInputParams(
input: ParseInput,
): { ctx: ParseContext; status: ParseStatus }
Parameters
- input: ParseInput
Returns { ctx: ParseContext; status: ParseStatus }
Inherited from ZodType._processInputParams
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:53

_refinement

_refinement(
refinement: (arg: string, ctx: RefinementCtx) => any,
): ZodEffects<ZodString, string, string>
Parameters
- refinement: (arg: string, ctx: RefinementCtx) => any
Returns ZodEffects<ZodString, string, string>
Inherited from ZodType._refinement
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:69

`Protected`_regex

_regex(
    regex: RegExp,
    validation: StringValidation,
    message?: ErrMessage,
): ZodEffects<ZodString, string, string>
Parameters
- regex: RegExp
- validation: StringValidation
- Optionalmessage: ErrMessage
Returns ZodEffects<ZodString, string, string>
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:173

and

and<T extends ZodTypeAny>(incoming: T): ZodIntersection<ZodString, T>
Type Parameters
- T extends ZodTypeAny
Parameters
- incoming: T
Returns ZodIntersection<ZodString, T>
Inherited from ZodType.and
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:80

array

array(): ZodArray<ZodString>
Returns ZodArray<ZodString>
Inherited from ZodType.array
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:77

brand

brand<B extends string | number | symbol>(brand?: B): ZodBranded<ZodString, B>
Type Parameters
- B extends string | number | symbol
Parameters
- Optionalbrand: B
Returns ZodBranded<ZodString, B>
Inherited from ZodType.brand
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:84

catch

catch(def: string): ZodCatch<ZodString>
Parameters
- def: string
Returns ZodCatch<ZodString>
Inherited from ZodType.catch
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:85
catch(
def: (ctx: { error: ZodError; input: string }) => string,
): ZodCatch<ZodString>
Parameters
- def: (ctx: { error: ZodError; input: string }) => string
Returns ZodCatch<ZodString>
Inherited from ZodType.catch
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:86

cuid

cuid(message?: ErrMessage): ZodString
Parameters
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:179

cuid2

cuid2(message?: ErrMessage): ZodString
Parameters
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:180

datetime

datetime(
    options?:
        | string
        | { message?: string; offset?: boolean; precision?: number
        | null },
): ZodString
Parameters
- Optionaloptions: string | { message?: string; offset?: boolean; precision?: number | null }
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:186

default

default(def: string): ZodDefault<ZodString>
Parameters
- def: string
Returns ZodDefault<ZodString>
Inherited from ZodType.default
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:82
default(def: () => string): ZodDefault<ZodString>
Parameters
- def: () => string
Returns ZodDefault<ZodString>
Inherited from ZodType.default
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:83

describe

describe(description: string): this
Parameters
- description: string
Returns this
Inherited from ZodType.describe
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:90

email

email(message?: ErrMessage): ZodString
Parameters
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:175

emoji

emoji(message?: ErrMessage): ZodString
Parameters
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:177

endsWith

endsWith(value: string, message?: ErrMessage): ZodString
Parameters
- value: string
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:197

includes

includes(
value: string,
options?: { message?: string; position?: number },
): ZodString
Parameters
- value: string
- Optionaloptions: { message?: string; position?: number }
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:192

ip

ip(options?: string | { message?: string; version?: "v4" | "v6" }): ZodString
Parameters
- Optionaloptions: string | { message?: string; version?: "v4" | "v6" }
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:182

isNullable

isNullable(): boolean
Returns boolean
Inherited from ZodType.isNullable
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:94

isOptional

isOptional(): boolean
Returns boolean
Inherited from ZodType.isOptional
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:93

length

length(len: number, message?: ErrMessage): ZodString
Parameters
- len: number
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:200

max

max(maxLength: number, message?: ErrMessage): ZodString
Parameters
- maxLength: number
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:199

min

min(minLength: number, message?: ErrMessage): ZodString
Parameters
- minLength: number
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:198

nonempty

nonempty(message?: ErrMessage): ZodString
Parameters
- Optionalmessage: ErrMessage
Returns ZodString
Deprecated
Use z.string().min(1) instead.

See
ZodString.min
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:205

nullable

nullable(): ZodNullable<ZodString>
Returns ZodNullable<ZodString>
Inherited from ZodType.nullable
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:75

nullish

nullish(): ZodOptional<ZodNullable<ZodString>>
Returns ZodOptional<ZodNullable<ZodString>>
Inherited from ZodType.nullish
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:76

optional

optional(): ZodOptional<ZodString>
Returns ZodOptional<ZodString>
Inherited from ZodType.optional
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:74

or

or<T extends ZodTypeAny>(option: T): ZodUnion<[ZodString, T]>
Type Parameters
- T extends ZodTypeAny
Parameters
- option: T
Returns ZodUnion<[ZodString, T]>
Inherited from ZodType.or
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:79

parse

parse(data: unknown, params?: Partial<ParseParams>): string
Parameters
- data: unknown
- Optionalparams: Partial<ParseParams>
Returns string
Inherited from ZodType.parse
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:59

parseAsync

parseAsync(data: unknown, params?: Partial<ParseParams>): Promise<string>
Parameters
- data: unknown
- Optionalparams: Partial<ParseParams>
Returns Promise<string>
Inherited from ZodType.parseAsync
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:61

pipe

pipe<T extends ZodTypeAny>(target: T): ZodPipeline<ZodString, T>
Type Parameters
- T extends ZodTypeAny
Parameters
- target: T
Returns ZodPipeline<ZodString, T>
Inherited from ZodType.pipe
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:91

promise

promise(): ZodPromise<ZodString>
Returns ZodPromise<ZodString>
Inherited from ZodType.promise
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:78

readonly

readonly(): ZodReadonly<ZodString>
Returns ZodReadonly<ZodString>
Inherited from ZodType.readonly
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:92

refine

refine<RefinedOutput extends string>(
    check: (arg: string) => arg is RefinedOutput,
    message?:
        | string
        | Partial<Omit<ZodCustomIssue, "code">>
        | ((arg: string) => CustomErrorParams),
): ZodEffects<ZodString, RefinedOutput, string>
Type Parameters
- RefinedOutput extends string
Parameters
- check: (arg: string) => arg is RefinedOutput
- Optionalmessage:
      | string
      | Partial<Omit<ZodCustomIssue, "code">>
      | ((arg: string) => CustomErrorParams)
Returns ZodEffects<ZodString, RefinedOutput, string>
Inherited from ZodType.refine
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:65
refine(
    check: (arg: string) => unknown,
    message?:
        | string
        | Partial<Omit<ZodCustomIssue, "code">>
        | ((arg: string) => CustomErrorParams),
): ZodEffects<ZodString, string, string>
Parameters
- check: (arg: string) => unknown
- Optionalmessage:
      | string
      | Partial<Omit<ZodCustomIssue, "code">>
      | ((arg: string) => CustomErrorParams)
Returns ZodEffects<ZodString, string, string>
Inherited from ZodType.refine
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:66

refinement<RefinedOutput extends string>(
    check: (arg: string) => arg is RefinedOutput,
    refinementData:
        | IssueData
        | ((arg: string, ctx: RefinementCtx) => IssueData),
): ZodEffects<ZodString, RefinedOutput, string>
Type Parameters
- RefinedOutput extends string
Parameters
- check: (arg: string) => arg is RefinedOutput
- refinementData: IssueData | ((arg: string, ctx: RefinementCtx) => IssueData)
Returns ZodEffects<ZodString, RefinedOutput, string>
Inherited from ZodType.refinement
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:67
refinement(
    check: (arg: string) => boolean,
    refinementData:
        | IssueData
        | ((arg: string, ctx: RefinementCtx) => IssueData),
): ZodEffects<ZodString, string, string>
Parameters
- check: (arg: string) => boolean
- refinementData: IssueData | ((arg: string, ctx: RefinementCtx) => IssueData)
Returns ZodEffects<ZodString, string, string>
Inherited from ZodType.refinement
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:68

regex

regex(regex: RegExp, message?: ErrMessage): ZodString
Parameters
- regex: RegExp
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:191

safeParse

safeParse(
data: unknown,
params?: Partial<ParseParams>,
): SafeParseReturnType<string, string>
Parameters
- data: unknown
- Optionalparams: Partial<ParseParams>
Returns SafeParseReturnType<string, string>
Inherited from ZodType.safeParse
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:60

safeParseAsync

safeParseAsync(
data: unknown,
params?: Partial<ParseParams>,
): Promise<SafeParseReturnType<string, string>>
Parameters
- data: unknown
- Optionalparams: Partial<ParseParams>
Returns Promise<SafeParseReturnType<string, string>>
Inherited from ZodType.safeParseAsync
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:62

startsWith

startsWith(value: string, message?: ErrMessage): ZodString
Parameters
- value: string
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:196

superRefine

superRefine<RefinedOutput extends string>(
refinement: (arg: string, ctx: RefinementCtx) => arg is RefinedOutput,
): ZodEffects<ZodString, RefinedOutput, string>
Type Parameters
- RefinedOutput extends string
Parameters
- refinement: (arg: string, ctx: RefinementCtx) => arg is RefinedOutput
Returns ZodEffects<ZodString, RefinedOutput, string>
Inherited from ZodType.superRefine
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:70
superRefine(
refinement: (arg: string, ctx: RefinementCtx) => void,
): ZodEffects<ZodString, string, string>
Parameters
- refinement: (arg: string, ctx: RefinementCtx) => void
Returns ZodEffects<ZodString, string, string>
Inherited from ZodType.superRefine
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:71
superRefine(
refinement: (arg: string, ctx: RefinementCtx) => Promise<void>,
): ZodEffects<ZodString, string, string>
Parameters
- refinement: (arg: string, ctx: RefinementCtx) => Promise<void>
Returns ZodEffects<ZodString, string, string>
Inherited from ZodType.superRefine
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:72

toLowerCase

toLowerCase(): ZodString
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:207

toUpperCase

toUpperCase(): ZodString
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:208

transform

transform<NewOut>(
transform: (arg: string, ctx: RefinementCtx) => NewOut | Promise<NewOut>,
): ZodEffects<ZodString, NewOut>
Type Parameters
- NewOut
Parameters
- transform: (arg: string, ctx: RefinementCtx) => NewOut | Promise<NewOut>
Returns ZodEffects<ZodString, NewOut>
Inherited from ZodType.transform
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:81

trim

trim(): ZodString
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:206

ulid

ulid(message?: ErrMessage): ZodString
Parameters
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:181

url

url(message?: ErrMessage): ZodString
Parameters
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:176

uuid

uuid(message?: ErrMessage): ZodString
Parameters
- Optionalmessage: ErrMessage
Returns ZodString
- Defined in node_modules/.pnpm/zod@3.22.4/node_modules/zod/lib/types.d.ts:178

Class ZodString

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns ZodString

Properties

Readonly_def

Readonly_input

Readonly_output

Readonly_type

spa

Staticcreate

Accessors

description

Returns string | undefined

isCUID

Returns boolean

isCUID2

Returns boolean

isDatetime

Returns boolean

isEmail

Returns boolean

isEmoji

Returns boolean

isIP

Returns boolean

isULID

Returns boolean

isURL

Returns boolean

isUUID

Returns boolean

maxLength

Returns number | null

minLength

Returns number | null

Methods

_addCheck

Parameters

Returns ZodString

_getOrReturnCtx

Parameters

Returns ParseContext

_getType

Parameters

Returns string

_parse

Parameters

Returns ParseReturnType<string>

_parseAsync

Parameters

Returns AsyncParseReturnType<string>

_parseSync

Parameters

Returns SyncParseReturnType<string>

_processInputParams

Parameters

Returns { ctx: ParseContext; status: ParseStatus }

_refinement

Parameters

Returns ZodEffects<ZodString, string, string>

Protected_regex

Parameters

Returns ZodEffects<ZodString, string, string>

and

Type Parameters

Parameters

Returns ZodIntersection<ZodString, T>

array

Returns ZodArray<ZodString>

brand

Type Parameters

Parameters

`Readonly`_def

`Readonly`_input

`Readonly`_output

`Readonly`_type

`Static`create

`Protected`_regex