Typescript Instanceof Type Guard

instanceof is a type Guard, which checks if a value is an instance of a class or a constructor function. It also acts as a Type Guard, helping us the infer the type correctly in the scope

Using InstanceOf

We use the InstanceOf operator between the instance and the type want to test. For Example

It returns true if the objis an instance of the class, or it appears anywhere in the inheritance chain. Else it will return false.

For example

Please note that person prototypically inherits from Object, Hence it returns true

It works for most of the types including arrays, functions, RegExp etc

But it will not work on primitive types. It will result in a compile time error and run time errors.

The left-hand side of an ‘instanceof’ expression must be of type ‘any’, an object type or a type parameter.


In the above examples, we saw that person instanceof Object also returned true.  i.e because person prototypically inherits from Object

To understand let us consider the following example. We have four classes here. Person is the base class. The Employee and Customer extends from the Person class. The SalesPerson class extends the Employee class.

As you can see from the above result. the employee class return true for both Employee & Person class as it is Employee inherits from the Person class. Similarly, salesPerson class is inherited from the Employee class, which in turn inherited from the Person class.Hence it returns true for both Employee & Person.

InstanceOf As Type Guard

Consider the following classes. Customer & SalesPerson. Both extends the Person class. The both classes has the common method code().They also have additional methods buy() (Customer class) and sell() (SalesPerson class)

The following getCode retrieves the code, which is present in both the classes. We will call the getCodemethod passing the newly created Customer instance. But Since we are using the Person as the function argument, this code will result in compiler error Property 'code' does not exist on type 'Person'

The one way to solve the problem is to use the converting the obj into any as shown below. But using the any is not a ideal solution.

This is where the instanceOf is becomes useful. We can use it to check the type and also infer the type in the block where InstanceOf it is used.

Now, as you can see from the image below.

Outside the if block, the intellisense shows only one property name, which is from the Person class.

Inside the (obj instanceOf customer) block, the typescript correctly infers the type as Customer, It shows the method Buy But does not show the method Sell

While inside the (obj instanceOf SalesPerson) block it infers the type as SalesPerson. Here it shows the method Sell and does not show Buy.

TypeScript InstanceOf Type Guard
TypeScript InstanceOf Type Guard

Hence, the following BuySell method correctly call the buy & sell methods and does not throw any errors.

In the following code, we just moved sell method from the SalesPerson to Customer & vice versa. Now the compiler throws the error. For the error message you can see that outside the loop, Typescript infers the types a Person. Inside the instanceof Customer block it treats it as Customer and inside the instanceof SalesPerson it


Advances Types

Leave a Comment

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Scroll to Top