JavaScript symbol.description 속성 완벽 정리

symbol.description 속성은 심볼(Symbol) 객체에 선택적으로 부여된 설명(description)을 반환하며, 읽기 전용(read-only) 속성입니다.

심볼은 ES6에서 도입된 원시 타입으로, 주로 객체의 고유한 프로퍼티 키를 만들 때 사용됩니다. 이때 description 속성을 활용하면 디버깅이나 로깅 시 해당 심볼이 어떤 용도로 생성되었는지 쉽게 파악할 수 있습니다.

주요 특징

심볼 생성 시 전달한 문자열 인자가 그대로 설명으로 저장됩니다.
설명 없이 생성된 심볼의 경우 undefined를 반환합니다.
Symbol.iterator처럼 내장 심볼(well-known symbol)에도 적용할 수 있습니다.

예제 코드

<!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
<style>
    body {
        font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
    }
    div {
        font-size: 20px;
        font-weight: 500;
    }
</style>
</head>
<body>
<h1>JavaScript symbol.description 속성</h1>
<div class="sample"></div>
<button class="Btn">CLICK HERE</button>
<h3>
위 버튼을 클릭하면 각 심볼의 설명을 확인할 수 있습니다.
</h3>
<script>
    let fillEle = document.querySelector(".sample");
    let desc = [];
    desc.push(Symbol("New").description);
    desc.push(Symbol("Hello").description);
    desc.push(Symbol.iterator.description);
    document.querySelector(".Btn").addEventListener("click", () => {
        desc.forEach((item) => (fillEle.innerHTML += item + "<br>"));
    });
</script>
</body>
</html>

실행 결과

JavaScript symbol.description 속성 완벽 정리

위 코드에서는 세 개의 심볼 설명을 배열에 담아두고, 버튼을 클릭하면 화면에 순서대로 출력됩니다.

“CLICK HERE” 버튼을 클릭한 결과 −

JavaScript symbol.description 속성 완벽 정리

버튼을 클릭하면 다음과 같은 값들이 차례로 표시됩니다.

New — Symbol("New")로 생성한 심볼의 설명
Hello — Symbol("Hello")로 생성한 심볼의 설명
Symbol.iterator — 내장 심볼의 기본 설명

이처럼 symbol.description 속성을 활용하면 심볼에 부여된 의미를 손쉽게 확인할 수 있어, 복잡한 애플리케이션에서 심볼을 관리할 때 유용하게 사용됩니다.