Why Literal types and value narrowing in Typescript? - Purpose & Use Cases

The Big Idea

What if your program could instantly know exactly what value it's dealing with, avoiding hidden bugs?

The Scenario

Imagine you have a program that accepts user commands like 'start', 'stop', or 'pause'. Without special checks, you might accidentally allow typos or unexpected values, causing bugs or crashes.

The Problem

Manually checking every possible string or value is slow and error-prone. You might forget a case or mistype a check, leading to unexpected behavior that's hard to find and fix.

The Solution

Literal types let you specify exact allowed values, and value narrowing helps the program understand which exact value it's working with. This prevents mistakes and makes your code safer and clearer.

Before vs After

✗ Before

function handleCommand(cmd: string) {
  if (cmd === 'start' || cmd === 'stop' || cmd === 'pause') {
    // do something
  }
}

✓ After

type Command = 'start' | 'stop' | 'pause';
function handleCommand(cmd: Command) {
  if (cmd === 'start') {
    // do start
  } else if (cmd === 'stop') {
    // do stop
  } else if (cmd === 'pause') {
    // do pause
  }
}

What It Enables

You can write code that knows exactly what values are allowed and safely handle each case without guesswork or errors.

Real Life Example

Think of a traffic light system where the light can only be 'red', 'yellow', or 'green'. Literal types ensure you never accidentally use an invalid color, keeping the system reliable.

Key Takeaways

Literal types specify exact allowed values.

Value narrowing helps the program understand which value it has.

This combination makes code safer and easier to maintain.

Practice

1. What does a literal type in TypeScript allow you to do?

easy

A. Specify exact allowed values for a variable

B. Create a new class

C. Define a function return type as any

D. Ignore type checking

Solution

1. Step 1: Understand the purpose of literal types

   Literal types let you restrict a variable to exact values like 'yes' or 10 instead of general types like string or number.

2. Step 2: Compare options with the definition

   Only Specify exact allowed values for a variable correctly describes this feature; others describe unrelated concepts.

3. Final Answer:

   Specify exact allowed values for a variable -> Option A

4. Quick Check:

   Literal types = exact allowed values [OK]

Hint: Literal types fix variable values exactly [OK]

Common Mistakes:

• Confusing literal types with classes
• Thinking literal types disable type checking
• Assuming literal types allow any value

2. Which of the following is the correct way to declare a variable with a literal type of the string 'open' in TypeScript?

easy

A. let status = 'open';

B. let status: string = 'open';

C. let status: 'open' = 'open';

D. let status: 'open'; status = 'closed';

Solution

1. Step 1: Check the syntax for literal type declaration

   To declare a variable with a literal type, you specify the exact value in quotes as the type, like 'open'.

2. Step 2: Evaluate each option

   let status: 'open' = 'open'; correctly declares status with type 'open' and assigns 'open'. let status: string = 'open'; uses string type, not literal. let status = 'open'; infers string type but not literal. let status: 'open'; status = 'closed'; declares type 'open' but assigns 'closed', which is invalid.

3. Final Answer:

   let status: 'open' = 'open'; -> Option C

4. Quick Check:

   Literal type syntax uses exact value in quotes [OK]

Hint: Use quotes around value to declare literal type [OK]

Common Mistakes:

• Assigning a different value than the literal type
• Using general types instead of literal types
• Omitting the type and expecting literal type

3. What will be the output of the following TypeScript code?

type Direction = 'left' | 'right';
function move(dir: Direction) {
  if (dir === 'left') {
    return 'Moving left';
  } else {
    return 'Moving right';
  }
}
console.log(move('right'));

medium

A. Moving right

B. Type error at compile time

C. Moving left

D. Undefined

Solution

1. Step 1: Understand the function behavior with literal type

   The function move accepts only 'left' or 'right'. It returns 'Moving left' if input is 'left', else 'Moving right'.

2. Step 2: Trace the function call with 'right'

   Calling move('right') triggers the else branch, returning 'Moving right'.

3. Final Answer:

   Moving right -> Option A

4. Quick Check:

   Input 'right' returns 'Moving right' [OK]

Hint: Check input matches condition for output [OK]

Common Mistakes:

• Confusing which branch runs for 'right'
• Expecting compile error for valid literal
• Ignoring else branch

4. Identify the error in this TypeScript code using literal types and value narrowing:

type Status = 'success' | 'error';
function handle(status: Status) {
  if (status === 'success') {
    console.log('Success!');
  } else if (status === 'fail') {
    console.log('Failed!');
  }
}

medium

A. Missing return type in function

B. No error, code is correct

C. Variable status is not declared

D. The else if condition checks an invalid literal 'fail'

Solution

1. Step 1: Check the allowed literal types for Status

   Status can only be 'success' or 'error'.

2. Step 2: Analyze the else if condition

   The code checks if status === 'fail', which is not part of Status type, causing a type error.

3. Final Answer:

   The else if condition checks an invalid literal 'fail' -> Option D

4. Quick Check:

   Check conditions must match literal types [OK]

Hint: Check all compared literals are in the type union [OK]

Common Mistakes:

• Using literals not declared in the union type
• Ignoring TypeScript errors on invalid comparisons
• Assuming missing return type causes error here

5. Given the following TypeScript code, what is the type of variable result after the if statement?

type Mode = 'auto' | 'manual';
function setMode(mode: Mode) {
  let result: string | undefined;
  if (mode === 'auto') {
    result = 'Automatic mode set';
  } else {
    result = undefined;
  }
  return result;
}

hard

A. string

B. string | undefined

C. undefined

D. Mode

Solution

1. Step 1: Analyze variable declaration and assignments

   Variable result is declared as string | undefined. Inside if, assigned string; else assigned undefined.

2. Step 2: Determine narrowed type after if

   Since result can be either string or undefined depending on mode, its type remains string | undefined.

3. Final Answer:

   string | undefined -> Option B

4. Quick Check:

   Variable type includes all assigned values [OK]

Hint: Variable type covers all assigned values after narrowing [OK]

Common Mistakes:

• Assuming type narrows to string only
• Ignoring undefined assignment
• Confusing Mode type with result type