Dekoratory w NestJS

Back-end

minuta czytania

nestjsjavascriptpython

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

Medusa.js – elastyczna alternatywa dla Shopify i innych e-commerce

10 paź 2025

E-commerce rozwija się w błyskawicznym tempie, a firmy coraz częściej poszukują rozwiązań, które dadzą im większą elastyczność niż klasyczne platformy SaaS. Shopify czy WooCommerce świetnie sprawdzają się na starcie, ale szybko okazuje się, że mają swoje ograniczenia – zarówno kosztowe, jak i technologiczne. W odpowiedzi na te wyzwania powstała Medusa.js – nowoczesny framework open-source, który łączy zalety architektury headless z pełną kontrolą nad kodem i danymi. To alternatywa, która daje biznesom możliwość tworzenia skalowalnych, spersonalizowanych sklepów dopasowanych do indywidualnych potrzeb.

Tomasz Kozon
#fullstack
related-article-image-checkout, komputer, Medusa.js

Commerce as a Service: Przyszłość e-commerce w modelu chmurowym

2 paź 2025

E-commerce przechodzi obecnie jedną z największych transformacji od czasu swojego powstania. Tradycyjne, monolityczne platformy sprzedażowe ustępują miejsca rozwiązaniom chmurowym, które oferują elastyczność i szybkość działania. Commerce as a Service (CaaS) to nowy model, który pozwala firmom budować własny ekosystem sprzedaży w oparciu o modułowe usługi dostępne przez API.

Tomasz Kozon
#back-end

Czym jest Commerce.js i jak może pomóc w e-commerce?

29 wrz 2025

W dynamicznie zmieniającym się świecie internetowego handlu, Commerce.js pojawia się jako potężny sprzymierzeniec w kreowaniu skutecznej strategii e-commerce. Ten wysoko konfigurowalny framework, dający olbrzymie możliwości personalizacji sklepów internetowych, przenosi funkcjonalność e-handlu na zupełnie nowy poziom. W artykule przyjrzymy się bliżej jego możliwościom.

Tomasz Kozon
#fullstack

Capacitor – most między aplikacjami webowymi a natywnymi

26 wrz 2025

W świecie tworzenia aplikacji mobilnych i desktopowych coraz większą rolę odgrywają rozwiązania pozwalające łączyć technologie webowe z natywnymi. Jednym z najciekawszych narzędzi tego typu jest Capacitor. Umożliwia ona budowanie aplikacji w HTML, CSS i JavaScript, które działają jak pełnoprawne aplikacje mobilne i desktopowe, z dostępem do natywnych API. Dzięki temu deweloperzy mogą tworzyć wieloplatformowe rozwiązania szybciej, wydajniej i bez konieczności rezygnowania z ekosystemu webowego.

Tomasz Kozon
#mobile

Convex – rewolucja w tworzeniu aplikacji w czasie rzeczywistym

10 wrz 2025

W świecie, w którym użytkownicy oczekują natychmiastowych reakcji i płynnej interakcji, tworzenie aplikacji w czasie rzeczywistym staje się nie tylko wyzwaniem, ale i koniecznością. Convex to nowoczesna platforma backendowa, która upraszcza ten proces, łącząc synchronizację danych, logikę biznesową i skalowalność w jednym ekosystemie. Dzięki niej deweloperzy mogą budować interaktywne aplikacje bez konieczności konfigurowania skomplikowanej infrastruktury czy zarządzania WebSocketami.

Tomasz Kozon
#back-end

Azure Databricks: definicja, możliwości i powody, dla których warto go znać

4 wrz 2025

Azure Databricks to innowacyjna usługa analityczna w chmurze, której zadaniem jest umożliwienie przetwarzania dużych zbiorów danych w czasie rzeczywistym. Wykorzystując potencjał technologii Spark, stanowi potężne narzędzie do analizy Big Data. Poznajmy Azure Databricks: jego definicję, możliwości, a także powody, dla których warto zapoznać się z tą technologią.

Tomasz Kozon
#bigdata

htmx – prosta droga do dynamicznych aplikacji bez frameworków

2 wrz 2025

Dynamiczne aplikacje webowe kojarzą się zazwyczaj z rozbudowanymi frameworkami front-endowymi, które wymagają sporej wiedzy i skomplikowanej konfiguracji. Tymczasem istnieje prostsza droga – htmx, biblioteka pozwalająca tworzyć interaktywne interfejsy niemal wyłącznie przy użyciu HTML. Dzięki niej można uniknąć pisania dużej ilości kodu JavaScript i w naturalny sposób połączyć front-end z backendem.

Tomasz Kozon
#front-end

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