BradCypert.com
Typescript: What is a Partial?
January 10, 2020

Typescript: What is a Partial?

Posted on January 10, 2020  (Last modified on December 27, 2022 )
2 minutes  • 334 words
This project uses these versions of languages, frameworks, and libraries.
  • typescript typescript : 3.4
This tutorial may work with newer versions and possibly older versions, but has only been tested on the versions mentioned above.

A common theme in TypeScript is to define an interface for a data structure. Additionally, it’s fairly common to post data structures to an HTTP endpoint to create resources. You may even find yourself posting another structure with some of the same properties to update that data structure. Instead of creating another interface for the update, in this example, this is where the use of Typescript’s Partial comes in to play.

Imagine that we have the following interface.

interface User {
  id: int;
  email: string;
  password: string;
  hairColor: string;
}

It’s safe to assume that there may be a time where we want something that looks like a User but maybe doesn’t have all of the keys. For example, this object:

const baldMan = {
  id: 1,
  email: "[email protected]",
  password: "iShaveMyHeadBecauseItsCool123",
};

This isn’t a valid User as it doesn’t have a hairColor. You may say, “Well, we can just add hairColor as an empty string” and you’re right, but that’s not the most accurate way to represent this structure. The most accurate way would be to make hairColor an optional parameter:

interface User {
  id: int;
  email: string;
  password: string;
  hairColor?: string;
}

What do you do, however, if you have a function that expects all of those types to be optional (for example, a patch HTTP request)? Instead of going in and adding a ? to all of the properties, which would lower the quality of our interface, we can leverage TypeScript’s Partial like so:

function update(user: Partial<User>) {...}

TypeScript’s Partial uses generics . The generic is a type that you provide and it is respected as a type that represents all subsets of a given type. In layman’s terms: It makes all the properties optional.

It’s worth mentioning that by using Partial, all of the properties become optional in the scope of that type. In the above example, this makes sense for an ID as we probably won’t generate an ID on the frontend and expect the database to autogenerate one.

Cartoon headshot of Brad Cypert
Follow me

Connect with me to follow along on my journey in my career, open source, and mentorship. Occasionally, I'll share good advice and content (quality not guaranteed).