Chapter 49 — NPM & Package Management

Bu bobda JavaScript ekotizimining eng katta kutubxonalar ombori — NPM (Node Package Manager) bilan ishlashni o'rganamiz.

---

49.1 NPM nima?

Simple Explanation

NPM — boshqa dasturchilar yozgan tayyor kod bo'laklari (kutubxonalar, packagelar)ni topish, o'rnatish va loyihangizda ishlatish imkonini beruvchi vosita.

Why Does It Exist?

Har safar oddiy narsalarni (masalan, sanani formatlash, so'rov yuborish) noldan yozish o'rniga, minglab dasturchilar tomonidan allaqachon yozilgan, sinovdan o'tgan kodni ishlatish — vaqtni tejaydi va xatolarni kamaytiradi.

Real-Life Analogy

🧰 NPM — bu ulkan asboblar do'koni: har safar bolg'a yasashni o'rganish o'rniga, siz uni do'kondan (NPM'dan) sotib olib (o'rnatib), to'g'ridan-to'g'ri ishlatasiz.

49.2 package.json — Loyiha "pasporti"

Simple Explanation

package.json — har qanday Node.js loyihasining markazidagi fayl, u loyiha haqidagi barcha muhim ma'lumotni (nomi, versiyasi, bog'liqliklari) saqlaydi.

Example

data.json
JSONNusxalash
01{
02    "name": "mening-loyiham",
03    "version": "1.0.0",
04    "description": "Oddiy JavaScript loyihasi",
05    "main": "index.js",
06    "scripts": {
07        "start": "node index.js",
08        "test": "jest"
09    },
10    "dependencies": {
11        "lodash": "^4.17.21"
12    },
13    "devDependencies": {
14        "jest": "^29.0.0"
15    }
16}

Jadval — Muhim maydonlar

49.3 Asosiy NPM buyruqlari

Jadval

Example — Amaliy foydalanish

terminal.sh
BashNusxalash
01npm init -y                    # tezkor package.json yaratish
02npm install lodash             # lodash kutubxonasini o'rnatish
03npm install jest --save-dev    # jest'ni faqat dev uchun o'rnatish
04npm run start                  # package.json'dagi "start" scriptini ishga tushirish

49.4 ⚠️ Qiyin mavzu: Semantic Versioning (SemVer)

Simple Explanation

Kutubxona versiyalari MAJOR.MINOR.PATCH (masalan, 4.17.21) formatida yoziladi, va har bir raqamning aniq ma'nosi bor — bu Semantic Versioning deb ataladi.

Jadval — Versiya raqamlarining ma'nosi

package.json'dagi maxsus belgilar

data.json
JSONNusxalash
01{
02    "dependencies": {
03        "lodash": "^4.17.21",
04        "express": "~4.18.0",
05        "react": "18.2.0"
06    }
07}

Jadval — Belgilarning ma'nosi

Explanation

^ (caret) — eng ko'p ishlatiladigan belgi, u kichik yangilanishlarni avtomatik qabul qiladi, lekin katta ("moslik buzuvchi") o'zgarishlarni oldini oladi.

⚠️ Common Mistake
^ yoki ~ belgilarisiz, aniq versiyani "qotirib qo'yish" ("lodash": "4.17.21") — xavfsizlik yangilanishlari (patch)ni ham avtomatik olishni to'xtatadi. Ko'p hollarda, ^ bilan qoldirish tavsiya etiladi.

49.5 node_modules va package-lock.json

Simple Explanation

• node_modules — barcha o'rnatilgan paketlarning haqiqiy kodi saqlanadigan papka.
• package-lock.json — o'rnatilgan paketlarning aniq versiyalarini "qulflab" qo'yuvchi fayl, bu boshqa kompyuterda loyiha aynan bir xil versiyalar bilan ishlashini kafolatlaydi.

Real-Life Analogy

🔒 package.jsondagi ^4.17.21 — "4-versiya oilasidan istalgani" degani, package-lock.json esa — "aynan 4.17.21, nuqtama-nuqta" deb "qulflab qo'yadi", shunda barcha dasturchilar (va serverlar) bir xil versiyalar bilan ishlaydi.

🔥 Important
node_modules papkasi — odatda juda katta (yuzlab MB) bo'ladi va hech qachon loyihaning versiya nazorati tizimiga (Git) qo'shilmaydi. package-lock.json esa — har doim qo'shilishi kerak, chunki u versiyalarning izchilligini ta'minlaydi.

49.6 Paketlarni loyihada ishlatish

Example

terminal.sh
BashNusxalash
01npm install lodash

script.js
JavaScriptNusxalash
01// CommonJS
02const _ = require("lodash");
03 
04console.log(_.capitalize("salom")); // "Salom"
05 
06// ES Modules
07import _ from "lodash";
08 
09console.log(_.capitalize("salom")); // "Salom"

🔗 Connection
Bu — Chapter 38 (Modules) va Chapter 48 (Node.js)da o'rgangan import/require bilimlarining, tashqi (o'zingiz yozmagan) kutubxonalar bilan qo'llanilishi.

📝 Practice Exercises

🟢 Exercise 1 — Easy

Task:
Yangi package.json fayli qanday yaratilishini (npm init -y) va uning asosiy maydonlarini (name, version, scripts) tasvirlab bering.
Required Concepts:

• package.json asoslari
  Hint:
  Chapter 49.2'dagi misolni namuna sifatida ishlating.

🟡 Exercise 2 — Medium

Task:
"^2.5.0", "~2.5.0", "2.5.0" — bu uchta versiya belgisi bir xil kutubxona uchun ishlatilganda, ular qaysi versiyalarni avtomatik qabul qilishini (masalan, 2.5.1, 2.6.0, 3.0.0 kelib chiqqanda) jadval shaklida tushuntiring.
Required Concepts:

• SemVer
  Hint:
  Chapter 49.4'dagi jadvaldan foydalaning.

🔴 Exercise 3 — Hard

Task:
Oddiy package.json yozing: loyiha nomi "todo-app", versiyasi "1.0.0", dependenciesda "date-fns": "^2.30.0", devDependenciesda "jest": "^29.0.0", va scriptsda "start" ("node index.js") va "test" ("jest") buyruqlari bo'lsin.
Required Concepts:

• To'liq package.json tuzilishi
  Hint:
  Chapter 49.2'dagi misol strukturasini to'liq takrorlang, o'z qiymatlaringiz bilan.

🔮 Predict the Output

Quyidagi package.json qismi berilgan:

data.json
JSONNusxalash
01{
02    "dependencies": {
03        "some-lib": "^1.4.2"
04    }
05}

Ushbu loyiha npm install qilinganda, quyidagi versiyalardan qaysi biri avtomatik o'rnatilishi mumkin: 1.4.5, 1.5.0, 2.0.0?

🧠 Think first! Javobni ko'rishdan oldin kamida 30 soniya o'ylang.

<details> <summary>Answer</summary> 1.4.5 va 1.5.0 — mumkin. 2.0.0 — mumkin emas.

Why?
^1.4.2 — MAJOR versiya (1) o'zgarmasligi sharti bilan, MINOR va PATCH yangilanishlarga ruxsat beradi. 1.4.5 (PATCH oshgan) va 1.5.0 (MINOR oshgan) — ikkalasi ham 1.x.x oilasida qoladi. 2.0.0 — MAJOR versiya o'zgargani uchun, ^ belgisi bunga ruxsat bermaydi.

</details>

🐛 Debugging Challenge

Dasturchi loyihasini boshqa kompyuterga ko'chirdi, npm install qildi, lekin dastur boshqacha ishlay boshladi — kutubxonaning yangi, "moslik buzuvchi" versiyasi o'rnatilib qolgan edi.

data.json
JSONNusxalash
01{
02    "dependencies": {
03        "some-lib": "^1.4.2"
04    }
05}

Your Task:

• Nima uchun bu muammo yuz berishi mumkinligini tushuntiring.
• Buni oldini olish uchun qaysi fayl (Chapter 49.5'dan) muhim ekanini ayting.

<details> <summary>Solution</summary> Tushuntirish: ^1.4.2 — 1.x.x oilasidagi istalgan versiyaga ruxsat beradi. Agar birinchi kompyuterda npm install qilingan paytda 1.4.2 o'rnatilgan bo'lsa-yu, ikkinchi kompyuterda esa vaqt o'tib 1.9.0 versiyasi chiqqan bo'lsa, ikkinchi marta npm install qilinganda — yangi, potentsial boshqacha xatti-harakatga ega 1.9.0 o'rnatilishi mumkin.

Yechim: package-lock.json faylini har doim loyiha bilan birga (Git orqali) saqlash va ko'chirish kerak — bu fayl aniq o'rnatilgan versiyalarni "qulflab" qo'yadi, shuning uchun barcha kompyuterlarda bir xil versiyalar o'rnatiladi.

</details>

📌 Chapter Summary

• NPM — tayyor JavaScript kutubxonalarini topish va o'rnatish uchun ishlatiladi.
• package.json — loyiha haqidagi barcha muhim ma'lumotni saqlaydi.
• Semantic Versioning (MAJOR.MINOR.PATCH) — versiyalarning ma'nosini standartlashtiradi.
• ^ va ~ belgilari — avtomatik yangilanishlarning qamrovini belgilaydi.
• package-lock.json — barcha muhitlarda bir xil versiyalarni kafolatlaydi.

🎯 Key Takeaways

• dependencies — dastur uchun zarur, devDependencies — faqat ishlab chiqish uchun.
• ^ — eng keng tarqalgan versiya belgisi, kichik yangilanishlarga ruxsat beradi.
• node_modules — Git'ga qo'shilmaydi, package-lock.json — albatta qo'shiladi.
• npm run <script> — package.jsondagi buyruqlarni qulay ishga tushirish usuli.
• NPM ekotizimi — Chapter 38 (Modules) va Chapter 48 (Node.js) bilimlarini amaliy loyihalarda qo'llash imkonini beradi.

⚡ Quick Cheat Sheet

terminal.sh
BashNusxalash
01npm init -y
02npm install <paket>
03npm install <paket> --save-dev
04npm install
05npm uninstall <paket>
06npm run <script-nomi>

data.json
JSONNusxalash
01{
02    "dependencies": { "lib": "^1.0.0" },
03    "devDependencies": { "test-lib": "^2.0.0" },
04    "scripts": { "start": "node index.js" }
05}

---