[모딥다] 33장. Symbol

vanLan·2026년 2월 25일
JavaScript

모딥다

목록 보기
20/25
post-thumbnail

33장. Symbol

📁 심벌이란?

  • ES6에서 도입된 7번째 데이터 타입으로 변경 불가능한 원시 타입의 값.
  • 다른 값과 중복되지 않는 유일무이한 값.
    (주로 이름의 출돌 위험이 없는 유일한 프로퍼티 키를 만들기 위해 사용)

📁 심벌 값의 생성

1. Symbol 함수

  • Symbol 함수를 호출하여 생성.

    // Symbol 함수를 호출하여 유일무이한 심벌 값을 생성
const mySymbol = Symbol();
console.log(typeof mySymbol);  // symbol

// 심벌 값은 외부로 노출되지 않아 확인할 수 없다.
console.log(mySymbol);  // Symbol()

  • 심벌은 new 연산자와 함께 호출하지 않음. ( 심벌 값은 변경 불가능한 원시 값 )

    new Symbol();  // TypeError: Symbol is not a constructor

  • 문자열을 인수로 전달 가능. ( 생성된 심벌 값에 대한 설명으로 디버깅 용도로만 사용됨. )

    // 심벌 값에 대한 설명이 같더라도 유일무이한 심벌 값을 생성
const mySymbol1 = Symbol('mySymbol');
const mySymbol2 = Symbol('mySymbol');

console.log(mySymbol1 === mySymbol2);  // false

  • 객체처럼 접근하면 암묵적으로 래퍼 객체를 생성.

    const mySymbol = Symbol('mySymbol');

// 심벌도 래퍼 객체를 생성
console.log(mySymbol.descripttion);  // mySymbol
console.log(mySymbol.toString());  // Symbol(mySymbol)

  • 심벌 값은 암묵적으로 문자열이나 숫자 타입으로 변환되지 않음.

    const mySymbol = Symbol();

// 심벌 값은 암묵적으로 문자열이나 숫자 타입으로 변환되지 않음.
console.log(mySymbol + '');  // TypeError: Cannot convert a Symbol value to a string
console.log(+mySymbol);  // TypeError: Cannot convert a Symbol value to a string

  • 불리언 타입으로는 암묵적 타입 변환 가능. ( if문 등에서 존재 확인이 가능 )

    const mySymbol = Symbol();

// 불리언 타입으로는 암묵적 타입 변환
console.log(!!mySymbol);  // true

// if문 등에서 존재 확인 가능
if (mySymbol) console.log('mySymbol is not empty.');

2.Symbol.for / Symbol.keyFor 메서드

2-1. Symbol.for 메서드

  • 인수로 전달받은 문자열을 키로 사용 -> 전역 심벌 레지스트리에서 해당 키와 일치하는 심벌 값을 검색 -> 검색 실패 시 인수로 전달받은 문자열의 키로 전역 심벌 레지스트레이 저장 -> 생성된 심벌값을 반환.

    // 전역 심벌 레지스트리에 mySymbol이라는 키로 저장된 심벌 값이 없으면 새로운 심벌 값을 생성
const s1 = Symbol.for('mySymbol');
// 전역 심벌 레지스트리에 mySymbol이라는 키로 저장된 심벌 값이 있으면 해당 시벌 값을 반환
const s2 = Symbol.for('mySymbol');

console.log(s1 === s2);  // true

  • Symbol 함수 호출: 유일무이한 심벌 값 생성 ( 키 지정 불가 -> 전역 심벌 레지스트리에 등록/관리 X )
    Symbol.for 메서드: 애플리케이션 전역에 중복되지 않는 유일무이한 상수인 심벌 값을 단 하나만 생성하여 전역 심벌 레지스트리를 통해 공요.

2-2. Symbol.keyFor 메서드

  • 전역 심벌 레지스트리에 저장된 심벌 값의 키를 추출.

    // 전역 심벌 레지스트리에 mySymbol이라는 키로 지정된 심벌 값이 없으면 새로운 심벌 값을 생성
const s1 = Symbol.for('mySymbol');
// 전역 심벌 레지스트리에 지정된 심벌 값의 키를 추출
Symbol.keyFor(s1);  // -> mySymbol

// Symbol 함수를 호출하여 생성한 심벌 값은 전역 심벌 레지스트리에 등록되어 관리되지 않음
const s2 = Symbol('foo');
// 전역 심벌 레지스트리에 저장된 심벌 값의 키를 추출
Symbol.keyFor(s2);  // -> undefined

📁 심벌과 상수

  • 값에는 특별한 의미가 없고 상수 이름 자체에 의미가 있는 경우, 변경/중복될 가능 성이 있는 무의미한 상수 대신 중복될 가능성이 없는 유일무이한 심벌 값을 사용 가능.

    // 중복될 가능성이 없는 심벌 값으로 상수 값을 생성
const Direction = {
  UP: Symbol('up'),
  DOWN: Symbol('down'),
  LEFT: Symbol('left'),
  RIGHT: Symbol('right')
};

const myDirection = Direction.UP;

