Dekoratory w NestJS

Back-end

minuta czytania

nestjs

javascript

python

Dekoratory znane w wielu językach programowania, służą do wywoływania funkcji wyższego rzędu w prosty dla developerów sposób. W Nest są one wykorzystywane do deklaracji m.in. modułów, kontrolerów czy klas.

Spis treści

Łączenie dekoratorów

Tworzenie własnych dekoratorów

Podsumowanie

Programowanie, Dekoratory w NestJS

Umów się na bezpłatną konsultację

Twoje dane przetwarzamy zgodnie z naszą polityką prywatności.

Dekoratory są bardzo dobrze znane w wielu językach programowania (np. Python), jednak w JavaScript są w dalszym ciągu relatywnie nowe. Są one wyrażeniami, które zwracają funkcje, a jako argumenty przyjmują target, nazwę oraz tak zwany property descriptor. Ich zadaniem jest możliwość wywoływania funkcji wyższego rzędu (ang. Higher-Order Functions) w przyjazny dla developera sposób - z wykorzystaniem znaku “@”. 

 

W Nest dekoratory są stosowane m.in. do deklaracji:

  • modułów - @Module(), 
  • kontrolerów- @Controller(),
  • klas, które mogą być wstrzykiwane (dependency injection), najczęściej serwisy - @injectable(). 

 

Nest udostępnia również zestaw przydatnych dekoratorów dla parametrów, których można używać razem z protokołem HTTP:

  • @Request(), @Req(),
  • @Response(), @Res(),
  • @Next(),
  • @Session(),
  • @Param(param?: string),
  • @Body(param?: string),
  • @Query(param?: string),
  • @Headers(param?: string),
  • @Ip(),
  • @HostParam().

 

Łączenie dekoratorów

Nic nie stoi na przeszkodzie, aby wykorzystać wiele dekoratorów naraz dla jednej funkcji. Można tego dokonać na dwa sposoby - wywołując dekoratory jeden pod drugim

@Get()
@HttpCode(HttpStatus.OK)
async findAll() {
  return await this.usersService.findAll();
}


lub za pomocą funkcji applyDecorators dostarczanej przez Nest. Ten sposób wymagał będzie stworzenia nowego dekoratora, który połączy nam wszystkie wymagane dekoratory:

const GetWithOkHttpStatus = () => applyDecorators(
  Get(),
  HttpCode(HttpStatus.OK)
) 
@GetWithOkHttpStatus()
async findAll() {
  return await this.usersService.findAll();
}
Czy szukasz wykonawcy projektów IT ?
logo
Sprawdź case studies

Tworzenie własnych dekoratorów

Można tego dokonać wykorzystując funkcję createParamDecorator - również dostarczanej przez Nest.

const CarDecorator = createParamDecorator(
  (data: unknown, ctx: ExecutionContext) => {
    const request = ctx.switchToHttp().getRequest();
    return request.car;
  },
);

 

Powyższy przykład pokazuje jak w prosty sposób wyciągnąć klucz “car” z obiektu request, by następnie użyć go w metodzie obsługującej daną trasę.

@Get()
async findOne(@Car() car: Car) {
  console.log(car);
}

Podsumowanie

Dekoratory są narzędziem, które pozwala zachować utrzymywać czystość kodu na równi z jego funkcjonowaniem. Mimo tego, że nie są one zbyt popularne w języku JavaScript, Nest wykorzystuje je w każdym zakątku aplikacji w sposób łatwy i przejrzysty. 

Nasza oferta

Web development

Dowiedz się więcej

Mobile development

Dowiedz się więcej

E-commerce

Dowiedz się więcej

Projektowanie UX/UI

Dowiedz się więcej

Outsourcing

Dowiedz się więcej

SEO

Dowiedz się więcej

Powiązane artykuły

Aplikacje mobilne — native czy hybrydowe?

28 mar 2025

Wybór odpowiedniej technologii do tworzenia aplikacji mobilnej to jedna z pierwszych i najważniejszych decyzji w procesie projektowania produktu cyfrowego. Dylemat: aplikacja natywna czy hybrydowa – dotyczy nie tylko aspektów technicznych, ale też strategicznych, takich jak czas realizacji, budżet czy skalowalność. Każde z tych podejść ma swoje zalety i ograniczenia, a optymalny wybór zależy od celów biznesowych i oczekiwań użytkowników.

