Course contentsShow
← TypeScript
Lesson 893 of 1,79620. The any Escape HatchFree lesson

Performance and Runtime Impact

Understand that unknown has zero runtime cost—it's purely a compile-time safety feature with no performance penalty.

Performance and Runtime Impact

You'll learn: unknown is a purely compile-time safety feature with zero runtime overhead—it won't slow down your code.

The Core Truth About unknown

When you use unknown instead of any, you might wonder: "Am I paying a performance penalty for this extra safety?" The answer is a resounding no.

TypeScript types, including unknown, exist only during compilation. Once your TypeScript code compiles to JavaScript, all type annotations disappear completely. The unknown type is erased just like every other type annotation.

Compile-Time vs Runtime

Think of TypeScript types like safety rails on a construction site. During building (compilation), they prevent you from making dangerous moves. But when the building is complete (runtime), those rails are removed—they don't add weight to the final structure.

// TypeScript code
function parseData(input: unknown): string {
  if (typeof input === "string") {
    return input.toUpperCase();
  }
  return "Invalid";
}

// Compiles to JavaScript (with target: ES2015)
function parseData(input) {
  if (typeof input === "string") {
    return input.toUpperCase();
  }
  return "Invalid";
}

Notice how : unknown and : string completely vanish. The runtime JavaScript has no knowledge that unknown ever existed.

Why This Matters

Using unknown gives you:

  • Full type safety during development
  • Zero runtime cost—no performance penalty whatsoever
  • No bundle size increase—types don't ship to browsers
  • Identical runtime behavior to any

The safety checks you write (like typeof guards) would exist whether you use unknown or any. The difference is that unknown forces you to write them, preventing bugs before deployment.

Key Takeaway: unknown is free safety—you get compile-time protection without any runtime performance cost or bundle size increase.