Covariance and contravariance in Typescript - Mini Project: Build & Apply

Understanding Covariance and Contravariance in TypeScript

📖 Scenario: Imagine you are building a simple system to manage different types of animals and their sounds. You want to understand how TypeScript handles assigning functions and objects with related types, focusing on covariance and contravariance.

🎯 Goal: Learn how covariance and contravariance work in TypeScript by creating interfaces and functions that demonstrate these concepts clearly.

📋 What You'll Learn

Create interfaces for animals with specific properties

Create functions that accept and return these interfaces

Use TypeScript's type system to explore covariance and contravariance

Print results to observe type assignments

💡 Why This Matters

🌍 Real World

Understanding covariance and contravariance helps when working with complex type hierarchies in real-world TypeScript applications, such as UI components or data processing pipelines.

💼 Career

Many software engineering roles require strong knowledge of TypeScript's type system to write safe and maintainable code, especially when working with libraries or frameworks that use advanced typing.

1

Create animal interfaces

Create two interfaces called Animal and Dog. Animal should have a property name of type string. Dog should extend Animal and add a property breed of type string.

Typescript

# Create interfaces Animal and Dog as described
// Your code here

Hint

Use interface keyword and extends to create Dog from Animal.

2

Create functions with animal types

Create a function called getAnimalName that takes a parameter animal of type Animal and returns a string with the animal's name. Also create a function called getDogBreed that takes a parameter dog of type Dog and returns a string with the dog's breed.

Typescript

interface Animal {
    name: string;
}

interface Dog extends Animal {
    breed: string;
}

// Create functions getAnimalName and getDogBreed as described
// Your code here

Hint

Define functions with correct parameter types and return the requested property.

3

Assign functions to demonstrate covariance and contravariance

Create a variable animalNameFunc of type (animal: Animal) => string and assign it the function getDogBreed. Then create a variable dogBreedFunc of type (dog: Dog) => string and assign it the function getAnimalName. This will show how TypeScript handles covariance and contravariance in function assignments.

Typescript

interface Animal {
    name: string;
}

interface Dog extends Animal {
    breed: string;
}

function getAnimalName(animal: Animal): string {
    return animal.name;
}

function getDogBreed(dog: Dog): string {
    return dog.breed;
}

// Assign functions to variables animalNameFunc and dogBreedFunc as described
// Your code here

Hint

Assign functions to variables with specified function types to see TypeScript's type compatibility.

4

Test the function assignments and print results

Create a variable myDog of type Dog with name set to "Buddy" and breed set to "Golden Retriever". Then call animalNameFunc with myDog and print the result. Also call dogBreedFunc with myDog and print the result.

Typescript

interface Animal {
    name: string;
}

interface Dog extends Animal {
    breed: string;
}

function getAnimalName(animal: Animal): string {
    return animal.name;
}

function getDogBreed(dog: Dog): string {
    return dog.breed;
}

let animalNameFunc: (animal: Animal) => string = getDogBreed;
let dogBreedFunc: (dog: Dog) => string = getAnimalName;

// Create myDog and print results of calling animalNameFunc and dogBreedFunc
// Your code here

Hint

Define myDog with correct properties and use console.log to print results.

Practice

1. Which statement best describes covariance in TypeScript?

easy

A. It allows replacing a type with a more specific type safely, mainly in outputs.

B. It allows replacing a type with a more general type safely, mainly in inputs.

C. It means types cannot be replaced or changed in any way.

D. It only applies to primitive types like string and number.

Solution

1. Step 1: Understand covariance meaning

   Covariance means you can use a more specific type where a general type is expected, usually for outputs like return values.

2. Step 2: Compare with contravariance

   Contravariance is about inputs and generalizing types, so it is different from covariance.

3. Final Answer:

   It allows replacing a type with a more specific type safely, mainly in outputs. -> Option A

4. Quick Check:

   Covariance = more specific output type [OK]

Hint: Covariance = output types get more specific [OK]

Common Mistakes:

• Confusing covariance with contravariance
• Thinking covariance applies to inputs
• Believing covariance restricts type changes

2. Which of the following TypeScript function types correctly demonstrates contravariance in the parameter type?

easy

A. (input: Dog) => void

B. (input: Animal) => void

C. (input: string) => void

D. (input: number) => void

