Scribd
Upload
19K views2 pages

Understanding TypeScript Union Types

This document discusses union types in TypeScript. Union types allow existing types to be combined to form a new type using the pipe (|) character. An example is provided of a union type for an age variable that can be either a number or null. String literal and object union types are also discussed. String literal unions combine specific string values and object unions combine objects. Uses for object unions in React reducers are noted. The document concludes that union types create useful types from existing types to represent values that can be one type or another.

Uploaded by

Luke
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
19K views2 pages

Understanding TypeScript Union Types

This document discusses union types in TypeScript. Union types allow existing types to be combined to form a new type using the pipe (|) character. An example is provided of a union type for an age variable that can be either a number or null. String literal and object union types are also discussed. String literal unions combine specific string values and object unions combine objects. Uses for object unions in React reducers are noted. The document concludes that union types create useful types from existing types to represent values that can be one type or another.

Uploaded by

Luke
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd

Creating union types

In this lesson, we'll learn what a union type is, how to create one and some cases where they are useful.

We'll cover the following

• Understanding a union type


• String literal union types
• Object union types
• Wrap up

Understanding a union type #


As the name suggests, union types are types that we can combine together to form a new type. A union type is
constructed from existing types using the pipe ( | ) character:

type A_or_B_or_C = A | B | C;

Let’s go through an example to make this clear. Let’s say we have an age variable that can be null or
numeric. How could we create a type for this? Well we can combine the number and null types in a union
type as shown below:

TypeScript

1 let age: number | null;
2 age = null;      // okay
3 age = 30;        // okay
4 age = "30";      // error

RUN SAVE RESET

Close

Output 3.102s

[Link](4,1): error TS2322: Type '"30"' is not assignable to type 'number'.

Unioning a type with null is a common use case because data can often be null or a specific type.

How could we change the type of age so that it can be undefined as well as a number or null ? Make the
change in the code widget above.

Hide Answer

We simply add undefined to the union as follows:

let age: number | null | undefined;

String literal union types #


Specific string values can be unioned together to form what is called string literal union types.

What would the string literal union type be to represent the name of a fruit where it can only be Banana,
Apple, or Pear?

Hide Answer

"Banana" | "Apple" | "Pear"


These types are really useful when you want a more specific and narrower type than string .

Object union types #


Objects can be unioned together as well. For example:

type Actions = { type: "loading" } | { type: "loaded", data: {name: string} }

Can you think of an area in React code where this might be useful?

Hide Answer

Object unions are useful as the type of the action parameter in a reducer function. We will use object
unions later in this course when we learn how to strongly-type the useReducer hook.

Wrap up #
The union type is a way to create useful types from existing types. If a type can be something or something
else, then a union type can be used to represent that type.

String literal unions are a way of creating narrower typed strings than a plain string. Unioning with null or
undefined is a neat way to handle data that has a specific type and is empty.

More information on union types can be found in the TypeScript handbook


([Link]

Excellent; we are getting to grips with creating more advanced types now!

In the next lesson, we will learn about a slightly different way of combining existing types to construct a new
type.

Back Next

Creating interfaces Creating intersection types

Completed

43% completed, meet the criteria and claim your course certi cate!
Buy Certificate

Ask a Question
Report an Issue
([Link]

You might also like