Series: TypeScript Basics Lesson 74

Barrel exports

TypeScript'da barrel export'lar: papka export'larini bitta index.ts'ga yig'ish, export *, afzalliklari, xavfli tomonlari (ortiqcha yuklanish, circular import, nom ziddiyati) va to'g'ri ishlatish qoidalari.

74-dars

Barrel exports

Barrel — bu bir papkadagi ko'p fayllarning export'larini bitta index.ts faylga yig'ib, tashqariga bitta joydan beradigan usul.

Hayotiy o'xshatish: do'konning bitta kassasi. Mahsulotlar har xil javonda turadi, lekin hammasini bitta kassadan olasiz.

Muammo (barrel yo'q)

import { Button } from "./components/Button";
import { Input } from "./components/Input";
import { Modal } from "./components/Modal";
import { Card } from "./components/Card";

Yechim (barrel bor)

// components/index.ts
export { Button } from "./Button";
export { Input } from "./Input";
export { Modal } from "./Modal";
export { Card } from "./Card";
export type { ButtonProps } from "./Button";
// istalgan joyda
import { Button, Input, Modal, Card } from "./components";

./components deb yozilganda papkadagi index.ts avtomatik ochiladi. (Bu Vite, webpack kabi bundler'lar va "moduleResolution": "bundler" sozlamasida ishlaydi. Node.js'ning ESM rejimida — "nodenext" — yo'lni to'liq yozish kerak: "./components/index.js".)

Hammasini birdan eksport qilish

// components/index.ts
export * from "./Button";
export * from "./Input";

Nega kerak?

  • Import'lar qisqa va toza bo'ladi.
  • Papka ichidagi tuzilmani o'zgartirsangiz, tashqaridagi import'lar buzilmaydi, faqat index.ts'ni yangilaysiz.
  • Papka ochiq API'ga ega bo'ladi: nimani tashqariga berishni o'zingiz hal qilasiz.

Xavfli tomonlari

Ortiqcha yuklanish. Button'ni import qilsangiz ham, ba'zi bundler'lar butun barrel'ni yuklaydi. Natijada build sekinlashadi va bundle kattalashadi.

Circular import. Papka ichidagi fayl o'z barrel'idan import qilsa, aylanma bog'liqlik paydo bo'ladi:

// components/Modal.ts
import { Button } from "./index"; // ❌ xavfli: index.ts esa Modal'ni import qiladi
// components/Modal.ts
import { Button } from "./Button"; // ✅ papka ichida to'g'ridan-to'g'ri import

Nom ziddiyati. export *'da ikki faylda bir xil nom bo'lsa, ziddiyat chiqadi:

// Button.ts va Input.ts ikkalasida ham: export type Size = ...

// components/index.ts
export * from "./Button";
export * from "./Input";
// ❌ Module './Button' has already exported a member named 'Size'.
//    Consider explicitly re-exporting to resolve the ambiguity.

Eslab qoling

  • Barrel'ni katta modul chegarasida ishlating (components, utils, features/auth), har bir kichik papkada shart emas.
  • Papka ichida barrel orqali emas, faylning o'zidan import qiling.
  • Type'larni export type bilan eksport qiling (73-dars).