Мощь декораторов TypeScript на живых примерах. Декорирование методов класса

А ещё можно эти столбики декораторов сжимать, если там повторяющиеся общие паттерны действий у методов.

Например такой код:

    @GetArrayWithCache('symbol/:id')
    @InfluxTimeLog()
    async getSymbol(@Headers() headers: object, @Param('id') id: string): TProxyItem {
        return this.symbolsService.getById(id);
    }

может иметь такой вот составной декоратор

export function GetArrayWithCache(path: string) {
    return applyDecorators(
        Get(path),
        ApiOkResponse(ARRAY_RESPONSE_DOC),
        ApiOperation(ARRAY_CACHE_DOC),
        CheckNotFound(),
    );
}

где applyDecorators это функция-склеиватель

export function applyDecorators(
  ...decorators: Array<ClassDecorator | MethodDecorator | PropertyDecorator>
) {
    return <TFunction extends Function, Y>(
      target: TFunction | object,
      propertyKey?: string | symbol,
      descriptor?: TypedPropertyDescriptor<Y>,
    ) => {
        for (const decorator of decorators) {
            if (target instanceof Function && !descriptor) {
                (decorator as ClassDecorator)(target);
                continue;
            }
            (decorator as MethodDecorator | PropertyDecorator)(
                target,
                propertyKey,
                descriptor,
            );
        }
    };
}

И, как видите, в составном декораторе можно передать параметры... в том числе и другие декораторы, если это нужно.

А ещё декораторами можно описывать апи и в итоге вместо писанины ручной валидации или конфигов или каких-либо других хитросплетений - мы можем просто сделать так

export class AccountListArgs {
    @Property({
        enum: EFieldsSortingAccounts,
        description: 'orderBy',
    })
    @IsOptional()
    @IsEnum(EFieldsSortingAccounts)
    orderBy?: EFieldsSortingAccounts = EFieldsSortingAccounts.ID;
}

и, натравив туда пакеты class-transformer и class-validator с ходу отвалидировать на тип, енум, не обязательность наличия и ещё сверху сгенерировать swagger-схему и на лету её показать на отдельном урле с документацией.

В общем, если вы ещё не используете декораторы - время пришло.

Жду "карамелизаторов" и "лакираторов"

Если к члену класса прикреплены несколько декораторов, их выполнение происходит сверху вниз по очереди.

хмм, в моей шпаргалке записано так:
Если декораторы записываются в столбик, то вызываются они снизу вверх (при этом предварительное вычисление идёт сверху вниз)