Don't Panic — TypeScript Fundamentals

TypeScript is JavaScript wearing a very diligent clipboard. It reads the program before it runs, compares the values you say you expect with the operations you perform, and points at incompatible combinations. Then it removes its own notes and lets JavaScript do the actual running. The clipboard does not become a security guard merely because it was carrying a clipboard.

That explains the important surprise. A type annotation describes a value; it does not convert one. An assertion asks the checker to trust a claim; it does not inspect a network response, parsed document, or user input. Treat incoming data as unknown, which means it must be checked before application logic treats it as a known shape. Runtime validation and static types are colleagues, not substitutes who have secretly agreed to cover each other's shifts.

Most local values need less ceremony than they appear to demand. The checker can infer a type from an initial value, a call, or nearby context. Save annotations for public contracts and deliberate boundaries. For alternatives, use a union: each valid state has its own shape. A shared literal property, called a discriminant, tells the checker which state survived a runtime check. This is how a loading result avoids claiming to be ready and failed at the same time, which is a fine quality in both software and umbrellas.

Generics keep a relationship intact when the concrete type is not known yet. A function that returns the first item from a list should return a string for a string list and a number for a number list. any abandons that relationship. unknown waits for evidence. The distinction sounds fussy until an unexpected value enters a path that was certain it knew better.

Read the intro when you need the complete map of types, narrowing, assertions, and strict settings. Use the slides for the flow from source code to JavaScript runtime. Keep the cheatsheet nearby when choosing a union, guard, generic, or compiler option. Then run the practice reference and exercise: they make the boundary between a clean type check and a real runtime value impossible to miss.

Don't Panic — TypeScript Fundamentals

Relevant careers