Decorators (Stage 3 / TS 5.0)

TC39 Stage 3 — это новые декораторы, не experimentalDecorators. На интервью спрашивают разницу: новые принимают (value, context), не имеют доступа к prototype, не передают PropertyDescriptor. Красный флаг — писать на старом синтаксисе и не знать про ClassMethodDecoratorContext.

Старые vs новые — сигнатуры и tsconfig:

// experimentalDecorators (legacy):
// function log(target, key, descriptor) { ... }

// Stage 3 (TS 5.0+, без experimentalDecorators):
function logged&lt;This, Args extends any[], Return&gt;(
  target: (this: This, ...args: Args) =&gt; Return,
  context: ClassMethodDecoratorContext&lt;This, (this: This, ...args: Args) =&gt; Return&gt;
) {
  const name = String(context.name);
  return function (this: This, ...args: Args): Return {
    console.log(`-&gt; ${name}`, args);
    const r = target.apply(this, args);
    console.log(`&lt;- ${name}`, r);
    return r;
  };
}

class Api {
  @logged
  get(id: string) { return { id }; }
}

Field/getter/accessor декораторы — у каждого свой context:

function nonEnumerable&lt;T, V&gt;(
  _value: undefined,
  context: ClassFieldDecoratorContext&lt;T, V&gt;
) {
  context.addInitializer(function () {
    Object.defineProperty(this, context.name, { enumerable: false });
  });
}

class User {
  @nonEnumerable
  internalId = crypto.randomUUID();
}

Декоратор класса — заменяет конструктор:

function sealed&lt;T extends new (...a: any[]) =&gt; any&gt;(
  value: T,
  _context: ClassDecoratorContext&lt;T&gt;
) {
  Object.seal(value);
  Object.seal(value.prototype);
  return value;
}

@sealed
class Service { name = 'svc' }

Итог: Новые декораторы — это (value, context), без PropertyDescriptor; включаются без experimentalDecorators в TS 5.x.

Подвох: Старые и новые декораторы несовместимы. experimentalDecorators: true переключает компилятор обратно в legacy-режим, и Stage 3 в этом режиме не работает.