Solution

1. Step 1: Understand contravariance in parameters

   Contravariance means a function can accept a more general type as input than expected.

2. Step 2: Compare parameter types

   Given Dog extends Animal, accepting Animal (more general) instead of Dog is contravariant.

3. Final Answer:

   (input: Animal) => void -> Option B

4. Quick Check:

   Contravariance = input type generalizes [OK]

Hint: Contravariance = input types get more general [OK]

Common Mistakes:

• Choosing more specific input types for contravariance
• Mixing input and output type variance
• Ignoring inheritance relationships

3. Consider the following TypeScript code:

class Animal { name: string = 'animal'; }
class Dog extends Animal { breed: string = 'bulldog'; }

let func1: (dog: Dog) => Dog = (d) => d;
let func2: (animal: Animal) => Animal = func1;

const result = func2(new Animal());
console.log(result.name);

What will be the output when this code runs?

medium

A. animal

B. bulldog

C. undefined

D. Type error at assignment

Solution

1. Step 1: Analyze function type assignment

   func1 expects a Dog parameter and returns Dog. Assigning func1 to func2 which expects Animal parameter and returns Animal is invalid because parameter types are contravariant and return types covariant.

2. Step 2: Understand TypeScript type checking

   TypeScript disallows assigning a function expecting a more specific parameter (Dog) to one expecting a more general parameter (Animal) due to contravariance rules.

3. Final Answer:

   Type error at assignment -> Option D

4. Quick Check:

   Contravariance blocks incompatible parameter types [OK]

Hint: Check parameter types for contravariance errors [OK]

Common Mistakes:

• Assuming assignment is allowed without error
• Ignoring contravariance in function parameters
• Expecting runtime output instead of compile error

4. The following TypeScript code causes a type error. What is the main cause?

interface Producer<out T> {
  produce: () => T;
}

interface Consumer<in T> {
  consume: (item: T) => void;
}

let producer: Producer<Animal> = { produce: () => new Animal() };
let consumer: Consumer<Dog> = { consume: (d) => console.log(d.breed) };

consumer = producer; // Error here

medium

A. Dog does not extend Animal, so types are incompatible.

B. The produce method is missing a return type.

C. Assigning Producer<Animal> to Consumer<Dog> is invalid due to variance mismatch.

D. The consume method should return a value.

Solution

1. Step 1: Identify variance roles

   Producer is covariant (outputs), Consumer is contravariant (inputs). Assigning producer to consumer mixes these roles incorrectly.

2. Step 2: Understand type incompatibility

   Producer<Animal> cannot be assigned to Consumer<Dog> because their variance directions conflict, causing a type error.

3. Final Answer:

   Assigning Producer<Animal> to Consumer<Dog> is invalid due to variance mismatch. -> Option C

4. Quick Check:

   Variance mismatch causes assignment error [OK]

Hint: Match variance directions when assigning generic types [OK]

Common Mistakes:

• Ignoring variance annotations (in/out)
• Assuming unrelated interfaces can be assigned
• Confusing input and output roles

5. You want to create a TypeScript function that accepts a callback which can handle any subtype of Animal as input and returns a more specific subtype of Animal. Which function type signature correctly uses covariance and contravariance to allow this flexibility?

hard

A. function processAnimal(callback: (input: Animal) => Dog): Dog

B. function processAnimal(callback: (input: Dog) => Animal): Animal

C. function processAnimal(callback: (input: Animal) => Animal): Dog

D. function processAnimal(callback: (input: Dog) => Dog): Animal

Solution

1. Step 1: Identify input contravariance

   The callback input should be a general type (Animal) to accept any subtype safely (contravariance).

2. Step 2: Identify output covariance

   The callback returns a more specific subtype (Dog), allowing covariance in the return type.

3. Step 3: Match function signature

   function processAnimal(callback: (input: Animal) => Dog): Dog matches these rules: input is Animal (general), output is Dog (specific), and the function returns Dog.

4. Final Answer:

   function processAnimal(callback: (input: Animal) => Dog): Dog -> Option A

5. Quick Check:

   Input general, output specific = contravariant input, covariant output [OK]

Hint: Input general, output specific for flexible callbacks [OK]

Common Mistakes:

• Reversing input and output types
• Using more specific input types causing errors
• Ignoring return type covariance