if (myDirection === Direction.UP) {
  console.log('You are going UP.');
}

  • Enum

    • 명명된 상수의 집합으로 열거형이라고 부름. ( JS는 enum을 지원하지 않지만 타입스크립트에선 enum을 지원 )

    • Object.freeze 메스드와 심벌 값을 사용해 enum을 흉내 내어 사용 가능.

      // 중복될 가능성이 없는 심벌 값으로 상수 값을 생성
const Direction = Object.freeze({
  UP: Symbol('up'),
  DOWN: Symbol('down'),
  LEFT: Symbol('left'),
  RIGHT: Symbol('right')
});

const myDirection = Direction.UP;

if (myDirection === Direction.UP) {
  console.log('You are going UP.');
}

📁 심벌과 프로퍼티 키

  • 객체의 프로퍼티 키는 빈 문자열을 포함하는 모든 문자열 또는 심벌 값으로 만들 수 있으며, 동적으로 생성 가능.

    const obj = {
  [Symbol.for('mySymbol')]: 1
};

obj[Symbol.for('mySymbol')];  // -> 1

  • 심벌 값으로 프로퍼티 키를 만들면 다른 프로퍼티 키와 절대 충돌하지 않음.


📁 심벌과 프로퍼티 은닉

  • 심벌 값을 프로퍼티 키로 사용하여 생성한 프로퍼티는 for ...in 문이나 Object.keys, Object.getOwnPropertyNames 메서드로 찾을 수 없음.

  • 심벌 값을 프로퍼티 키로 사용하여 프로퍼티를 생성하면 외부에 노출할 필요가 없는 프로퍼티를 은닉 가능.

    const obj = {
  [Symbol('mySymbol')]: 1
};

for (const key in obj) {
  console.log(key);  // 아무것도 출력되지 않음
}

console.log(Object.keys(obj));  // []
console.log(Object.getOwnPropertyNames(obj));  // []

// getOwnPropertySymbols 메서드는 인수로 전달된 객체의 심벌 프로퍼티 키를 배열로 반환
console.log(Object.getOwnPropertySymbols(obj));  // [Symbol(mySymbol)]

// getOwnPropertySymbols 메서드로 심벌 값도 찾을 수 있음
const symbolKey1 = Object.getOwnPropertySymbols(obj)[0];
console.log(obj[symbolKey1]);  // 1

📁 심벌과 표준 빌트인 객체 확장

  • 일반적으로 표준 빌트인 객체에 사용자 정의 메서드를 직접 추가하여 확장하는 것은 권장하지 않음. ( 읽기 전용으로 사용하는 것이 좋음 )

  • 하지만 심벌값으로 프로퍼티를 생성하면 어떤 프로퍼티 키와도 충돌할 위험이 없이 안전하게 표준 빌트인 객체를 확장 가능.

    // 심벌 값으로 프로퍼티 키를 동적 생성하면 다른 프로퍼티 키와 절대 충돌하지 않아 안전
Array.prototype[Symbol.for('sum')] = function () {
  return this.reduce((acc, cur) => acc + cur, 0);
};

[1, 2][Symbol.for('sum')]();  // -> 3

📁 Well-known Symbol

  • JS가 기본 제공하는 빌트인 심벌 값.

  • 이는 JS엔진의 내부 알고리즘에 사용됨.

  • Array, String, Map, Set, TypedArray, arguments, NodeList, HTMLCollection과 같이 for ...of 문으로 순회 가능한 빌트인 이터러블은 Well-known Symbol인 Symbol.iterator를 키로 갖는 메서드를 가지며, Symbol.iterator 메서드를 호출하면 이터레이터를 반환하도록 ECMAScript 사양에 규정되어 있음.

  • 일반 객체를 이터러블처럼 동작하도록 구현하고 싶다면 이터레이션 프로토콜을 따르면 됨.

    const iterable = {
  // Symbol.iterator 메서드를 구현하여 이터러블 프로토콜을 준수
  [Symbol.iterator]() {
    let cur = 1;
    const max = 5;
    // Symbol.iterator 메서드는 next 메서드를 소유한 이터레이터를 반환
    return {
      next() {
        return { value: cur++, done: cur > max + 1 }
      }
    };
  }
}

for (const num of iteralbe) {
  console.log(num);  // 1 2 3 4 5
}

  • 이때 이터레이션 프로토콜을 준수하기 위해 일반 객체에 추가해야 하는 메서드의 키 Symbol.iterator는 기존 프로퍼티 키 또는 미래에 추가될 프로퍼티 키와 절대 중복되지 않음.

  • 이처럼 심벌은 중복되지 않는 상수 값을 생성하는 것은 물론 기존 작성된 코드에 영향을 주지 않고 새로운 프로퍼티를 추가하기 위해, 즉 하위 호환성을 보장하기 위해 도입.

profile
vanLan
프론트엔드 개발자를 꿈꾸는 이
이전 포스트

[모딥다] 26장. ES6 함수의 추가 기능

다음 포스트

[모딥다] 34장. 이터러블

0개의 댓글