Seriya: TypeScript Basics Dars 75

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:

  1. ./components/Button.ts
  2. ./components/Button.tsx
  3. ./components/Button.d.ts
  4. ./components/Button/index.ts (papka bo'lsa)

Birinchi topilgani ishlatiladi.

2. Paket import'i qanday qidiriladi

import axios from "axios";
  1. node_modules/axios papkasini topadi (topilmasa, yuqori papkalardagi node_modules'ga chiqadi).
  2. package.json ichidagi types yoki exports maydoniga qaraydi.
  3. 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 @types mavjudligini tekshiring.
  • Uzun ../../../ yo'llardan qutulish uchun path aliases ishlatiladi — buni keyingi darsda ko'ramiz.