Module resolution
TypeScript'da module resolution: import yo'lidan faylni topish, relative va paket import'lari qanday qidiriladi, "Cannot find module" xatosi, moduleResolution strategiyalari va nodenext'da fayl kengaytmasi.
75-dars
Module resolution
Module resolution — bu TypeScript'ning import'dagi yo'lga qarab qaysi faylni ochishni aniqlash jarayoni. Siz import { x } from "..." deb yozasiz, TypeScript esa shu faylni diskdan qidirib topadi.
Hayotiy o'xshatish: pochtachi. Siz manzilni yozasiz, pochtachi esa ma'lum qoidalar bo'yicha uyni qidirib topadi. Manzil noto'g'ri bo'lsa, xat yetib bormaydi.
Ikki xil import
import { Button } from "./components/Button"; // relative: ./ yoki ../ bilan boshlanadi
import axios from "axios"; // non-relative: paket nomi
1. Relative import qanday qidiriladi
import { Button } from "./components/Button";
TypeScript ketma-ket tekshiradi:
./components/Button.ts./components/Button.tsx./components/Button.d.ts./components/Button/index.ts(papka bo'lsa)
Birinchi topilgani ishlatiladi.
2. Paket import'i qanday qidiriladi
import axios from "axios";
node_modules/axiospapkasini topadi (topilmasa, yuqori papkalardaginode_modules'ga chiqadi).package.jsonichidagitypesyokiexportsmaydoniga qaraydi.- Type topilmasa,
node_modules/@types/axios'ni qidiradi.
Xato holat
import { Button } from "./component/Button";
// ❌ Cannot find module './component/Button' or its corresponding type declarations.
Bu xato yo'l noto'g'ri yoki fayl yo'q degani.
Strategiyani tsconfig.json'da tanlaysiz
{
"compilerOptions": {
"moduleResolution": "bundler"
}
}
| Qiymat | Qachon |
|---|---|
bundler |
Vite, Webpack, Next.js loyihalari (frontend uchun eng ko'p ishlatiladi) |
nodenext |
Toza Node.js loyihalari |
node10 |
Eski loyihalar, yangilarida ishlatilmaydi |
nodenext'dagi muhim farq: u fayl kengaytmasini yozishni talab qiladi.
import { sum } from "./math";
// ❌ nodenext'da: Relative import paths need explicit file extensions in ECMAScript imports
// when '--moduleResolution' is 'node16' or 'nodenext'. Did you mean './math.js'?
import { sum } from "./math.js"; // ✅ .ts fayl bo'lsa ham .js yoziladi
.js yozilishining sababi: Node.js kompilyatsiyadan keyingi .js fayllarni ishga tushiradi, TypeScript esa import yo'llarini o'zgartirmaydi. Shuning uchun yo'l yakuniy JS fayliga qarab yoziladi.
Eslab qoling
- Frontendda odatda
"moduleResolution": "bundler"qo'yiladi. - "Cannot find module" xatosida avval yo'lni, keyin paket o'rnatilganini, oxirida
@typesmavjudligini tekshiring. - Uzun
../../../yo'llardan qutulish uchun path aliases ishlatiladi — buni keyingi darsda ko'ramiz.