Декораторы классов и членов

Принципы

• Декоратор — функция, которая получает метаданные о целевом элементе и может изменить поведение (property, method, accessor, параметр, класс).
• Можно комбинировать декораторы: выполняются сверху вниз при объявлении и в обратном порядке при вызове.
• Через PropertyDescriptor и Object.defineProperty легко управлять доступностью, логированием и модификацией значений.

Пример

const Enumerable = (value: boolean) =>
  (target: any, key: string, descriptor: PropertyDescriptor) => {
    descriptor.enumerable = value;
  };

function LogAccess(target: any, prop: string) {
  let value = target[prop];
  Object.defineProperty(target, prop, {
    get() {
      console.log(`get ${prop}: ${value}`);
      return value;
    },
    set(newVal) {
      console.log(`set ${prop}: ${newVal}`);
      value = newVal;
    },
  });
}

@Test('CLASS')
class Person {
  @Test('PROPERTY')
  name = '';

  @LogAccess
  age = 90;

  @Enumerable(true)
  @Test('METHOD')
  myMethod(@Test('PARAMETER1') arg: string, @Test('PARAMETER2') arg2: number) {}
}

Практика

• Логируйте обращения к свойству через кастомный декоратор доступа (LogAccess) — полезно при отладке stateful-классов.
• Отмечайте параметры и методы декораторами для валидации, кеширования, внедрения зависимостей.
• Помните, что декораторы требуют включённого experimentalDecorators в tsconfig.json.