HOWTO · React
React의 모양이 있는 Proptype 배열
React PropTypes 배열과 shape를 사용해 애플리케이션의 데이터 검증을 강화하는 방법을 알아보세요. 이 튜토리얼에서는 PropTypes의 이점을 설명하고, 코드 예제를 제공하며, 더 나은 오류 감지를 위한 PropTypes.shape() 구현 과정을 안내합니다. 버그를 조기에 발견하고 오늘 바로 코드 품질을 개선하는 방법을 확인하세요.
이 페이지의 내용
PropTypes.arrayOf(PropTypes.shape(...))는 지정한 필드를 가진 객체들로 이루어진 배열을 나타냅니다. prop-types 패키지는 개발 중에 이 컴포넌트 계약을 검사하고, 전달된 props가 계약과 일치하지 않으면 경고할 수 있습니다.
PropTypes가 검사하는 항목
PropTypes는 컴포넌트가 기대하는 props의 타입과 객체 구조를 선언합니다. 컴포넌트 인터페이스를 설명하고 개발 중 불일치를 발견하는 데 도움이 됩니다. 이 검사는 콘솔 경고를 표시할 뿐 컴포넌트 렌더링을 중단하지 않으며, 프로덕션 데이터 검증을 대신하지도 않습니다.
PropTypes로 객체 배열 검증하기
React 프로젝트에 prop-types 패키지를 설치합니다. 컴포넌트 모듈에서 import PropTypes from 'prop-types'로 가져온 다음 items: PropTypes.arrayOf(PropTypes.shape({ name: PropTypes.string.isRequired, value: PropTypes.number.isRequired })).isRequired를 선언합니다. 이렇게 하면 배열의 각 항목에 객체 모양 검사를 적용합니다. 아래의 간단한 JavaScript 예제는 같은 데이터가 목록 렌더러를 거치는 모습을 보여 줍니다. 이 예제는 단독으로 실행되며, PropTypes 선언은 React 컴포넌트 모듈에 작성해야 합니다.
const items = [
{ name: 'Ada', value: 7 },
{ name: 'Lin', value: 9 },
];
function renderItems(items) {
return `<ul>${items.map((item) => `<li>${item.name}: ${item.value}</li>`).join('')}</ul>`;
}
console.log(renderItems(items));
<ul><li>Ada: 7</li><li>Lin: 9</li></ul>
React 컴포넌트에서는 같은 배열을 items prop으로 전달하고 items.map(...)으로 각 항목을 렌더링합니다. 렌더링하는 각 요소에는 안정적인 key를 지정합니다. 예제의 값은 선언한 필드와 일치하므로 예상한 목록 내용이 표시됩니다.
필수 필드 지정과 경고 이해하기
선언에서 items에 붙인 .isRequired는 이 prop을 반드시 전달해야 한다는 뜻입니다. name과 value에 붙인 같은 수식어는 각 객체에 선언한 타입의 해당 필드가 있어야 한다는 뜻입니다. 필드를 생략할 수 있다면 그 필드에서 .isRequired를 제거하세요. 그러면 나머지 선언된 필드는 계속 검사됩니다. 숫자 대신 value: '7'을 가진 객체는 선언한 객체 모양과 일치하지 않으므로 React의 개발용 검사가 콘솔 경고를 표시합니다. 이 경고는 문자열을 숫자로 변환하거나 prop을 거부하거나 렌더링을 막지 않습니다. 애플리케이션이 외부 데이터나 프로덕션 데이터의 유효성에 의존한다면 별도로 검증하세요.
자주 묻는 질문
PropTypes는 배열의 모든 항목을 검사하나요?
네. PropTypes.arrayOf는 각 항목에 검증기를 적용합니다. 여기에 PropTypes.shape를 함께 사용하면 각 객체에서 지정한 필드를 검사합니다.
PropTypes.shape만으로 배열을 검사할 수 있나요?
아니요. PropTypes.shape는 객체 하나의 필드를 설명합니다. 객체 배열을 검사하려면 PropTypes.arrayOf(PropTypes.shape(...))를 사용하세요.
React에서 PropTypes를 반드시 사용해야 하나요?
아니요. PropTypes는 선택적으로 사용할 수 있는 런타임 검사로, props를 설명하고 개발 중 경고를 표시할 수 있습니다. 정적 타입 검사나 애플리케이션 경계에서의 데이터 검증을 대신하지는 않습니다.