Skip to content

any, unknown and never

This lesson covers top, bottom, and escape-hatch types. You will see how the concept fits into everyday TypeScript and why it matters for reliable applications.

any, unknown and never Overview

any, unknown and never is a core part of the TypeScript type system. Understanding it helps you model data accurately, catch mistakes early, and communicate intent to teammates through types.

We focus on practical patterns you will use in real codebases—not abstract theory. Examples mirror common frontend, backend, and library scenarios.

Topic Pattern Why it matters
Core idea top Foundation for typed code
Syntax function parse(input: unknown) Common pattern in real projects
Compiler Checked at build time Errors caught before deploy
Runtime Erased to JavaScript No type overhead in production
Tooling IDE autocomplete Faster refactors and reviews

any, unknown and never Example

let loose: any = "maybe";
function safe(v: unknown): string {
  if (typeof v === "string") return v;
  throw new Error("Expected string");
}
function fail(): never { throw new Error(); }

Prefer unknown over any; never marks unreachable code paths.

When to Use any, unknown and never

  • Modeling data that requires any, unknown and never
  • Reviewing or refactoring typed application code
  • Building reusable libraries with clear contracts
  • Onboarding developers to a TypeScript codebase
  • Preparing for interviews on TypeScript fundamentals
  • Pairing types with tests for critical business logic

Best Practices

  • Use any, unknown and never to document intent at API boundaries
  • Prefer inference for local variables when types are obvious
  • Enable strict compiler options to maximize checking
  • Name types clearly with domain language, not abbreviations
  • Combine with narrowing when working with union types
  • Review compiler errors instead of silencing with any
  • Keep examples small and composable in production code

Common Mistakes to Avoid

  • Over-annotating when inference already suffices
  • Using type assertions instead of proper narrowing
  • Applying patterns without understanding runtime behavior
  • Ignoring null and undefined in strict mode
  • Duplicating types instead of reusing aliases or interfaces
  • Expecting types to validate external JSON automatically
  • Mixing incompatible module settings with bundler output

Key Takeaways

  • any, unknown and never strengthens contracts in TypeScript code
  • Types are erased at compile time—validate external data separately
  • Combine with interfaces, unions, and generics as needed
  • Strict mode surfaces more issues during development
  • Good naming makes complex types self-documenting
  • Next: explore Type Inference to continue the course

Pro Tip

When learning any, unknown and never, recreate the example in the TypeScript Playground and break it on purpose to read compiler errors—they teach the rules quickly.