zod vs joi vs yup vs superstruct vs io-ts vs runtypes | "데이터 검증 및 스키마 정의" npm 패키지 비교

패키지	다운로드	Stars	크기	Issues	발행일	라이선스

zod	26,393,983	36,531	699 kB	575	2ヶ月前	MIT
joi	11,559,927	21,063	531 kB	185	10ヶ月前	BSD-3-Clause
yup	7,522,328	23,275	260 kB	244	4ヶ月前	MIT
superstruct	2,287,335	7,097	182 kB	98	9ヶ月前	MIT
io-ts	1,740,393	6,761	460 kB	164	4ヶ月前	MIT
runtypes	248,861	2,649	312 kB	19	2ヶ月前	MIT

패키지

다운로드

Stars

크기

Issues

발행일

라이선스

zod

26,393,983

36,531

699 kB

575

2ヶ月前

MIT

joi

11,559,927

21,063

531 kB

185

10ヶ月前

BSD-3-Clause

yup

7,522,328

23,275

260 kB

244

4ヶ月前

MIT

superstruct

2,287,335

7,097

182 kB

9ヶ月前

MIT

io-ts

1,740,393

6,761

460 kB

164

4ヶ月前

MIT

runtypes

248,861

2,649

312 kB

2ヶ月前

MIT

타입 안전성

zod:
zod는 TypeScript 친화적인 스키마 선언 및 검증 라이브러리로, 스키마에서 자동으로 타입을 추론할 수 있어 타입 안전성이 뛰어납니다. 런타임 검증과 정적 타입 검사를 동시에 지원하여, 코드의 안전성을 높입니다.
joi:
joi는 타입 안전성을 제공하지만, 런타임 검증에 중점을 두고 있어 정적 타입 검사는 지원하지 않습니다. TypeScript와 함께 사용할 수 있지만, 타입 정의가 자동으로 생성되지 않습니다.
yup:
yup은 런타임 검증에 중점을 두고 있으며, TypeScript와 함께 사용할 수 있지만, 자동으로 타입을 추론하거나 생성하지는 않습니다. 사용자 정의 검증 로직을 추가할 수 있어, 유연한 타입 검증이 가능합니다.
superstruct:
superstruct는 런타임 검증을 통해 타입 안전성을 제공하지만, TypeScript와의 통합이 다소 제한적입니다. 사용자 정의 구조체를 정의하고 검증할 수 있어, 유연한 타입 검증이 가능합니다.
io-ts:
io-ts는 TypeScript와의 통합이 뛰어나, 런타임에서 타입 검증을 수행하면서도 정적 타입 검사를 지원합니다. 복잡한 타입 구조를 정의하고 검증할 수 있어, 타입 안전성을 극대화할 수 있습니다.
runtypes:
runtypes는 런타임에서 타입 검증을 수행하며, TypeScript와 잘 통합되어 타입 안전성을 제공합니다. 타입 검증과 함께 타입 추론이 가능하여, 코드의 가독성과 안전성을 높입니다.

사용자 정의 검증

zod:
zod는 사용자 정의 검증 함수를 쉽게 추가할 수 있으며, 스키마 정의와 함께 사용자 정의 검증을 통합하는 것이 간편합니다. 간결한 API 덕분에 사용자 정의 검증을 빠르게 구현할 수 있습니다.
joi:
joi는 사용자 정의 검증을 위한 API가 잘 마련되어 있어, 간편하게 사용자 정의 로직을 추가할 수 있습니다. 특히, 체이닝 방식으로 사용자 정의 검증을 쉽게 통합할 수 있어 직관적입니다.
yup:
yup은 사용자 정의 검증을 위한 API가 잘 갖춰져 있어, 쉽게 사용자 정의 검증 로직을 추가할 수 있습니다. 특히, 비동기 검증과 체이닝을 지원하여, 복잡한 사용자 정의 검증도 쉽게 구현할 수 있습니다.
superstruct:
superstruct는 사용자 정의 검증 로직을 쉽게 추가할 수 있으며, 구조체 정의와 함께 사용자 정의 검증을 통합하는 것이 간편합니다. 유연한 구조로 인해 복잡한 사용자 정의 검증도 쉽게 구현할 수 있습니다.
io-ts:
io-ts는 사용자 정의 검증 함수를 쉽게 추가할 수 있으며, 복잡한 타입 검증 로직을 구현할 수 있습니다. 그러나 사용자 정의 검증이 다소 복잡할 수 있어, 타입 시스템에 익숙한 개발자가 사용하는 것이 좋습니다.
runtypes:
runtypes는 사용자 정의 검증을 지원하지만, API가 간단하여 복잡한 사용자 정의 검증 로직을 구현하는 데는 제한이 있을 수 있습니다. 간단한 사용자 정의 검증에는 적합합니다.

비동기 검증

