{"canonical_url":"https://engineer.company/nb/glossary/typescript/","content_markdown":"# TypeScript\n\n## Hva det er\n\nTypeScript, ofte forkortet TS, er JavaScript med typeannotasjoner, laget av Microsoft og levert\nsammen med en kompilator, `tsc`, som sjekker dem. Filene heter `.ts`, eller `.tsx` når de inneholder\nJSX-markup. All gyldig JavaScript-syntaks er også gyldig TypeScript, og derfor kalles språket et\nsupersett av JavaScript. Kompilatoren er åpen kildekode under Apache License 2.0.\n\nTypene lever bare så lenge sjekken varer. Vanlige typeannotasjoner viskes ut\nnår TypeScript genererer JavaScript; de validerer ikke data under kjøring og\nkrever ikke noe bibliotek for typekontroll under kjøring. Typeannotasjoner\nendrer ikke hvordan JavaScript-koden oppfører seg når den kjører. Det ene\nfaktumet forklarer både nytten og grensene: sjekkeren resonnerer om typene som\ner beskrevet i kildekoden; den validerer ikke data som kommer inn mens\nprogrammet går.\n\nTypesystemet er strukturelt. To typer er kompatible når formene deres stemmer, uansett hva de heter,\nog det passer vanen i JavaScript med å sende vanlige objekter rundt. C# og Java sammenligner i\nstedet de deklarerte navnene. Mye av typingen utledes av kompilatoren, så annotasjonene står mest på\nfunksjonssignaturer og eksporterte verdier. Noen steder er systemet med vilje ikke vanntett, det\nengelske fagordet er _unsound_: `any` slår av sjekken for en verdi, og en typepåstand skrevet med\n`as` ber kompilatoren ta programmererens ord for typen. Begge forsvinner fra resultatet sammen med\nalt det andre.\n\nTre måter å kjøre det på er vanlige. `tsc` sjekker et prosjekt og skriver ut JavaScript. Buntere som\nesbuild fjerner typene uten å sjekke dem og overlater sjekken til en egen kjøring av `tsc --noEmit`.\nNode.js kjører siden v23.6.0 og v22.18.0 `.ts`-filer direkte ved å erstatte typesyntaksen med\nmellomrom, igjen uten typesjekk, og godtar bare syntaks som kan fjernes på den måten. TypeScript\n7.0, kunngjort i juli 2026, er kompilatoren portet til Go, og teamet oppgir at fulle bygg typisk går\n8–12 ganger raskere.\n\n## Hvorfor det er viktig\n\nEt team som vurderer TypeScript, avgjør egentlig om et byggetrinn og en sjekker betaler for seg ved\nå fange feil før koden kjører. I en kodebase som flere personer endrer hver uke, gjør de som regel\ndet. Gi et felt nytt navn, og hvert sted som brukte det, dukker opp. Editoren fullfører og forklarer\nkode ut fra typene, og signaturen til en modul blir en kontrakt som kallerne ikke kan bryte i det\nstille. Prisen er en sjekk i hver byggepipeline, en konfigurasjon med svært mange valg og\ntypedefinisjoner som må holde tritt med bibliotekene de beskriver.\n\nStrengheten er innstillingen som betyr mest. Flagget `strict` slår på en hel familie sjekker, bl.a.\n`strictNullChecks` og `noImplicitAny`, og håndboken beskriver resultatet som en dreieknapp heller\nenn en av/på-bryter. Siden TypeScript 6.0 er flagget på som standard, så et nytt prosjekt starter\nstrengt. Et eldre prosjekt kan fortsatt sette det til false, og å slå det på senere betyr å arbeide\nseg gjennom hver fil det berører. To nyttige sjekker står utenfor familien og må slås på hver for\nseg: `noUncheckedIndexedAccess` og `exactOptionalPropertyTypes`.\n\nUtviskingen setter grensen. Et program som leser JSON fra en nettverksforespørsel, en fil, en kø\neller et webskjema, har bare programmererens ord for hvordan de dataene ser ut, fordi typene er\nborte når dataene kommer. Grensene trenger derfor validering under kjøring, helst generert fra det\nsamme skjemaet som typene, slik at sjekken og typen ikke kan være uenige. TypeScript gjør innsiden\nav et program konsistent og overlater kantene til koden.\n\nSjekkeren mater også andre verktøy. En linter som typescript-eslint kan be kompilatoren om\ntypeinformasjon, slik at en regel kan flagge et promise som ingen venter på med `await`, eller en\nverdi av typen `any` som sprer seg gjennom en modul. På den måten gjør et team sine egne\nkonvensjoner om til feil i bygget i stedet for kommentarer i kodegjennomgangen.\n\n## Slik ser det ut i praksis\n\nI prosjektene på dette nettstedet holdes TypeScript ærlig av generert kode og av verktøy, ikke av\ngode forsetter. Tre sider viser hvordan.\n\nPå én plattform skrives TypeScript-klienten til frontenden aldri for hånd.\n[Den genereres fra API-ets egen beskrivelse](/nb/portfolio/generated-the-api-contract-from-the-database-out/),\nsom Huma lager ut fra Go-typene, som igjen følger databaseskjemaet og funksjonene i det. På det dokumenterte implementeringsstadiet var klienten\npå 44 076 linjer, og 61 mock-handlere som ble generert ved siden av, lot frontendens egne tester kjøre\nmot den virkelige kontrakten og ikke mot håndskrevne testdata. Hvert ledd har sin egen vakt. En\nkontraktskontroll i CI sammenligner det frontenden sender, med det API-et forventer, og får bygget\ntil å feile ved avvik, med en skjemaprobe under som undersøker de faktiske formene. Den dekker\nvalgfrie felt i forespørselskroppen, der «mangler» og «null» lett blandes sammen, og enumer i\nspørringsparametere. Et felt som endres på den ene siden, får nå et bygg til å feile minutter etter\nendringen, i stedet for å dukke opp som en 422 i nettleseren etter at avviket allerede er levert.\nTil gjengjeld når en endring i kontrakten bare frem til klientens typer ved\nat hele kjeden kjøres på nytt, og regenerering krever ekstraarbeid.\n\nEn annen side setter én standard for seks språk, TypeScript blant dem.\n[Hver diagnostikk ESLint melder, er en feil](/nb/portfolio/set-a-zero-warnings-bar-across-six-languages/),\ndet finnes ikke noe «warn»-nivå å gjemme seg i, og inline-undertrykkelser er forbudt, så et funn må\nrettes og ikke bare dempes. Pre-commit- og pre-push-hooks kjører linterne og testene, og\nlengdegrenser for funksjoner og filer holder modulene lesbare.\n\nLinterne som følger med et språk, stopper før prosjektets egne regler, og derfor holdt\n[femten egne ESLint-regler](/nb/portfolio/built-a-268-check-guard-engine-for-the-repo/)\nrepoets egne kodemønstre på plass i TypeScript på det dokumenterte\nimplementeringsstadiet. Reglene for TypeScript var bare én del av en\nkontrollmotor der 268 av de 274 kontrollskriptene var registrert i commit-hookene,\nog kontrollene hadde 146 egne tester, fordi en ødelagt kontroll slipper alt gjennom uten at noen merker det. Én regel\nhandler om tester og ikke om typer: en commit med prefikset `fix:` må ha med en test som feiler uten\nrettelsen. Gjennomgangstiden flyttet seg fra mekanikk til design, og til gjengjeld ble det\ntregt å committe.\n\n## Hvor det går galt\n\nDe fleste feil med TypeScript kommer av å stole på typene lenger enn kompilatoren kan se.\n\n**Et felt typet som streng viser seg å være undefined under kjøring.** Dataene kom utenfra og fikk\nen type i stedet for en sjekk. DOM-biblioteket typer `res.json()` som et promise av `any`, så\nkompilatoren godtar hva enn koden gjør med resultatet, og en typepåstand gjør tilliten eksplisitt\nuten å gjøre den trygg:\n\n```ts\nconst res = await fetch(\"/api/user\");\nconst user = (await res.json()) as User; // stolt på, aldri sjekket\nuser.email.toLowerCase(); // TypeError hvis email mangler\n```\n\nBehandle data utenfra som `unknown`, valider dem ved grensen med et skjema som sjekkes under\nkjøring, og generer typen fra det skjemaet, så holder de to tritt. En typet lint-regel kan deretter\nflagge hver `any` som slipper forbi.\n\n**Kode med typefeil havner i produksjon likevel.** `tsc` skriver fortsatt ut JavaScript når den\nmelder feil, fordi `noEmitOnError` står på false som standard, og buntere og Node.js fjerner typene\nuten å sjekke dem i det hele tatt. Kjør `tsc --noEmit` som et obligatorisk steg i CI og i\npre-commit-hooken, og la bygget feile på avslutningskoden.\n\n**Et oppslag på indeks gir undefined der typen sa noe annet.** Å lese et array-element, eller en\nnøkkel gjennom en indekssignatur, gir en type som alltid er til stede, selv forbi slutten av\narrayen. Slå på `noUncheckedIndexedAccess`, som legger `undefined` til slike lesinger og tvinger\nkoden til å håndtere det. Kombiner det med `exactOptionalPropertyTypes`, som skiller en egenskap som\nmangler, fra en som er satt til `undefined`.\n\n**En fil som kompilerer med tsc, feiler når Node.js kjører den.** Typestripping fjerner bare syntaks\nsom er uten betydning under kjøring. Enumer og navnerom (_namespaces_) som inneholder verdier, får\nNode.js til å stoppe med `ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX`, og en type som importeres uten\nnøkkelordet `type`, behandles som en verdiimport som feiler under kjøring. Slå på\n`erasableSyntaxOnly` og `verbatimModuleSyntax`, så melder kompilatoren begge deler før Node.js gjør\ndet. Skriv `import type` for typer, og erstatt enumer med objektliteraler merket `as const`.\n\n## Les mer\n\n- [TypeScript Documentation](https://www.typescriptlang.org/docs/) — håndboken, referansesidene og\n  versjonsnotatene, vedlikeholdt av TypeScript-teamet.\n- [The Basics](https://www.typescriptlang.org/docs/handbook/2/basic-types.html) — kapitlet i\n  håndboken om statisk sjekking, utskrift tross feil, utviskede typer og strenghet.\n- [TSConfig Reference: strict](https://www.typescriptlang.org/tsconfig/#strict) — hvert\n  kompilatorvalg med standardverdien, også sjekkene som `strict` slår på.\n- [Type Compatibility](https://www.typescriptlang.org/docs/handbook/type-compatibility.html) —\n  strukturell subtyping og stedene der typesystemet med vilje har hull.\n- [Node.js: Modules: TypeScript](https://nodejs.org/api/typescript.html) — typestripping, syntaksen\n  den avviser, og kompilatorinnstillingene Node.js anbefaler.\n- [Linting with Type Information](https://typescript-eslint.io/getting-started/typed-linting/) —\n  hvordan typescript-eslint gir lint-reglene tilgang til typesjekkeren.\n\n\u003chttps://engineer.company/nb/glossary/typescript/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"For team som vurderer TypeScript: hva kompilatoren fanger, hvorfor typene er borte når koden kjører, og hvilke innstillinger som faktisk betyr noe.","formats":{"gemtext":"https://engineer.company/nb/glossary/typescript/index.gmi","gopher":"https://engineer.company/nb/glossary/typescript/gophermap","html":"https://engineer.company/nb/glossary/typescript/","json":"https://engineer.company/nb/glossary/typescript/index.json","markdown":"https://engineer.company/nb/glossary/typescript/index.md","pdf":"https://engineer.company/nb/glossary/typescript/index.pdf"},"kind":"page","language":"nb","title":"Hva er TypeScript?","url":"https://engineer.company/nb/glossary/typescript/","version":1}