TypeScript ni nini? Mwongozo Rahisi kwa Wasio Wataalamu

TypeScript ni JavaScript yenye aina. Unaongeza lebo zinazosema ni aina gani ya data kila thamani inapaswa kuwa — namba, maandishi, orodha ya oda — na TypeScript inakagua msimbo wako kwa kutofautiana kabla haujaendeshwa. Tovuti ya TypeScript inaieleza kama "JavaScript yenye sintaksia ya aina"; aina zinaondolewa msimbo unapogeuzwa kuwa JavaScript ya kawaida, ambayo kisha inaendeshwa popote JavaScript inapoendeshwa.

Kwa nini ni muhimu unapojenga kwa AI

Modeli za AI zinaandika msimbo haraka, na msimbo wa haraka una makosa: sehemu iitwayo customerName kwenye faili moja na customer_name kwenye faili jingine, bei iliyopitishwa kama maandishi badala ya namba, au kazi iliyoitwa bila thamani iliyokosekana. Kwenye JavaScript ya kawaida, makosa mengi yanaonekana tu mtu anapobonyeza kitufe kisichofaa.

TypeScript inakamata mengi yao mapema, msimbo unapoandikwa:

• AI inapata maoni ya papo hapo. Makosa ya aina yanaelekeza mstari sahihi ulio na kosa, ili agent aweze kurekebisha kabla hujaona.
• Mabadiliko ni salama zaidi. Ukibadilisha jina la sehemu, TypeScript inaweka alama kila mahali bado linatumia jina la zamani.
• Msimbo unajielezea. Aina zinaandika kile kazi inachotarajia na kurudisha, jambo linalowasaidia wewe, AI na mtu yeyote wa baadaye atakayefanya kazi nao.
• Vihariri vinakuwa nadhifu. Kukamilisha maneno kiotomatiki na "nenda kwenye ufafanuzi" vinafanya kazi vizuri zaidi kwa sababu kihariri kinajua kila thamani ni nini.

Hii ni sababu kubwa ya zana nyingi za kujenga programu za AI kuchagua TypeScript kama chaguo-msingi.

Mfano wa kila siku

Fikiria ghala la usafirishaji lenye sehemu zilizowekwa lebo. Kila sehemu ina bango: "Pallet pekee", "Yenye baridi", "Upeo kilo 500". Mzigo unapofika, mkaguzi mlangoni analinganisha bidhaa na bango. Samaki waliogandishwa wanaoelekea sehemu ya bidhaa kavu wanasimamishwa mlangoni, si kugunduliwa wiki moja baadaye wakinuka.

TypeScript ndiyo mkaguzi mlangoni. Aina ndizo mabango. Ukaguzi unafanyika kabla bidhaa — msimbo wako — haijaanza kutumika. Na mara kila kitu kikiwa mahali pake, mabango yanaondolewa: JavaScript inayoendeshwa haina aina zozote ndani yake.

TypeScript inavyofanya kazi

1. Wewe (au AI) unaandika faili za .ts au .tsx — TypeScript yenye lebo za aina.
2. Kikagua aina kinasoma msimbo na kuripoti kutofautiana kama makosa kwenye kihariri au kwenye build.
3. Hatua ya build inaondoa aina, ikizalisha JavaScript ya kawaida.
4. JavaScript inaendeshwa kwenye kivinjari au kwenye seva (Node.js, Deno, Bun).

Matokeo muhimu: TypeScript inakagua msimbo ulioandika, si data inayofika programu inapofanya kazi. Ikiwa API ya nje itarudisha kitu kisichotarajiwa, TypeScript haiwezi kuiona isipokuwa ukiongeza uthibitisho wa wakati wa kuendesha.

Mfano wa kazi: fomu ya kuhifadhi nafasi

Sema unajenga programu ya kuhifadhi nafasi kwa saluni ya nywele. Hapa kuna aina inayoeleza nafasi moja:

type Booking = {
  id: number;
  customerEmail: string;
  service: "haircut" | "colour" | "blow-dry";
  startsAt: Date;
  price: number;
  notes?: string; // ? inamaanisha si lazima
};

Na kazi inayohesabu amana:

function depositFor(booking: Booking): number {
  return booking.price * 0.2;
}

Sasa tazama TypeScript inachokamata.

Sehemu iliyoandikwa vibaya.

depositFor({ id: 1, customerEmail: "lena@example.com", service: "haircut",
  startsAt: new Date(), prise: 40 });

