ConstructorParameters type in Typescript

Introduction

The ConstructorParameters type helps you get the list of input types a class constructor needs. It makes working with classes easier and safer.

When you want to create a new instance of a class but only know the class type, not the constructor details.

When you want to write a function that accepts constructor arguments of any class.

When you want to copy or forward constructor arguments from one class to another.

When you want to extract constructor argument types for documentation or validation.

Syntax

Typescript

ConstructorParameters<Type>

Type must be a class constructor type.

The result is a tuple type representing the constructor's parameter types.

Examples

This example extracts the constructor parameters of Person as a tuple type.

Typescript

class Person {
  constructor(name: string, age: number) {}
}
type PersonParams = ConstructorParameters<typeof Person>;
// PersonParams is [string, number]

Optional parameters in the constructor are reflected in the tuple type.

Typescript

class Car {
  constructor(make: string, year?: number) {}
}
type CarParams = ConstructorParameters<typeof Car>;
// CarParams is [string, (number | undefined)?]

You can use ConstructorParameters with any constructor type, not just classes.

Typescript

type Params = ConstructorParameters<new (x: boolean) => any>;
// Params is [boolean]

Sample Program

This program uses ConstructorParameters to get the constructor argument types of Book. Then it creates a new Book instance safely with those arguments.

Typescript

class Book {
  constructor(title: string, pages: number) {
    this.title = title;
    this.pages = pages;
  }
  title: string;
  pages: number;
}

function createInstance<T extends new (...args: any) => any>(ctor: T, args: ConstructorParameters<T>) {
  return new ctor(...args);
}

const bookArgs: ConstructorParameters<typeof Book> = ["Learn TypeScript", 250];
const myBook = createInstance(Book, bookArgs);
console.log(myBook.title);
console.log(myBook.pages);

Important Notes

If the constructor has no parameters, ConstructorParameters returns an empty tuple [].

This type only works with class constructors or constructor signatures, not regular functions.

Summary

ConstructorParameters extracts the types of a class constructor's parameters as a tuple.

It helps write safer and more flexible code when working with class instances.

Use it when you want to forward or reuse constructor argument types.

Practice

1.

What does the ConstructorParameters type utility do in TypeScript?

easy

A. Extracts the types of a class constructor's parameters as a tuple

B. Creates a new class with the same constructor parameters

C. Returns the return type of a class constructor

D. Converts constructor parameters into a union type

Solution

1. Step 1: Understand the purpose of ConstructorParameters

   The ConstructorParameters utility extracts the types of the parameters used in a class constructor and returns them as a tuple type.

2. Step 2: Compare with other options

   Options B, C, and D describe different behaviors that ConstructorParameters does not perform.

3. Final Answer:

   Extracts the types of a class constructor's parameters as a tuple -> Option A

4. Quick Check:

   ConstructorParameters = tuple of constructor args [OK]

Hint: Remember: ConstructorParameters gives constructor args as a tuple [OK]

Common Mistakes:

• Confusing ConstructorParameters with ReturnType
• Thinking it creates a new class
• Assuming it returns a union type

2.

Which of the following is the correct syntax to get the constructor parameter types of a class MyClass using ConstructorParameters?

class MyClass { constructor(name: string, age: number) {} }

easy

A. type Params = ConstructorParameters<MyClass>;

B. type Params = ConstructorParameters;

C. type Params = ConstructorParameters;

D. type Params = ConstructorParameters;

Solution

1. Step 1: Identify the correct type argument for ConstructorParameters

   The argument must be a constructor function type, which is typeof MyClass (the class constructor type), not the instance type.

2. Step 2: Check each option

   type Params = ConstructorParameters<MyClass>; uses the instance type, which is incorrect. type Params = ConstructorParameters; uses a non-existent property. type Params = ConstructorParameters; uses invalid syntax. Only type Params = ConstructorParameters; correctly uses typeof MyClass.

