📚 ****Reference

• 공식 사이트
• 참고 자료 1

Object.defineProperties()

Object.defineProperties(obj, props)

Object.defineProperties(obj, {
  prop1: descriptor1,
  prop2: descriptor2
  // ...
});

• Object.defineProperties()
• Object.defineProperties() 메서드는 객체에 새로운 속성을 정의하거나 기존의 속성을 수정하고 그 객체를 반환한다.
• 프로퍼티 여러 개를 한 번에 정의할 수 있습니다.

Parameters

• obj
  • 속성을 정의하거나 수정할 객체.
• props
  • 정의하거나 수정할 속성의 이름을 키로, 그 속성을 서술하는 객체를 값으로 갖는 객체.
  • props의 각 값은 데이터 서술자(data descriptor) 혹은 접근자 서술자(accessor descriptor) 중 하나여야 하며, 동시에 두 유형을 포함할 수 없다(Object.defineProperty() 참조).
  • 데이터 서술자와 접근자 서술자 모두 다음 키를 선택적으로 포함할 수 있다:
    • configurable
      • true일 경우 이 속성 서술자의 형태를 변경하거나, 속성을 해당 객체에서 삭제할 수 있다.
      • 기본값은 false이다.
    • enumerable
      • true일 경우 해당 객체의 속성을 열거할 때 이 속성이 열거된다.
      • 기본값은 false이다.
  • 데이터 서술자의 경우 다음 키를 추가로 포함할 수 있다:
    • value
      • 이 속성에 설정할 값. 올바른 자바스크립트 값(숫자, 객체, 함수 등)이면 무엇이든 설정할 수 있다.
      • 기본값은 undefined이다.
    • writable
      • true일 경우 이 속성에 설정된 값을 할당 연산자 (en-US)로 수정할 수 있다.
      • 기본값은 false이다.
  • 접근자 서술자의 경우 다음 키를 추가로 포함할 수 있다:
    • get
      • 해당 속성의 getter가 될 함수, 혹은 getter가 없을 경우 undefined. 이 함수의 반환값이 속성의 값으로 사용된다.
      • 기본값은 undefined이다.
    • set
      • 해당 속성의 setter가 될 함수, 혹은 setter가 없을 경우 undefined. 이 함수는 이 속성에 할당되는 새로운 값을 유일한 인자로 받는다.
      • 기본값은 undefined이다.
    • 서술자가 value, writable, get, set 키를 모두 가지고 있지 않을 경우 데이터 서술자로 취급한다.
    • 서술자가 value이나 writable과 get이나 set 키를 모두 가지고 있을 경우 예외가 발생한다.