zod:
zod는 비동기 검증을 지원하며, 비동기 검증 로직을 쉽게 통합할 수 있습니다. 비동기 검증이 필요한 경우 유용하게 사용할 수 있습니다.
joi:
joi는 비동기 검증을 기본적으로 지원하며, async/await를 사용하여 비동기 검증 로직을 쉽게 구현할 수 있습니다. 비동기 작업이 필요한 경우 유용하게 사용할 수 있습니다.
yup:
yup은 비동기 검증을 기본적으로 지원하며, async/await를 사용하여 비동기 검증 로직을 쉽게 구현할 수 있습니다. 비동기 작업이 필요한 경우 유용하게 사용할 수 있습니다.
superstruct:
superstruct는 비동기 검증을 지원하지 않지만, 사용자 정의 검증 함수를 통해 비동기 검증 로직을 구현할 수 있습니다. 비동기 검증을 위한 내장 기능은 없습니다.
io-ts:
io-ts는 비동기 검증을 기본적으로 지원하지 않지만, 사용자 정의 검증 함수를 통해 비동기 검증을 구현할 수 있습니다. 그러나 비동기 검증을 위한 특별한 기능은 제공하지 않습니다.
runtypes:
runtypes는 비동기 검증을 기본적으로 지원하지 않지만, 사용자 정의 검증 함수를 통해 비동기 검증을 구현할 수 있습니다. 그러나 비동기 검증을 위한 특별한 기능은 제공하지 않습니다.

오류 메시지 커스터마이징

zod:
zod는 오류 메시지 커스터마이징을 지원하며, 기본 오류 메시지를 사용자 정의 메시지로 쉽게 변경할 수 있습니다. 그러나 오류 메시지 커스터마이징 기능은 joi나 yup에 비해 다소 제한적입니다.
joi:
joi는 오류 메시지 커스터마이징이 매우 강력하며, 각 필드 및 검증 규칙에 대해 세밀하게 오류 메시지를 설정할 수 있습니다. 사용자 정의 오류 메시지를 쉽게 추가할 수 있어, 유연한 커스터마이징이 가능합니다.
yup:
yup은 오류 메시지 커스터마이징이 용이하며, 각 필드 및 검증 규칙에 대해 사용자 정의 오류 메시지를 쉽게 설정할 수 있습니다. 특히, 체이닝 방식으로 오류 메시지를 단계별로 설정할 수 있어 유연합니다.
superstruct:
superstruct는 오류 메시지 커스터마이징이 가능하지만, 기본적으로 제공되는 오류 메시지가 다소 제한적입니다. 사용자 정의 검증 로직을 추가할 경우, 오류 메시지를 직접 설정해야 합니다.
io-ts:
io-ts는 오류 메시지 커스터마이징을 지원하지만, 기본적으로 제공되는 오류 메시지가 다소 제한적입니다. 사용자 정의 검증 로직을 추가할 경우, 오류 메시지를 직접 설정해야 합니다.
runtypes:
runtypes는 기본적인 오류 메시지를 제공하지만, 오류 메시지 커스터마이징 기능은 제한적입니다. 사용자 정의 검증 로직을 추가할 경우, 오류 메시지를 직접 설정해야 합니다.

코드 예시

zod:

zod를 사용한 데이터 검증 예시

import { z } from 'zod';

// 스키마 정의
const UserSchema = z.object({
  name: z.string(),
  age: z.number().min(0),
});

// 데이터 검증
const result = UserSchema.safeParse({ name: 'Alice', age: 30 });

// 검증 결과 처리
if (result.success) {
  console.log('유효성 검사 성공:', result.data);
} else {
  console.error('유효성 검사 실패:', result.error.errors);
}

joi:

joi를 사용한 데이터 검증 예시

const Joi = require('joi');

// 스키마 정의
const schema = Joi.object({
  name: Joi.string().required(),
  age: Joi.number().integer().min(0).required(),
});

// 데이터 검증
const { error, value } = schema.validate({ name: 'Alice', age: 30 });

// 검증 결과 처리
if (error) {
  console.error('유효성 검사 실패:', error.details);
} else {
  console.log('유효성 검사 성공:', value);
}

yup:

yup을 사용한 데이터 검증 예시

const yup = require('yup');

// 스키마 정의
const schema = yup.object().shape({
  name: yup.string().required(),
  age: yup.number().integer().min(0).required(),
});

// 데이터 검증
schema.validate({ name: 'Alice', age: 30 })
  .then((value) => {
    console.log('유효성 검사 성공:', value);
  })
  .catch((error) => {
    console.error('유효성 검사 실패:', error.errors);
  });

superstruct:

superstruct를 사용한 데이터 검증 예시

import { struct } from 'superstruct';

// 스키마 정의
const User = struct({
  name: 'string',
  age: 'number',
});

// 데이터 검증
const result = User({ name: 'Alice', age: 30 });

// 검증 결과 처리
console.log('유효성 검사 성공:', result);

io-ts:

io-ts를 사용한 데이터 검증 예시

import * as t from 'io-ts';

// 스키마 정의
const User = t.type({
  name: t.string,
  age: t.number,
});

// 데이터 검증
const result = User.decode({ name: 'Alice', age: 30 });

// 검증 결과 처리
result.fold(
  (errors) => console.error('유효성 검사 실패:', errors),
  (valid) => console.log('유효성 검사 성공:', valid)
);

runtypes:

runtypes를 사용한 데이터 검증 예시

import { Runtype, Record, String, Number } from 'runtypes';

// 스키마 정의
const User = Record({
  name: String,
  age: Number,
});

// 데이터 검증
const result = User.check({ name: 'Alice', age: 30 });

// 검증 결과 처리
console.log('유효성 검사 성공:', result);