Tomasz Kozon

#mobile

related-article-image-ręka trzymająca telefon, Aplikacje mobilne: Native czy hybrydowe

Najważniejsze technologie do tworzenia aplikacji webowych na 2025 rok

27 mar 2025

Tworzenie aplikacji webowych zmienia się z roku na rok – pojawiają się nowe narzędzia, frameworki i podejścia, które ułatwiają pracę programistom i poprawiają jakość końcowych produktów. W 2025 roku szczególnie widać nacisk na wydajność, automatyzację i lepsze doświadczenia użytkownika. Technologie stają się coraz bardziej inteligentne, szybkie i dostępne. W tym artykule przedstawiamy najważniejsze trendy i rozwiązania, które kształtują web development w nadchodzącym czasie.

Tomasz Kozon

#fullstack

Wprowadzenie do Payload CMS: Nowoczesny headless CMS

25 mar 2025

Payload CMS to jedno z najciekawszych rozwiązań w świecie nowoczesnych systemów zarządzania treścią. Łączy podejście headless z pełną kontrolą nad backendem i elastycznością, której często brakuje w innych CMS-ach. Skierowany przede wszystkim do developerów, pozwala tworzyć zaawansowane projekty bez kompromisów. W tym artykule przyjrzymy się bliżej, czym wyróżnia się Payload, jak działa i dlaczego warto mieć go na radarze przy budowie nowoczesnych aplikacji webowych.

Tomasz Kozon

#fullstack

Codium AI: Jak wykorzystać sztuczną inteligencję do pisania kodu?

24 mar 2025

W świecie, gdzie tempo pracy programisty stale rośnie, a wymagania co do jakości kodu są coraz wyższe, narzędzia oparte na sztucznej inteligencji stają się realnym wsparciem w codziennych zadaniach. Codium AI to jedno z tych rozwiązań, które potrafi nie tylko przyspieszyć proces pisania testów, ale także pomóc w analizie i optymalizacji kodu. W tym artykule przyjrzymy się, jak działa Codium AI, jak je zintegrować z popularnymi edytorami oraz w jaki sposób może ono zwiększyć efektywność i bezpieczeństwo pracy programisty. Jeśli chcesz tworzyć lepszy kod w krótszym czasie – czytaj dalej.

Tomasz Kozon

#testing

InertiaJS - Co to jest i dlaczego warto z niego korzystać?

23 mar 2025

InertiaJS zyskuje na popularności, jako narzędzie integrujące najnowsze frameworki frontendowe (Vue, React, Svelte) z tradycyjnymi serwerowymi technologiami backendowymi. Zrozumienie jego działania pozwala płynnie łączyć frontend i backend, bez konieczności pisania API.

Tomasz Kozon

#fullstack

Jak Codiga pomaga pisać lepszy kod? Przegląd funkcji i zastosowań

21 mar 2025

W świecie, gdzie tempo pracy programisty nieustannie rośnie, a wymagania dotyczące jakości kodu są coraz wyższe, odpowiednie narzędzia potrafią zrobić ogromną różnicę. Codiga to inteligentny pomocnik, który wspiera programistów na każdym etapie pisania kodu — od wykrywania błędów, przez poprawę bezpieczeństwa, aż po automatyzację powtarzalnych fragmentów. W tym artykule przyjrzymy się, jak Codiga działa w praktyce.

Tomasz Kozon

#testing

Amazon CodeWhisperer – co to jest i jak działa?

16 mar 2025

Amazon CodeWhisperer to inteligentny asystent kodowania, który analizuje wpisywany kod i generuje sugestie w czasie rzeczywistym, przyspieszając pracę i eliminując błędy. Dzięki integracji z popularnymi IDE oraz szerokiej obsłudze języków programowania, narzędzie to może stać się nieodłącznym elementem codziennego workflow programistów. W tym artykule przyjrzymy się bliżej temu, jak działa CodeWhisperer, jakie ma funkcje i czy warto go używać.

Tomasz Kozon

#fullstack

Zobacz wszystkie artykuły powiązane z #Back-end