Generic conditional constraints in Typescript

Introduction

Generic conditional constraints let you control what types a generic can accept based on conditions. This helps make your code safer and clearer.

When you want a generic type to accept only certain types based on a condition.

When you want to create flexible functions or classes that behave differently for different types.

When you want to prevent wrong types from being used with generics.

When you want to write reusable code that adapts to input types.

When you want to enforce rules on generic types without writing many overloads.

Syntax

Typescript

function example<T extends U ? X : Y>(param: T): void {
  // function body
}

The extends keyword is used to set a constraint on the generic type T.

You can use a conditional type inside the constraint to decide which type T can be.

Examples

This example limits T to be either string or number.

Typescript

function process<T extends string | number>(value: T) {
  console.log(value);
}

This uses a conditional type to decide the type of result based on T.

Typescript

type ConditionalType<T> = T extends string ? number : boolean;

function example<T>(value: T, result: ConditionalType<T>) {
  console.log(result);
}

This example shows a generic constrained to either number or string.

Typescript

function checkType<T extends number | string>(value: T) {
  // T can be number or string
  console.log(value);
}

Sample Program

This program uses a conditional type ResultType to decide the type of result based on whether input is a string or not. It prints different messages accordingly.

Typescript

type ResultType<T> = T extends string ? number : boolean;

function processValue<T>(input: T, result: ResultType<T>) {
  if (typeof input === 'string') {
    console.log(`Input is string: ${input}, result is number: ${result}`);
  } else {
    console.log(`Input is not string: ${input}, result is boolean: ${result}`);
  }
}

processValue('hello', 5);
processValue(10, true);

Important Notes

Conditional constraints help catch errors early by limiting generic types.

They make your code more flexible and reusable.

Remember that conditional types run at compile time, so they don't affect runtime performance.

Summary

Generic conditional constraints let you control generic types based on conditions.

They improve code safety and flexibility.

Use them to create smarter, reusable functions and types.

Practice

1.

What does a generic conditional constraint in TypeScript allow you to do?

For example, in function example(arg: T) {}, what is the main purpose?

easy

A. Control the generic type based on a condition to improve type safety

B. Make the function run faster by optimizing loops

C. Automatically convert types to strings

D. Disable type checking for the generic parameter

Solution

1. Step 1: Understand generic conditional constraints

   Generic conditional constraints let you choose a type based on a condition, like T extends U ? X : Y.

2. Step 2: Identify the purpose in the example

   This controls the generic type to be either X or Y depending on whether T extends U, improving type safety.

3. Final Answer:

   Control the generic type based on a condition to improve type safety -> Option A

4. Quick Check:

   Generic conditional constraints = control type conditionally [OK]

Hint: Think: conditional means choosing type based on a test [OK]

Common Mistakes:

• Confusing conditional constraints with runtime conditions
• Thinking it affects performance instead of types
• Assuming it disables type checking

2.

Which of the following is the correct syntax for a generic conditional constraint in TypeScript?

function test<T>(arg: T extends string ? number : boolean) {}

easy

A. function test<T>(arg: T extends string ? number : boolean) {}

B. function test(arg: T) {}

C. function test(arg: T) {}

D. function test<T>(arg: T) where T extends string ? number : boolean {}

Solution

1. Step 1: Identify correct generic conditional syntax

   The conditional type must be used in the argument type, not in the generic constraint part.

2. Step 2: Check each option

   function test<T>(arg: T extends string ? number : boolean) {} correctly places the conditional type in the argument type: arg: T extends string ? number : boolean.

3. Final Answer:

   function test<T>(arg: T extends string ? number : boolean) {} -> Option A

4. Quick Check:

   Conditional type goes in argument type, not generic constraint [OK]

Hint: Conditional types appear in argument or return types, not in generic constraints [OK]

Common Mistakes:

• Putting conditional directly in generic constraint
• Using invalid syntax like 'where'
• Misplacing parentheses in conditional

3.

What is the output of this TypeScript code?

type Result<T> = T extends number ? "Number" : "Other";

const a: Result<42> = "Number";
const b: Result<string> = "Other";

console.log(a, b);

medium

A. 42 string

B. Number Other

C. Number Number

D. Other Other

Solution

1. Step 1: Understand the conditional type Result<T>

   If T is a number, Result<T> is "Number", else "Other".

2. Step 2: Apply to given values

   Result<42> is "Number" because 42 is a number.
   Result<string> is "Other" because string is not a number.

3. Final Answer:

   Number Other -> Option B

4. Quick Check:

   Conditional type matches number = "Number", else "Other" [OK]

Hint: Check if type extends number to pick output string [OK]

Common Mistakes:

• Confusing value 42 with type number
• Assuming string extends number
• Mixing up output strings

4.

Identify the error in this TypeScript code using generic conditional constraints:

function checkType<T>(value: T): T extends string ? number : boolean {
  if (typeof value === "string") {
    return value.length;
  } else {
    return true;
  }
}

medium

A. Function lacks explicit return type annotation

B. The function parameter should be a union type

C. The generic constraint is missing

D. Cannot return different types conditionally without type assertion

Solution

1. Step 1: Analyze return type conditionality

   The return type depends on T, but at runtime TypeScript cannot guarantee which type is returned.

2. Step 2: Understand why error occurs

   Returning value.length (number) or true (boolean) causes a type error because TypeScript can't confirm the return matches the conditional type without assertions.

3. Final Answer:

   Cannot return different types conditionally without type assertion -> Option D

4. Quick Check:

   Conditional return types need type assertions or overloads [OK]

Hint: Conditional return types need type assertions to avoid errors [OK]

Common Mistakes:

• Assuming TypeScript infers conditional return types automatically
• Adding generic constraints unnecessarily
• Changing parameter types instead of fixing return

5.

Given this TypeScript code, what is the type of result?

type ConditionalType<T> = T extends { id: number } ? string : number;

function processItem<T>(item: T): ConditionalType<T> {
  if ("id" in item) {
    return "Has ID" as ConditionalType<T>;
  } else {
    return 0 as ConditionalType<T>;
  }
}

const result = processItem({ id: 123, name: "Test" });

hard

A. string | number

B. number

C. string

D. boolean

Solution

1. Step 1: Understand the conditional type ConditionalType<T>

   If T has an id property of type number, the type is string, else number.

2. Step 2: Apply to the argument type

   The argument { id: 123, name: "Test" } has an id property of type number, so ConditionalType<T> is string.

3. Final Answer:

   string -> Option C

4. Quick Check:

   Object with id:number means ConditionalType = string [OK]

Hint: Check if type has id:number to pick string type [OK]

Common Mistakes:

• Thinking result is number because of return 0
• Assuming union type without checking condition
• Ignoring the conditional type logic