데이터 매핑 검증 자동화 입력 스키마와 실패 데이터 분리

외부 필드를 매핑하고 실패 행 분리하기

Node.js 24에서 한 파일로 실행합니다. 이번 최소 예제는 id/name을 sourceId/title로 매핑하고 문자열·공백을 검사합니다. 날짜와 status까지 포함한 전체 스키마는 하단 누적 프로젝트에서 확장합니다.

mapping-demo.mjs 전체 코드

function mapRow(input) {
  if (!input || typeof input !== 'object' || Array.isArray(input)) {
    return { ok: false, reason: '객체 필요' };
  }
  const sourceId = input.sourceId ?? input.id;
  const title = input.title ?? input.name;
  if (typeof sourceId !== 'string' || !sourceId.trim()) {
    return { ok: false, reason: 'sourceId 필요' };
  }
  if (typeof title !== 'string' || !title.trim()) {
    return { ok: false, reason: 'title 필요' };
  }
  return { ok: true, value: { sourceId: sourceId.trim(), title: title.trim() } };
}
const input = [{ id: 'a', name: '  읽기  ' }, { id: 'b', name: '' }, null];
const accepted = [];
const rejected = [];
for (const [index, row] of input.entries()) {
  const result = mapRow(row);
  if (result.ok) accepted.push(result.value);
  else rejected.push({ row: index + 1, reason: result.reason });
}
console.log(JSON.stringify(accepted));
console.log(JSON.stringify(rejected));

저장한 폴더에서 node mapping-demo.mjs로 실행합니다. 예상 출력은 다음과 같습니다.

[{"sourceId":"a","title":"읽기"}]
[{"row":2,"reason":"title 필요"},{"row":3,"reason":"객체 필요"}]

직접 바꿔 보기: name을 숫자 0으로 바꾸어 거절되는지 확인합니다. String(0)으로 자동 변환하면 왜 입력 오류가 숨겨지는지 설명해 보세요. null과 빈 배열도 같은 객체로 처리하지 않아야 합니다.