Understanding and Ensuring Type Safety with TypeScript’s Record Type

An in-depth look at TypeScript’s Record type definition, usage, benefits, and practical examples.

TypeScript adds a powerful static type system to JavaScript, enhancing code stability and readability. Among its features, the `Record` type is particularly useful for defining specific key-value pair structures. In this article, we will explore the definition, usage, benefits, and practical examples of the `Record` type in depth.

Definition of the Record Type

The `Record` type takes two generic type parameters:

  • The first parameter is the type of the keys (`K`).
  • The second parameter is the type of the values (`T`).

In other words, `Record<K, T>` defines an object type with key type `K` and value type `T`. This allows you to clearly specify the types of an object’s keys and values.

Basic Usage

type ButtonSize = 'small' | 'medium' | 'large';

const gapMap: Record<ButtonSize, number> = {
  small: 5,
  medium: 10,
  large: 15

In the example above, the `ButtonSize` type is defined to be one of the strings ‘small’, ‘medium’, or ‘large’. The `gapMap` object uses `ButtonSize` as the key type, with all values being of type number. This clearly defines the structure of the `gapMap` object.

Values of Complex Types

The `Record` type can also have complex types for its values.

type UserRole = 'admin' | 'user' | 'guest';
type UserInfo = { name: string; age: number };

const userMap: Record<UserRole, UserInfo> = {
  admin: { name: 'Alice', age: 30 },
  user: { name: 'Bob', age: 25 },
  guest: { name: 'Charlie', age: 20 }

In the example above, the `UserRole` type is used as the key, and the `UserInfo` type is used as the value in an object. This clearly specifies information for each user role.

Benefits of the Record Type

  • Type Safety: Clearly defines the types of object keys and values to ensure type safety.
  • Code Readability: Enhances code readability through type definitions.
  • Auto-Completion: Leverages auto-completion features in IDEs for key and value types.


  • The keys of a `Record` type must be strings, numbers, or symbols.
  • As the value type becomes more complex, the type definition can also become complex. It’s advisable to define separate types for readability when necessary.

Practical Examples

Let’s look at a more practical example of using the `Record` type.

type ApiResponseStatus = 'success' | 'error' | 'loading';
type ApiResponse = { status: ApiResponseStatus; data?: any; error?: string };

const apiResponseMap: Record<string, ApiResponse> = {
  userFetch: { status: 'loading' },
  userFetchSuccess: { status: 'success', data: { name: 'John', age: 35 } },
  userFetchError: { status: 'error', error: 'User not found' }

In this example, the `apiResponseMap` object manages various API response statuses. Each key represents the status of a specific API request, and the values follow the `ApiResponse` type. This helps manage API response states systematically while ensuring type safety.


TypeScript’s `Record` type is a highly useful tool for defining specific key-value pair structures and enhancing type safety. It allows you to clearly define the structure of objects, improve code readability, and leverage IDE auto-completion features to boost development efficiency. By using various practical examples, you can write more robust and maintainable code with the `Record` type.

For more examples and in-depth learning with TypeScript, it is recommended to refer to the official documentation and various community resources. The powerful type system of TypeScript can significantly enhance development productivity and help you write stable code.

답글 남기기