0Pricing
TypeScript Academy · Урок

Декораторы параметров и метаданные

Используйте декораторы параметров вместе с reflect-metadata

«Декораторы параметров и метаданные» — бесплатный урок TypeScript Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения TypeScript Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс TypeScript Academy содержит 4 уроков всего.

Добро пожаловать

В этом уроке рассматриваются декораторы параметров и метаданные в TypeScript.

Введение

Декораторы — это предложение JavaScript третьего этапа и экспериментальная возможность TypeScript для добавления метаданных и изменения классов и их членов.

Основная концепция

Декоратор — это функция, применяемая к классу, методу, свойству или параметру с помощью синтаксиса @.
@sealed
class BugReport {
  type = 'report';
  title: string;
  constructor(t: string) { this.title = t; }
}

Декоратор класса

Декораторы классов получают функцию-конструктор и могут вернуть её изменённую версию.
function sealed(constructor: Function) {
  Object.seal(constructor);
  Object.seal(constructor.prototype);
}

Декоратор метода

Декораторы методов получают целевой объект, имя свойства и дескриптор свойства.
function log(target: any, key: string, desc: PropertyDescriptor) {
  const orig = desc.value;
  desc.value = function(...args: any[]) {
    console.log('Calling', key);
    return orig.apply(this, args);
  };
}

Декоратор свойства

Декораторы свойств получают целевой объект и ключ свойства. Они не могут напрямую перехватывать операции чтения и записи.
function readonly(target: any, key: string) {
  Object.defineProperty(target, key, { writable: false });
}

Декоратор параметра

Декораторы параметров получают целевой объект, имя метода и индекс параметра.
function required(target: any, key: string, index: number) {
  const meta = Reflect.getMetadata('required', target, key) || [];
  meta.push(index);
  Reflect.defineMetadata('required', meta, target, key);
}

Фабрики декораторов

Фабрика декоратора — это функция, возвращающая декоратор. Она принимает параметры конфигурации.
function role(name: string) {
  return function(target: any, key: string) {
    Reflect.defineMetadata('role', name, target, key);
  };
}

class UserController {
  @role('admin')
  deleteUser() {}
}

Декораторы NestJS

NestJS активно использует декораторы для контроллеров, внедрения зависимостей и маршрутизации.
@Controller('users')
class UsersController {
  constructor(private usersService: UsersService) {}

  @Get()
  findAll(): User[] {
    return this.usersService.findAll();
  }
}

reflect-metadata

Декораторы часто работают с полифиллом reflect-metadata для сохранения и получения метаданных во время выполнения.
import 'reflect-metadata';
// Enable in tsconfig: experimentalDecorators: true, emitDecoratorMetadata: true

Порядок декораторов

Несколько декораторов в одном объявлении применяются снизу вверх: последний записанный вычисляется первым.
@first
@second
class Example {}
// Applied: second first, then first

Быстрая проверка

Какая конфигурация TypeScript необходима для использования декораторов?

Итоги

Декораторы используют синтаксис @ для изменения классов, методов, свойств и параметров. Они включаются с помощью experimentalDecorators в tsconfig и широко используются такими платформами, как NestJS и Angular.

Часто задаваемые вопросы

Урок «Декораторы параметров и метаданные» бесплатный?

Да — полный текст урока «Декораторы параметров и метаданные» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс TypeScript Academy, подпишись на CoddyKit PRO. Курс TypeScript Academy содержит 4 уроков всего.

Чему я научусь в уроке «Декораторы параметров и метаданные»?

Используйте декораторы параметров вместе с reflect-metadata Ты практикуешь TypeScript Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать TypeScript Academy?

Предыдущий опыт не требуется. TypeScript Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Декораторы параметров и метаданные»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке TypeScript Academy?

Да. Каждый урок TypeScript Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Декораторы классов: обёртка поведения
  2. Декораторы методов и свойств
  3. Декораторы параметров и метаданные
  4. Декораторы во фреймворках: пример NestJS
← Назад к TypeScript Academy