TypeScript inaripoti kwamba prise si sifa inayojulikana na price inakosekana. Kwenye JavaScript ya kawaida, hili lingehesabu kimya kimya amana ya NaN (si namba).

Aina mbaya ya thamani.

const booking: Booking = { ...otherFields, price: "40" };

TypeScript inaripoti kwamba maandishi hayawezi kutumika mahali panapotarajiwa namba. Bila hiyo, "40" * 0.2 inafanya kazi kwa bahati, lakini "40" + 5 inatoa "405" — aina ya hitilafu inayoonekana kwenye ankara.

Huduma isiyokuwepo.

const booking: Booking = { ...otherFields, service: "perm" };

TypeScript inaripoti kwamba "perm" si mojawapo ya huduma zinazoruhusiwa. Saluni ikiongeza perms baadaye, unaiongeza kwenye aina, na TypeScript inaonyesha kila mahali panapohitaji kusasishwa — orodha ya bei, fomu, rangi za kalenda.

Isichoweza kukamata. Ikiwa fomu ya kuhifadhi inatuma price: "40" kutoka kivinjari kwenda seva, TypeScript ya seva haiioni wakati wa kuendesha. Ndiyo sababu programu zilizojengwa vizuri pia zinathibitisha data inayoingia, mara nyingi kwa maktaba ya uthibitisho inayokagua umbo na kuigeuza kuwa Booking halisi.

TypeScript dhidi ya JavaScript

Maneno ya kawaida yaliyofafanuliwa

Makosa ya kawaida na dhana potofu

• "TypeScript inafanya msimbo usiwe na hitilafu." Inakamata kutofautiana kwa umbo la data, si mantiki mbaya. Riba ya 2% badala ya 20% itapita ukaguzi wa aina bila tatizo.
• "Aina zinanilinda dhidi ya data mbaya." Aina zinatoweka wakati wa kuendesha. Thibitisha data kutoka kwa watumiaji, fomu na API.
• any kila mahali. AI inapokwama, inaweza kufikia any au // @ts-ignore ili kunyamazisha makosa. Hilo linaficha matatizo badala ya kuyarekebisha.
• Kupuuza makosa ya aina kwa sababu preview inafanya kazi. Baadhi ya zana bado zinaendesha msimbo wenye makosa ya aina. Makosa hayo bado ni hitilafu zinazosubiri kutokea.
• "TypeScript ni polepole." Aina zinaondolewa kabla ya kuendesha; JavaScript inayoendeshwa ni karibu sawa.
• "Ni kwa timu kubwa tu." Wajenzi peke yao pia wananufaika, hasa AI inapofanya marekebisho mengi.

Cha kumwomba zana yako ya kujenga ya AI

• "Tumia TypeScript na hali ya strict imewashwa."
• "Fafanua aina zinazoshirikiwa kwa rekodi zetu kuu — Customer, Booking, Invoice — na uzitumie kwenye sehemu ya mbele na ya nyuma."
• "Usitumie any wala @ts-ignore kupita makosa; rekebisha tatizo la msingi na uniambie lilikuwa nini."
• "Thibitisha data yote inayoingia kwenye seva, si kwa aina pekee."
• "Endesha kikagua aina na urekebishe makosa yote kabla hujaniambia kazi imekamilika."
• "Unapobadilisha jina la sehemu, sasisha kila mahali ambapo TypeScript inaweka alama."
• "Eleza hitilafu hii ya aina kwa Kiingereza cha kawaida."

Kwa zaidi kuhusu kukagua kile AI ilichozalisha, tazama jinsi ya kukagua msimbo ulioandikwa na AI na jinsi ya kurekebisha programu iliyojengwa na AI.

TypeScript kwenye Mythex

Usipoomba chochote mahususi, Mythex huanzisha miradi mipya kwenye Vite + React + TypeScript + Tailwind. Mhariri wa msimbo unajumuisha akili ya lugha — kukamilisha maneno, uchunguzi na kwenda kwenye ufafanuzi kwa TypeScript na JavaScript, miongoni mwa lugha nyingine — kwa hiyo makosa ya aina yanaonekana kwenye msimbo, si kwenye preview tu. Mhariri ni wa kusoma tu kwenye Free na unaweza kuhaririwa kikamilifu kwenye Pro. Bado unaweza kuomba usanidi tofauti kwenye prompt yako ya kwanza; ukurasa wa nyaraka kuhusu jinsi teknolojia inavyochaguliwa unaeleza jinsi, na nyaraka za mhariri wa msimbo zinaeleza kile mhariri unachoonyesha.

Maswali