Satisfies operator in Typescript

Introduction

The satisfies operator helps check if a value matches a specific type without changing the value. It keeps your code safe and clear.

When you want to make sure an object fits a certain shape but keep all its details.

When you want to catch mistakes early by checking types during coding.

When you want to write clear code that shows what type a value should have.

When you want to avoid extra type conversions but still check types.

When you want to use complex types and ensure your data matches them.

Syntax

Typescript

const variable = value satisfies Type;

The satisfies operator checks the type but does not change the value's type.

This helps catch errors without losing information about the value.

Examples

This checks that user has a name as string and age as number.

Typescript

const user = {
  name: "Alice",
  age: 30
} satisfies { name: string; age: number };

This checks that colors is an array of strings that cannot be changed.

Typescript

const colors = ["red", "green", "blue"] satisfies readonly string[];

This checks that point has x and y as numbers, extra z is allowed.

Typescript

const point = { x: 10, y: 20, z: 30 } satisfies { x: number; y: number };

Sample Program

This program defines a type Person and checks that person fits it. Extra property city is allowed. Then it prints the person object.

Typescript

type Person = {
  name: string;
  age: number;
};

const person = {
  name: "Bob",
  age: 25,
  city: "New York"
} satisfies Person;

console.log(person);

Important Notes

The satisfies operator is new in TypeScript 4.9 and later.

It helps keep extra properties without errors, unlike direct type annotations.

Summary

The satisfies operator checks if a value matches a type without changing it.

It helps catch mistakes and keep extra details in your data.

Use it to write safer and clearer TypeScript code.

Practice

1.

What does the satisfies operator do in TypeScript?

easy

A. Creates a new type from existing types

B. Converts a value to a different type

C. Removes properties from an object

D. Checks if a value matches a type without changing the value

Solution

1. Step 1: Understand the purpose of satisfies

   The satisfies operator checks if a value fits a type but keeps the original value unchanged.

2. Step 2: Compare with other type operations

   Unlike type conversion or creating new types, satisfies only verifies compatibility without altering the value.

3. Final Answer:

   Checks if a value matches a type without changing the value -> Option D

4. Quick Check:

   satisfies = type check only [OK]

Hint: Remember: satisfies checks type but keeps original value [OK]

Common Mistakes:

• Thinking it converts or changes the value
• Confusing it with type casting
• Assuming it removes object properties

2.

Which of the following is the correct syntax to use the satisfies operator in TypeScript?

const data = { name: "Alice", age: 30 } ___ Person;

easy

A. :

B. as

C. satisfies

D. implements

Solution

1. Step 1: Recall the syntax of satisfies

   The satisfies operator is used between the value and the type like: value satisfies Type.

2. Step 2: Identify the correct operator in the code

   In the example, the blank should be filled with satisfies to check the type without changing data.

3. Final Answer:

   satisfies -> Option C

4. Quick Check:

   Syntax uses satisfies keyword [OK]

Hint: Use 'satisfies' keyword between value and type [OK]

Common Mistakes:

• Using ':' which is for type annotations
• Using 'as' which is for type assertions
• Using 'implements' which is for classes

3.

What will be the output of this TypeScript code?

type Person = { name: string; age: number };

const user = {
  name: "Bob",
  age: 25,
  city: "Paris"
} satisfies Person;

console.log(user.city);

medium

A. "Paris"

B. Error: Property 'city' does not exist on type 'Person'

C. undefined

D. null

Solution

1. Step 1: Understand what satisfies does to the object

   The satisfies operator checks that user matches Person type but keeps all original properties, including city.

2. Step 2: Check the console.log output

   Since user still has city, logging user.city prints "Paris" without error.

3. Final Answer:

   "Paris" -> Option A

4. Quick Check:

   satisfies keeps extra properties [OK]

Hint: Extra properties stay accessible with satisfies [OK]

Common Mistakes:

• Assuming satisfies removes extra properties
• Expecting a type error on extra properties
• Confusing satisfies with type assertion

4.

Identify the error in this TypeScript code using satisfies:

type Config = { port: number; host: string };

const serverConfig = {
  port: "8080",
  host: "localhost"
} satisfies Config;

medium

A. Type error: 'port' should be a number, not a string

B. No error, code is correct

C. Syntax error: 'satisfies' cannot be used here

D. Runtime error: 'host' is missing

Solution

1. Step 1: Check the type of each property in serverConfig

   The port property is a string "8080" but Config expects a number.

2. Step 2: Understand what satisfies checks

   satisfies verifies type compatibility and will raise a type error because of the wrong type for port.

3. Final Answer:

   Type error: 'port' should be a number, not a string -> Option A

4. Quick Check:

   Type mismatch causes error with satisfies [OK]

Hint: Check property types carefully with satisfies [OK]

Common Mistakes:

• Ignoring type mismatch on properties
• Thinking satisfies changes the value type
• Assuming no error if extra properties exist

5.

You want to create a constant object settings that must have theme as a string and notifications as a boolean. You also want to keep extra properties without losing their types. Which code correctly uses satisfies to achieve this?

hard

A. const settings = { theme: "dark", notifications: true, version: 2 } as { theme: string; notifications: boolean };

B. const settings = { theme: "dark", notifications: true, version: 2 } satisfies { theme: string; notifications: boolean };

C. const settings: { theme: string; notifications: boolean } = { theme: "dark", notifications: true, version: 2 };

D. const settings = { theme: "dark", notifications: true, version: 2 };

Solution

1. Step 1: Understand the goal

   You want settings to be checked against a type but keep extra properties like version with their types intact.

2. Step 2: Compare options

   const settings = { theme: "dark", notifications: true, version: 2 } satisfies { theme: string; notifications: boolean }; uses satisfies which checks the required properties but keeps extra ones with full types. const settings: { theme: string; notifications: boolean } = { theme: "dark", notifications: true, version: 2 }; uses type annotation which drops extra properties. const settings = { theme: "dark", notifications: true, version: 2 } as { theme: string; notifications: boolean }; uses type assertion which forces the type and may lose extra property types. const settings = { theme: "dark", notifications: true, version: 2 }; has no type checking.

3. Final Answer:

   const settings = { theme: "dark", notifications: true, version: 2 } satisfies { theme: string; notifications: boolean }; -> Option B

4. Quick Check:

   satisfies keeps extra properties typed [OK]

Hint: Use satisfies to keep extra properties typed safely [OK]

Common Mistakes:

• Using type annotation and losing extra properties
• Using type assertion and ignoring type safety
• Not checking required properties at all