Birinchi qadamlar

Ushbu maqolalar to‘plamida siz Nest’ning asosiy fundamentlarini o‘rganasiz. Nest ilovalarining muhim “building block”lari (asosiy tarkibiy qismlari) bilan tanishish uchun kirish darajasida keng ko‘lamli funksiyalarni qamrab oladigan oddiy CRUD ilovasini quramiz.

Til

Biz TypeScript’ni juda yaxshi ko‘ramiz, ammo eng avvalo — Node.js’ni yaxshi ko‘ramiz. Shuning uchun Nest ham TypeScript, ham sof JavaScript bilan mos ishlaydi. Nest tilning eng so‘nggi imkoniyatlaridan foydalanadi, shu sababli uni “vanilla” JavaScript bilan ishlatish uchun bizga Babel kompilyatori kerak bo‘ladi.

Misollarda asosan TypeScript’dan foydalanamiz, ammo siz istalgan payt code snippetlarni vanilla JavaScript sintaksisiga almashtirishingiz mumkin (har bir snippet’ning yuqori o‘ng burchagidagi til tugmasini bosib toggling qiling).

Oldindan talablar

Operatsion tizimingizga Node.js (version >= 20) o‘rnatilganiga ishonch hosil qiling.

Sozlash

Yangi loyiha yaratish Nest CLI bilan juda oson. Agar sizda npm o‘rnatilgan bo‘lsa, OS terminalingizda quyidagi buyruqlar orqali yangi Nest loyihasini yaratishingiz mumkin:

1$ npm i -g @nestjs/cli
2$ nest new project-name

project-name papkasi yaratiladi, node modules va yana bir nechta boilerplate fayllar o‘rnatiladi, so‘ng src/ papkasi yaratiladi va bir nechta asosiy (core) fayllar bilan to‘ldiriladi.

Quyida shu asosiy fayllar haqida qisqa overview:

main.ts ichida async funksiya bor va u ilovamizni bootstrap qiladi:

1import { NestFactory } from '@nestjs/core';
2import { AppModule } from './app.module';
3
4async function bootstrap() {
5  const app = await NestFactory.create(AppModule);
6  await app.listen(process.env.PORT ?? 3000);
7}
8bootstrap();

Nest ilovasi instansiyasini yaratish uchun biz core NestFactory class’idan foydalanamiz. NestFactory ilova instansiyasini yaratishga imkon beradigan bir nechta static metodlarni taqdim etadi. create() metodi INestApplication interface’ini qanoatlantiradigan application object’ni qaytaradi. Bu object kelgusi bo‘limlarda tushuntiriladigan metodlar to‘plamini beradi. Yuqoridagi main.ts misolida biz shunchaki HTTP listener’ni ishga tushiramiz — natijada ilova kiruvchi HTTP so‘rovlarni kutib oladi.

E’tibor bering: Nest CLI orqali scaffold qilingan loyiha boshlang‘ich struktura yaratadi va bu struktura dasturchilarni har bir modulni o‘ziga ajratilgan alohida papkada saqlash konvensiyasiga rioya qilishga undaydi.

Platforma

Nest platformadan mustaqil (platform-agnostic) framework bo‘lishni maqsad qiladi. Platforma mustaqilligi qayta ishlatish mumkin bo‘lgan mantiqiy qismlarni yaratishga yordam beradi — dasturchilar bu qismlardan turli xil ilova turlarida foydalanishlari mumkin. Texnik jihatdan, adapter yaratilgan bo‘lsa, Nest istalgan Node HTTP framework bilan ishlay oladi. “Out-of-the-box” qo‘llab-quvvatlanadigan 2 ta HTTP platforma bor: express va fastify. Siz ehtiyojingizga eng mosini tanlashingiz mumkin.

Qaysi platforma ishlatilishidan qat’i nazar, u o‘zining application interface’ini expose qiladi. Bular mos ravishda NestExpressApplication va NestFastifyApplication deb ko‘riladi.

Quyidagi misolda ko‘ringanidek, NestFactory.create() metodiga type bersangiz, app object’ida aynan o‘sha platformaga xos bo‘lgan metodlar ham paydo bo‘ladi. Biroq, siz underlying platform API’iga murojaat qilmoqchi bo‘lmasangiz, type ko‘rsatishingiz shart emas.

1const app = await NestFactory.create<NestExpressApplication>(AppModule);

Ilovani ishga tushirish

O‘rnatish jarayoni tugagach, kiruvchi HTTP so‘rovlarni kutib oladigan serverni ishga tushirish uchun OS terminalingizda quyidagi buyruqni bajaring:

1$ npm run start

Bu buyruq ilovani src/main.ts faylida belgilangan portda HTTP server bilan ishga tushiradi. Ilova ishga tushgach, brauzerni ochib http://localhost:3000/ manziliga o‘ting. Siz Hello World! xabarini ko‘rishingiz kerak.

Fayllaringizdagi o‘zgarishlarni kuzatib borish uchun ilovani quyidagi buyruq bilan ishga tushirishingiz mumkin:

1$ npm run start:dev

Bu buyruq fayllaringizni kuzatadi va serverni avtomatik qayta kompilyatsiya qilib, qayta yuklaydi.

Linting va formatting

CLI katta miqyosda ishonchli development workflow’ni scaffold qilishga “best effort” qiladi. Shu sababli, generatsiya qilingan Nest loyihasida code linter va formatter oldindan o‘rnatilgan bo‘ladi (mos ravishda eslint va prettier).

Maksimal barqarorlik va kengaytiriluvchanlik uchun biz bazaviy eslint va prettier cli paketlaridan foydalanamiz. Bu setup dizayni bo‘yicha official extension’lar orqali IDE bilan chiroyli integratsiyani ta’minlaydi.

IDE kerak bo‘lmagan headless muhitlar (Continuous Integration, Git hooks va boshqalar) uchun Nest loyihasida tayyor npm script’lar mavjud.

1# Lint and autofix with eslint
2$ npm run lint
3
4# Format with prettier
5$ npm run format