isValidElement는 값이 React 엘리먼트인지 확인합니다.

const isElement = isValidElement(value)

레퍼런스

isValidElement(value)

isValidElement(value)를 호출하여 value가 React 엘리먼트인지 확인합니다.

import { isValidElement, createElement } from 'react';

// ✅ React 엘리먼트
console.log(isValidElement(<p />)); // true
console.log(isValidElement(createElement('p'))); // true

// ❌ React 엘리먼트가 아님
console.log(isValidElement(25)); // false
console.log(isValidElement('Hello')); // false
console.log(isValidElement({ age: 42 })); // false

아래에서 더 많은 예시를 확인하세요

매개변수

value: 확인하려는 value입니다. 모든 종류의 값이 될 수 있습니다.

반환값

isValidElement는 value가 React 엘리먼트인 경우 true를 반환합니다. 그렇지 않으면 false를 반환합니다.

주의사항

  • createElement가 반환한 JSX 태그와 객체는 React 엘리먼트로 간주합니다. 예를 들어, 42와 같은 숫자는 유효한 React 노드 (컴포넌트에서 반환될 수 있지만)이지만, 유효한 React 엘리먼트는 아닙니다. createPortal로 만들어진 배열과 portal도 React 엘리먼트로 간주하지 않습니다.

사용법

어떤 것이 React 엘리먼트인지 확인하기

어떤 값이 React 엘리먼트인지 확인하려면 isValidElement를 호출해 보세요.

React 엘리먼트는 다음과 같습니다.

React 엘리먼트의 경우 isValidElement는 true를 반환합니다.

import { isValidElement, createElement } from 'react';

// ✅ JSX 태그는 React 엘리먼트입니다.
console.log(isValidElement(<p />)); // true
console.log(isValidElement(<MyComponent />)); // true

// ✅ createElement가 반환하는 값은 React 엘리먼트입니다.
console.log(isValidElement(createElement('p'))); // true
console.log(isValidElement(createElement(MyComponent))); // true

문자열, 숫자, 임의의 객체 및 배열과 같은 값들은 React 엘리먼트가 아닙니다.

이 경우 isValidElement는 false를 반환합니다.

// ❌ 이것들은 React 엘리먼트가 *아닙니다*.
console.log(isValidElement(null)); // false
console.log(isValidElement(25)); // false
console.log(isValidElement('Hello')); // false
console.log(isValidElement({ age: 42 })); // false
console.log(isValidElement([<div />, <div />])); // false
console.log(isValidElement(MyComponent)); // false

isValidElement가 필요한 경우는 매우 드뭅니다. 주로 “엘리먼트만” 허용하는 다른 API를 호출할 때와 (cloneElement가 하는 것처럼) 인수가 React 엘리먼트가 아닌 경우 오류를 피하고 싶을 때 유용합니다.

isValidElement확인을 추가 해야 하는 구체적인 이유가 없는 한 이 확인은 필요하지 않을 수 있습니다.

Deep Dive

React 엘리먼트 vs React 노드

컴포넌트를 작성할 때 모든 종류의 React 노드를 반환할 수 있습니다.

function MyComponent() {
  // ... React 노드를 반환할수 있습니다. ...
}

React 노드는 다음과 같습니다.

  • <div /> 또는 createElement('div')와 같이 생성된 React 엘리먼트입니다.
  • createPortal로 생성된 portal입니다.
  • 문자열
  • 숫자
  • true, false, null, 또는 undefined (표시되지 않는 경우)
  • 다른 React 노드의 배열

주의 isValidElement는 인수가 React 노드의 여부가 아니라 React 엘리먼트의 여부를 확인합니다. 예를 들어 42는 유효한 React 엘리먼트가 아닙니다. 하지만 완벽하게 유효한 React 노드입니다.

function MyComponent() {
  return 42; // 컴포넌트에서 숫자를 반환해도 괜찮습니다.
}

이것이 무언가를 렌더링할 수 있는지 확인하는 여부로 isValidElement를 사용해서는 안 되는 이유입니다.

PreviouscreateRef
NextPureComponent