string

Creates a string schema.

const Schema = v.string<TMessage>(message);

Generics

• TMessage extends ErrorMessage<StringIssue> | undefined

Parameters

• message TMessage

Explanation

With string you can validate the data type of the input. If the input is not a string, you can use message to customize the error message.

Returns

• Schema StringSchema<TMessage>

Examples

The following examples show how string can be used.

Email schema

Schema to validate an email.

const EmailSchema = v.pipe(
  v.string(),
  v.nonEmpty('Please enter your email.'),
  v.email('The email is badly formatted.'),
  v.maxLength(30, 'Your email is too long.')
);

Password schema

Schema to validate a password.

const PasswordSchema = v.pipe(
  v.string(),
  v.minLength(8, 'Your password is too short.'),
  v.maxLength(30, 'Your password is too long.'),
  v.regex(/[a-z]/, 'Your password must contain a lowercase letter.'),
  v.regex(/[A-Z]/, 'Your password must contain a uppercase letter.'),
  v.regex(/[0-9]/, 'Your password must contain a number.')
);

URL schema

Schema to validate a URL.

const UrlSchema = v.pipe(
  v.string('A URL must be string.'),
  v.url('The URL is badly formatted.')
);

Related

The following APIs can be combined with string.

Schemas

• array,
• exactOptional,
• intersect,
• lazy,
• looseObject,
• looseTuple,
• map,
• nonNullable,
• nonNullish,
• nonOptional,
• nullable,
• nullish,
• object,
• objectWithRest,
• optional,
• record,
• set,
• strictObject,
• strictTuple,
• tuple,
• tupleWithRest,
• undefinedable,
• union

Methods

• assert,
• config,
• fallback,
• getDefault,
• getDefaults,
• getFallback,
• getFallbacks,
• is,
• message,
• parse,
• parser,
• pipe,
• safeParse,
• safeParser

Actions

• base64,
• bic,
• brand,
• bytes,
• creditCard,
• cuid2,
• check,
• decimal,
• description,
• digits,
• email,
• emoji,
• empty,
• endsWith,
• excludes,
• graphemes,
• gtValue,
• hash,
• hexadecimal,
• hexColor,
• imei,
• includes,
• ip,
• ipv4,
• ipv6,
• isoDate,
• isoDateTime,
• isoTime,
• isoTimeSecond,
• isoTimestamp,
• isoWeek,
• length,
• ltValue,
• mac,
• mac48,
• mac64,
• maxBytes,
• maxGraphemes,
• maxLength,
• maxValue,
• maxWords,
• metadata,
• minBytes,
• minGraphemes,
• minLength,
• minValue,
• minWords,
• nanoid,
• nonEmpty,
• notBytes,
• notGraphemes,
• notLength,
• notValue,
• notValues,
• notWords,
• octal,
• rawCheck,
• rawTransform,
• readonly,
• regex,
• rfcEmail,
• slug,
• startsWith,
• title,
• toLowerCase,
• toMaxValue,
• toMinValue,
• toUpperCase,
• transform,
• trim,
• trimEnd,
• trimStart,
• ulid,
• url,
• uuid,
• value,
• values,
• words

Utils

• entriesFromList,
• isOfKind,
• isOfType