Course contentsShow
← TypeScript
Lesson 1192 of 1,79628. tsconfig in DepthFree lesson

Non-Null Assertions with strictNullChecks

When and how to use ! to assert a value is not null or undefined despite strict checking.

Non-Null Assertions with strictNullChecks

What you'll learn: How to override TypeScript's strict null safety by asserting a value is definitely not null or undefined.

The Scenario: You Know More Than TypeScript

With strictNullChecks enabled, TypeScript treats null and undefined as separate types that must be explicitly handled. But sometimes you know a value isn't null even when TypeScript's analysis can't prove it. This is where the non-null assertion operator comes in.

The ! Operator

The non-null assertion operator (!) tells TypeScript: "Trust me, this value is definitely not null or undefined."

function processName(name: string | null) {
  // TypeScript error without !:
  // const upper = name.toUpperCase();

  // With ! assertion:
  const upper = name!.toUpperCase();
  return upper;
}

Think of ! as saying "I'm absolutely certain this won't be null at runtime" — it removes null and undefined from the type.

When to Use It

Legitimate scenarios:

  • After runtime checks TypeScript can't analyze
  • DOM queries you know will succeed
  • Framework guarantees (React refs after mount, etc.)
const button = document.getElementById('submit-btn')!;
button.addEventListener('click', handleClick);
// You know the button exists in your HTML

The Danger Zone

Non-null assertions disable type safety. They're a compiler-only operation — no runtime checking happens. If you're wrong, you'll get a runtime error:

let userName: string | null = null;
console.log(userName!.length); // Runtime crash! 💥

This is essentially a type assertion that strips away nullability. Use it sparingly and only when you have external guarantees.

Better Alternatives

Before reaching for !, consider:

  • Type guards (if (value), if (value !== null))
  • Optional chaining (value?.property)
  • Nullish coalescing (value ?? defaultValue)

Key Takeaway: The ! operator suppresses strictNullChecks for a single value, asserting it's non-null. Use it only when you have guarantees TypeScript can't see — it's a last resort that trades safety for convenience.