3. Final Answer:

   type Params = ConstructorParameters<typeof MyClass>; -> Option B

4. Quick Check:

   Use typeof ClassName with ConstructorParameters [OK]

Hint: Use typeof ClassName to get constructor type [OK]

Common Mistakes:

• Passing instance type instead of constructor type
• Using invalid syntax like new expressions
• Trying to access constructor property

3.

What is the output type of the following code?

class Person {
  constructor(public name: string, public age: number) {}
}

type Params = ConstructorParameters<typeof Person>;

medium

A. [string, string]

B. [name: string, age: number]

C. [string, number]

D. Error: ConstructorParameters cannot be applied

Solution

1. Step 1: Analyze the constructor parameters

   The constructor takes two parameters: name of type string and age of type number.

2. Step 2: Understand ConstructorParameters output

   ConstructorParameters<typeof Person> returns a tuple of the parameter types: [string, number].

3. Final Answer:

   [string, number] -> Option C

4. Quick Check:

   ConstructorParameters returns tuple of constructor arg types [OK]

Hint: ConstructorParameters returns tuple of constructor argument types [OK]

Common Mistakes:

• Expecting parameter names in the tuple
• Confusing parameter types with instance properties
• Thinking it returns an error

4.

Identify the error in this code snippet:

class Car {
  constructor(make: string, year: number) {}
}

type Params = ConstructorParameters<Car>;

medium

A. Car is an instance type, should use typeof Car

B. ConstructorParameters cannot be used with classes

C. Constructor parameters must be public or private

D. Missing parentheses after Car in ConstructorParameters

Solution

1. Step 1: Check the argument passed to ConstructorParameters

   The argument must be the constructor function type, which is typeof Car, not the instance type Car.

2. Step 2: Identify the error

   Using Car directly causes a type error because it is the instance type, not the constructor type.

3. Final Answer:

   Car is an instance type, should use typeof Car -> Option A

4. Quick Check:

   Use typeof ClassName with ConstructorParameters [OK]

Hint: Always use typeof ClassName with ConstructorParameters [OK]

Common Mistakes:

• Passing instance type instead of constructor type
• Assuming ConstructorParameters works on instances
• Adding parentheses after class name

5.

Given the following classes, how can you create a type alias EmployeeParams that matches the constructor parameters of Employee by reusing the constructor parameters of Person?

class Person {
  constructor(public name: string, public age: number) {}
}

class Employee extends Person {
  constructor(name: string, age: number, public salary: number) {
    super(name, age);
  }
}

hard

A. type EmployeeParams = ConstructorParameters<typeof Employee>;

B. type EmployeeParams = [string, number, number];

C. type EmployeeParams = ConstructorParameters<Person> & number;

D. type EmployeeParams = [...ConstructorParameters<typeof Person>, number];

Solution

1. Step 1: Understand the constructor parameters

   Person constructor takes name and age. Employee adds salary as a third parameter.

2. Step 2: Reuse Person's constructor parameters and add salary

   Using ConstructorParameters<typeof Person> gives [string, number]. Adding number for salary creates [string, number, number].

3. Step 3: Check options

   type EmployeeParams = [...ConstructorParameters<typeof Person>, number]; correctly uses tuple spread to combine parameters. type EmployeeParams = ConstructorParameters<typeof Employee>; gets all parameters but does not reuse Person's. type EmployeeParams = ConstructorParameters<Person> & number; is invalid syntax. type EmployeeParams = [string, number, number]; hardcodes types without reuse.

4. Final Answer:

   type EmployeeParams = [...ConstructorParameters<typeof Person>, number]; -> Option D

5. Quick Check:

   Reuse constructor params with tuple spread [OK]

Hint: Use tuple spread to extend ConstructorParameters [OK]

Common Mistakes:

• Not using typeof with class name
• Hardcoding parameter types instead of reusing
• Using invalid intersection (&) instead of tuple spread