Readonly properties in Typescript

Introduction

Readonly properties help keep some parts of your data safe by not allowing changes after setting them once.

When you want to make sure a value in an object never changes after creation.

When sharing data between parts of a program and you want to avoid accidental changes.

When creating configuration objects that should stay the same during the program.

When working with data models where some fields must stay constant.

When you want to catch mistakes early by preventing unwanted updates.

Syntax

Typescript

class MyClass {
  readonly propertyName: type;
  constructor(value: type) {
    this.propertyName = value;
  }
}

The readonly keyword goes before the property name.

You can set the value only once, usually in the constructor.

Examples

This class has a readonly name property set when creating a new person.

Typescript

class Person {
  readonly name: string;
  constructor(name: string) {
    this.name = name;
  }
}

This is the correct way to declare a readonly property in an object literal using a type annotation.

Typescript

const obj: { readonly id: number } = {
  id: 123
};

Readonly properties can also be used in interfaces to describe objects that should not change these fields.

Typescript

interface Car {
  readonly make: string;
  readonly model: string;
}

Sample Program

This program creates a Book with a readonly title. It prints the title. Trying to change the title later will cause an error.

Typescript

class Book {
  readonly title: string;
  constructor(title: string) {
    this.title = title;
  }
}

const myBook = new Book("Learn TypeScript");
console.log(myBook.title);

// The next line would cause an error if uncommented:
// myBook.title = "New Title";

Important Notes

Readonly properties can only be assigned once, usually in the constructor or when declared.

Trying to change a readonly property after it is set will cause a compile-time error.

Readonly helps prevent bugs by making data safer and easier to understand.

Summary

Readonly properties keep values from changing after they are set.

Use readonly before a property name in classes or interfaces.

This helps protect important data and avoid mistakes.

Practice

1. What does the readonly keyword do in TypeScript?

easy

A. Prevents a property from being changed after it is set

B. Allows a property to be changed anytime

C. Makes a property private and inaccessible

D. Deletes a property from an object

Solution

1. Step 1: Understand the purpose of readonly

   The readonly keyword is used to mark properties that cannot be changed after initialization.

2. Step 2: Compare options with the behavior

   Only Prevents a property from being changed after it is set correctly describes that the property cannot be changed after it is set.

3. Final Answer:

   Prevents a property from being changed after it is set -> Option A

4. Quick Check:

   readonly means no changes allowed after set [OK]

Hint: Readonly means no changes allowed after initial set [OK]

Common Mistakes:

• Thinking readonly allows changes anytime
• Confusing readonly with private
• Assuming readonly deletes properties

2. Which of the following is the correct way to declare a readonly property id in a TypeScript class?

easy

A. const id: number;

B. readonly id: number;

C. private readonly id: number;

D. id readonly: number;

Solution

1. Step 1: Recall TypeScript syntax for readonly properties

   The correct syntax is to place readonly before the property name.

2. Step 2: Check each option

   readonly id: number; uses readonly id: number; which is correct. const id: number; uses const which is invalid inside class properties. private readonly id: number; adds private which is valid but not asked for. id readonly: number; has wrong order.

3. Final Answer:

   readonly id: number; -> Option B

4. Quick Check:

   Readonly keyword goes before property name [OK]

Hint: Put readonly before property name in class [OK]

Common Mistakes:

• Using const instead of readonly in class
• Placing readonly after property name
• Confusing access modifiers with readonly

3. What will be the output of this TypeScript code?

class User {
  readonly name: string;
  constructor(name: string) {
    this.name = name;
  }
}
const user = new User('Alice');
user.name = 'Bob';
console.log(user.name);

medium

A. Alice

B. Bob

C. undefined

D. Compile-time error

Solution

1. Step 1: Understand readonly property behavior

   The property name is marked readonly, so it cannot be assigned a new value after construction.

2. Step 2: Analyze the assignment user.name = 'Bob'

   This line tries to change a readonly property, which causes a compile-time error in TypeScript.

3. Final Answer:

   Compile-time error -> Option D

4. Quick Check:

   Assigning to readonly property causes error [OK]

Hint: Changing readonly property causes compile error [OK]

Common Mistakes:

• Assuming readonly properties can be changed anytime
• Expecting runtime error instead of compile error
• Thinking output will be the new value

4. Identify the error in this TypeScript code and fix it:

interface Point {
  readonly x: number;
  y: number;
}
const p: Point = { x: 10, y: 20 };
p.x = 15;
console.log(p.x);

medium

A. Property 'y' should be readonly too

B. Missing type annotation for 'p'

C. Cannot assign to 'x' because it is a readonly property

D. No error, code runs fine

Solution

1. Step 1: Check readonly property assignment

   The property x is readonly in the interface, so assigning p.x = 15 is not allowed.

2. Step 2: Identify the error message

   TypeScript will report an error: "Cannot assign to 'x' because it is a readonly property".

3. Final Answer:

   Cannot assign to 'x' because it is a readonly property -> Option C

4. Quick Check:

   Readonly properties cannot be assigned after initialization [OK]

Hint: Readonly properties cannot be reassigned after creation [OK]

Common Mistakes:

• Ignoring readonly and trying to assign anyway
• Thinking missing type annotation causes error
• Assuming no error occurs

5. You want to create a TypeScript class Config where the version property is set once during construction and never changes, but settings can be updated anytime. Which is the best way to declare these properties?

hard

A. readonly version: string; settings: object;

B. version: string; readonly settings: object;

C. readonly version: string; readonly settings: object;

D. version: string; settings: object;

Solution

1. Step 1: Understand property requirements

   The version should be readonly (set once, no changes). The settings should be mutable (can change anytime).

2. Step 2: Match options with requirements

   readonly version: string; settings: object; correctly marks version as readonly and leaves settings mutable. version: string; readonly settings: object; reverses roles. readonly version: string; readonly settings: object; makes both readonly. version: string; settings: object; makes both mutable.

3. Final Answer:

   readonly version: string; settings: object; -> Option A

4. Quick Check:

   Readonly for fixed, mutable for changeable properties [OK]

Hint: Readonly for fixed, normal for changeable properties [OK]

Common Mistakes:

• Making mutable properties readonly by mistake
• Not using readonly for fixed properties
• Confusing which property should be readonly