TypeScript 5.0 и новые decorators: что меняется для NestJS и не только
Текст написан с позиции марта 2023 года: так, как тема выглядела тогда, без технологий и событий, появившихся позже.
В экосистеме TypeScript есть особый тип изменений, которые на первый взгляд выглядят как внутреннее уточнение языка, а через несколько недель внезапно начинают влиять на очень практические решения в кодовой базе. Новые decorators из TypeScript 5.0 — как раз такой случай. Формально речь идет о поддержке новой версии предложения decorators для JavaScript, и это само по себе уже достаточно крупная история. Но интереснее другое: у огромного количества команд decorators давно ассоциируются не с абстрактным будущим ECMAScript, а с вполне конкретным повседневным кодом — NestJS, class-transformer, class-validator, DI-паттерны, аннотации над классами, параметрами и методами. И как только язык начинает двигать основание под таким знакомым синтаксисом, вопрос сразу становится практическим: что это меняет не в теории, а в живых проектах?
Здесь особенно важно не свалиться в одну из двух крайностей. Первая — восторженно решить, что теперь decorators наконец-то стали “настоящими стандартными”, а значит старые подходы можно срочно выкидывать и всё переписывать под новую модель. Вторая — отмахнуться и сказать, что это всё пока не касается реальных приложений, особенно тех, что живут на NestJS и опираются на старую схему с experimentalDecorators и metadata. Обе реакции слишком грубые. Правильнее сформулировать так: это не упрощение, а взросление. TypeScript 5.0 уже явно показывает, куда движется язык и экосистема, но для многих библиотек, построенных вокруг старой decorator-модели, это не “момент немедленного переезда”, а сигнал о будущей перестройке и о границах совместимости. Стабильный релиз TypeScript 5.0 вышел 16 марта 2023 года, так что новые decorators можно обсуждать уже как состоявшуюся часть языка.
Именно поэтому разговор о новых decorators хорош не как обзор синтаксической новинки, а как попытка трезво понять: что в них действительно новое, почему они не равны старым experimental decorators, почему NestJS не сможет просто “переехать автоматически”, и что это означает для разработчиков, даже если они не пишут фреймворк, а просто живут в TypeScript-кодовой базе, где декораторы стали привычной частью архитектуры. Потому что главная интрига здесь не в символе @ как таковом. Она в том, что под знакомой поверхностью меняется модель, а вместе с ней — и правила игры для библиотек, паттернов DI и типового метапрограммирования.
Почему вокруг decorators так много внимания
Декораторы давно заняли в TypeScript странное, но влиятельное положение. С одной стороны, они годами оставались экспериментальной возможностью, включаемой через --experimentalDecorators. С другой — в реальной разработке они успели стать почти повседневной нормой для целого класса экосистемных решений. Особенно это заметно в backend-мире на Node.js, где NestJS построил вокруг них очень выразительный стиль: контроллеры, модули, провайдеры, guards, pipes, параметры маршрутов, аннотации для метаданных и DI. Во многих командах decorators давно перестали ощущаться “экспериментом”, хотя формально именно так и жили в компиляторе.
Поэтому поддержка новой decorator-модели в TypeScript 5.0 важна не как новость из жизни стандарта JavaScript, а как момент, когда долгий компромисс перестаёт быть бесплатным. TypeScript поддерживал decorators в версии, основанной на более старой итерации предложения, а сам стандарт продолжал двигаться. В какой-то момент язык должен был либо навсегда застрять в собственной исторической ветке, либо начать поддерживать более современную модель. TypeScript 5.0 выбирает второе: decorators становятся валидным синтаксисом для нового кода даже без --experimentalDecorators, но при этом ведут себя иначе на уровне type checking и emit. И вот именно это “иначе” важнее самой новости о поддержке синтаксиса.
Что именно меняется в TypeScript 5.0
Если говорить совсем просто, то в TypeScript 5.0 появляются decorators, соответствующие новой версии ECMAScript proposal, и это не просто косметическая правка старого механизма. У новой модели другой стиль сигнатур, другой контекст применения и другой подход к тому, как decorator взаимодействует с классом или методом. Типичный пример из документации TypeScript 5.0 показывает decorator, который получает оригинальный метод и context object, а затем возвращает заменяющую функцию. Именно context object — важная часть новой модели: через него decorator узнает, что именно он декорирует и в каком контексте находится. Это уже не тот старый мир, где большинство разработчиков просто мысленно держали в голове target, propertyKey и descriptor как знакомую тройку аргументов.
При этом TypeScript отдельно подчеркивает: старые experimental decorators никуда мгновенно не исчезают. Флаг --experimentalDecorators продолжит существовать “в обозримом будущем”. Но decorators вне этого флага теперь будут и проверяться, и эмититься иначе. А это означает очень важную практическую вещь: одинаковый синтаксис @something теперь может скрывать две довольно разные модели поведения, в зависимости от того, в каком режиме вы живете. Для команды это не теоретическая тонкость, а реальный риск путаницы. Потому что визуально код похож, а на уровне совместимости библиотек и рантайм-ожиданий — уже нет.
Главное, что нужно понять сразу: новые decorators не равны старым
Это, пожалуй, ключевая мысль всей темы. Самая вредная реакция на анонс — посмотреть на него и решить, что TypeScript просто “узаконил” старый decorator-синтаксис. Но это было бы слишком упрощённо. Документация 5.0 прямо говорит: новые decorators вне --experimentalDecoratorsпо-другому проходят type checking и emit, а различия настолько существенны, что существующие decorator-функции, скорее всего, не будут автоматически совместимы с обеими моделями. Да, теоретически можно писать decorators так, чтобы они поддерживали и старую, и новую семантику. Но для реальной экосистемы это не бесплатный переход, а отдельная работа со своей ценой.
Вот здесь и начинается самое интересное для NestJS и похожих библиотек. Проблема не в том, что у них “есть decorators”. Проблема в том, что они долго строили архитектуру поверх конкретной, исторически сложившейся формы decorators в TypeScript: с legacy-эмитом, с параметрическими decorators, с metadata-паттернами и с определенным взглядом на то, как фреймворк извлекает информацию о классах и параметрах конструктора. Новая стандартная модель не является механической заменой этой среды. Она — другое основание.
Почему для NestJS это не просто приятное обновление, а зона осторожности
NestJS очень глубоко завязан на decorators не как на декоративный синтаксис, а как на часть своей архитектурной механики. Через decorators в нем описываются контроллеры, маршруты, параметры, модули, провайдеры, guards и многое другое. Но еще важнее то, что NestJS традиционно использует старую decorator-экосистему в связке с metadata: особенно критична здесь информация о параметрах конструктора и других местах, где фреймворк строит dependency injection и runtime-интроспекцию. А TypeScript 5.0 прямо говорит, что новая decorators proposal несовместима с --emitDecoratorMetadata и не поддерживает parameter decorators. Для NestJS это не мелкая деталь, а фактически предупреждение: тот мир, на котором живет большая часть текущей архитектуры фреймворка, не совпадает с новой моделью один к одному.
Именно поэтому честный вывод звучит так: для NestJS новые decorators — это прежде всего стратегический сигнал, а не повод срочно отключать legacy-режим и жить на чистом стандарте. Пока библиотека опирается на старую decorator-экосистему и metadata, TypeScript 5.0 не открывает ей “бесплатную дорогу вперед”, а, наоборот, подчеркивает, где проходит граница между старым и новым. Это не катастрофа, но и не безобидная формальность. Это прямо влияет на ожидания команд, которые надеялись, что стандартные decorators просто плавно заменят старые в уже существующем NestJS-коде. Скорее всего, такой плавности в лоб не будет.
Самый болезненный момент: metadata и parameter decorators
Если искать два факта, из-за которых вопрос становится особенно практическим, это именно несовместимость с --emitDecoratorMetadata и отсутствие поддержки parameter decorators в новой proposal на этом этапе. Для обычного небольшого decorator-кода это может звучать терпимо. Для фреймворков и DI-систем — уже совсем нет. NestJS и похожие инструменты давно привыкли извлекать полезную runtime-информацию из metadata, которую TypeScript умел эмитить в старой модели. Плюс parameter decorators — это часть выразительности, к которой многие backend-разработчики давно привыкли.
Когда TypeScript 5.0 говорит, что новая proposal не совместима с emitDecoratorMetadata и не позволяет декорировать параметры, это сразу делает очевидным: новый стандартный decorator-мир и текущий фреймворочный decorator-мир пока расходятся по самым чувствительным точкам. Это не просто неудобство на уровне синтаксиса. Это вопрос того, можно ли вообще на тех же основаниях строить DI, runtime reflection и богатую аннотированную фреймворочную модель. На данный момент ответ скорее “не напрямую”. И именно поэтому для NestJS тема decorators в TypeScript 5.0 — это не про “ура, теперь все стандартно”, а про “какой у нас теперь путь эволюции и насколько он длинный”.
Что меняется для тех, кто пишет decorators сам
Не весь мир decorators — это NestJS. Есть и команды, которые пишут собственные decorators: для логирования, ограничений доступа, трассировки, memoization, оберток над методами, регистрации сущностей, конфигурации модулей и так далее. Для таких разработчиков TypeScript 5.0 интересен уже не только как тема совместимости, но и как тема нового стиля написания decorator-функций.
Новая модель делает гораздо заметнее роль context object и в целом подталкивает к более явному и типизированному стилю. Документация TypeScript отдельно показывает, что хорошо типизированные decorators теперь вполне могут выглядеть сложнее: приходится моделировать this, аргументы и возвращаемое значение исходного метода, а также тип контекста вроде ClassMethodDecoratorContext. Это важный нюанс. С одной стороны, новая модель выглядит более “стандартной” и концептуально зрелой. С другой — она не обязательно делает decorators визуально проще для тех, кто пишет их руками. Наоборот, для серьезной типизации потребуется больше аккуратности.
То есть для обычного прикладного разработчика выгода здесь не в том, что decorators стали тривиальнее, а в том, что они становятся ближе к будущему стандартному JavaScript-пути. А вот цена — необходимость понимать, что decorators теперь не просто старый эксперимент с новым статусом, а иная модель с иными ожиданиями к библиотечному коду.
Для NestJS-команд практический вывод довольно приземленный
Если говорить совсем без пафоса, то для команд на NestJS в ближайшей перспективе вывод простой: не стоит воспринимать TypeScript 5.0 как сигнал срочно переводить проект на новые decorators. Гораздо важнее понимать, что фреймворк и его экосистема пока в основном живут в legacy decorator-world, и это нормально. TypeScript прямо оставляет --experimentalDecorators в живых, а значит у реальных приложений есть пространство не для истерической миграции, а для спокойного наблюдения за тем, как будут адаптироваться фреймворки, DI-библиотеки и metadata-ориентированные инструменты.
При этом игнорировать изменения тоже не стоит. Даже если вы не собираетесь трогать текущий код прямо сейчас, уже полезно понимать: decorators в экосистеме TypeScript перестают быть одной неподвижной сущностью. У вас теперь есть legacy-модель, есть новая proposal-модель, и между ними есть вполне реальные зоны несовместимости. Это значит, что архитектурные ставки на decorators как на вечную стабильную основу для любого фреймворочного паттерна уже не выглядят такими безоблачными. Наоборот, становится важнее отделять, где у вас decorators — просто удобный слой декларативности, а где они являются критической опорой runtime-механики.
Почему это касается не только NestJS
Хотя NestJS — самый очевидный пример, история далеко не исчерпывается им. Любая библиотека, завязанная на старую decorator-модель и особенно на metadata-подход, теперь вынуждена смотреть на 5.0 не как на автоматическое улучшение, а как на потенциальный источник двух параллельных миров. Это относится и к разным ORM-решениям, и к validation/serialization-инструментам, и к любым abstractions, где decorators были не только синтаксическим сахаром, а каналом передачи runtime-смысла.
В этом смысле TypeScript 5.0 важен как напоминание: путь от экспериментальной фичи языка к стандартной не всегда означает мягкую совместимость. Иногда он означает, что экосистеме придется решить, продолжает ли она жить на старом механизме через старый флаг, пытается ли поддерживать оба мира, или постепенно переосмысляет сами паттерны, на которых была построена. И это уже затрагивает не один фреймворк, а целый пласт TypeScript-культуры последних лет.
Это еще и хороший повод переоценить любовь к decorators вообще
В последние годы decorators во многих проектах стали восприниматься как почти естественный язык архитектуры. Особенно там, где хотелось сделать код “декларативнее”, “чище” и “похожим на framework code”. Но TypeScript 5.0 очень вовремя напоминает, что decorators — это не нейтральная форма красивого синтаксиса. Это довольно глубокий контракт между языком, эмитом, рантаймом и библиотечной архитектурой.
Именно поэтому текущий переходный момент полезен даже философски. Он заставляет команды честно спросить себя: а действительно ли decorators нужны там, где мы их используем? Или часть решений была построена вокруг них скорее из-за удобства фреймворочного стиля, чем из-за реальной архитектурной необходимости? Там, где decorators просто украшают API, экосистема, скорее всего, адаптируется со временем. Там, где на них завязана критическая runtime-магия, вопросы совместимости и будущей эволюции становятся гораздо серьезнее.
Это не аргумент против decorators. Это аргумент за более взрослое отношение к ним. TypeScript 5.0 как раз и показывает, что любая глубоко интегрированная языковая возможность рано или поздно заставляет отвечать за свои архитектурные ставки.
Что стоит делать прямо сейчас
Для прикладной команды самый здравый подход выглядит так. Во-первых, не путать новые standard decorators и старые experimental decorators, даже если синтаксис похож. Во-вторых, не рассчитывать, что NestJS и похожие библиотеки просто переедут на новую модель без изменений. В-третьих, внимательно следить за тем, какие части вашей собственной кодовой базы опираются на metadata и parameter decorators, потому что именно здесь находится самая жесткая граница несовместимости. И, наконец, не спешить делать из TypeScript 5.0 вывод “decorators наконец стабилизировались, можно строить на них что угодно без оглядки”. Наоборот: именно сейчас особенно ясно, что decorators — это все еще движущаяся, а не окончательно успокоившаяся зона экосистемы.
Для тех, кто пишет собственные decorators, это хороший момент начать смотреть на новую сигнатурную модель и на context object не как на далекую теорию, а как на вероятное будущее прикладного кода. Для тех, кто сидит на NestJS, это хороший момент не паниковать, но и не игнорировать происходящее. А для библиотечных авторов — пожалуй, один из самых важных сигналов последних лет: decorators в TypeScript больше нельзя воспринимать как один исторически стабильный механизм, вокруг которого можно бездумно строить долгоживущую магию.
Итог
TypeScript 5.0 делает с decorators нечто куда более серьезное, чем просто “оставляет синтаксис и слегка меняет детали”. Он приносит в язык новую, более стандартную модель decorators и одновременно очень четко показывает разрыв с legacy-миром TypeScript. Для NestJS это особенно чувствительно, потому что текущая архитектура фреймворка глубоко завязана на старую decorator-экосистему, metadata и parameter decorators — а новая proposal как раз не совместима с --emitDecoratorMetadata и не поддерживает декорирование параметров. Это означает, что для NestJS новые decorators пока важнее как стратегический сдвиг и источник ограничений, чем как готовый маршрут немедленной миграции.
Но этим значение темы не исчерпывается. Для всей TypeScript-экосистемы это сигнал о взрослении языка и одновременно о том, что привычные decorator-паттерны больше нельзя считать автоматически совместимыми с будущим стандартным направлением. Библиотеки, DI-системы, метапрограммирование и даже просто стиль архитектурной декларативности теперь оказываются в новой реальности, где старый и новый decorator-world существуют рядом, но не сливаются в одну бесшовную модель.
Если сформулировать главный практический вывод совсем прямо, он будет таким: TypeScript 5.0 не чинит decorators для всех — он делает очевидным, что decorators теперь не один механизм, а два, и что экосистеме, особенно NestJS, предстоит прожить переходную фазу между исторически удобной legacy-моделью и новым стандартным направлением JavaScript, расплачиваясь за этот переход совместимостью metadata и parameter decorators. И чем раньше посмотреть на это без иллюзий, тем спокойнее можно принимать дальнейшие решения — и в кодовой базе, и в архитектуре библиотек, и в отношении к decorators как таковым.