Як створити властивість в об’єкта, яку не можна буде змінити?

Повне пояснення

Що це і навіщо

• Object.defineProperty дозволяє задати атрибути властивості: writable, configurable та інші. Якщо встановити writable:false, значення не можна змінювати.

Ключові принципи

• writable:false → неможна присвоїти нове значення.
• configurable:false → не можна видалити або змінити атрибути.
• enumerable:true/false → чи буде властивість видимою в циклі for…in.

Як це працює

• При виклику Object.defineProperty створюється «схема» для конкретної властивості. JavaScript‑рушій перевіряє атрибути перед кожною операцією присвоєння.

Практика і реалізація

const obj = {};
Object.defineProperty(obj, 'id', {
  value: 123,
  writable: false,
  configurable: false,
  enumerable: true
});
obj.id = 456; // нічого не зміниться, в консолі буде 123

Для повної незмінності об’єкта:

Object.freeze(obj); // блокує додавання, видалення та зміну всіх властивостей

Тестування

• У Jest можна перевірити:

expect(() => { obj.id = 456; }).not.toThrow();
expect(obj.id).toBe(123);

Оптимізація та edge‑cases

• Object.freeze робить об’єкт «швидким» для читання, але не глибоко (не заморожує вкладені об’єкти). Для глибокої незмінності використовуйте deepFreeze або бібліотеки типу immutable.js.

Часті помилки

1. Забуваєте встановити configurable:false – властивість все одно можна видалити.
2. Використовуєте const для об’єкта, але це лише блокує переназначення змінної, а не властивостей.
3. Не заморожуєте вкладені об’єкти – вони залишаються змінними.
4. Під час тестування не перевіряєте, що властивість дійсно неможна змінити.
5. Використовуєте Object.defineProperty без enumerable:true, що приховає властивість у циклі.
6. Не враховуєте, що Object.freeze не працює з геттерами/setтерами.
7. Не розумієте, що writable:false не блокує мутації через посилання (наприклад, obj.prop.push(1) для масиву).
8. Не перевіряєте, що Object.freeze не працює в режимі strict без помилки.

Cheatsheet

• Object.defineProperty(obj, 'key', {value: val, writable:false, configurable:false});
• Object.freeze(obj) – повна незмінність.
• Для глибокої заморозки: Object.keys(obj).forEach(k => Object.freeze(obj[k]));