Why Read-only arrays in Typescript? - Purpose & Use Cases

The Big Idea

What if your important data could never be changed by mistake, no matter who uses it?

The Scenario

Imagine you have a list of your favorite songs saved in a simple array. You want to share this list with your friend so they can see it but not change it. If you just give them the normal array, they might accidentally remove or add songs, messing up your original list.

The Problem

Using normal arrays means anyone with access can change the list by adding, removing, or editing items. This can cause bugs or unexpected problems, especially when many parts of a program use the same list. Manually copying arrays every time to protect them is slow and easy to forget.

The Solution

Read-only arrays let you share your list safely by making it impossible to change. They act like a locked display case: everyone can look but no one can touch. This keeps your data safe and your program more reliable without extra copying or checks.

Before vs After

✗ Before

const favoriteSongs = ['Song A', 'Song B'];
favoriteSongs.push('Song C'); // Allowed, but can cause bugs

✓ After

const favoriteSongs: readonly string[] = ['Song A', 'Song B'];
// favoriteSongs.push('Song C'); // Error: cannot modify readonly array

What It Enables

It enables safe sharing of data by preventing accidental changes, making your code more predictable and easier to maintain.

Real Life Example

When building a music app, you might want to show a playlist to users without letting them change the original list. Using read-only arrays ensures the playlist stays exactly as intended.

Key Takeaways

Read-only arrays prevent accidental changes to data.

They help keep your program stable and bug-free.

They make sharing data safer and easier.

Practice

1. What does a readonly array in TypeScript do?

easy

A. Only prevents changing the array length

B. Allows adding new elements but not removing existing ones

C. Makes the array elements optional

D. Prevents any changes to the array elements after creation

Solution

1. Step 1: Understand the readonly keyword

   The readonly keyword before an array type means the array cannot be changed after it is created.

2. Step 2: Effects on the array

   This means you cannot add, remove, or modify elements in the array once it is set.

3. Final Answer:

   Prevents any changes to the array elements after creation -> Option D

4. Quick Check:

   readonly arrays are immutable [OK]

Hint: Readonly arrays block all changes to elements [OK]

Common Mistakes:

• Thinking readonly only blocks length changes
• Assuming elements can be modified individually
• Confusing readonly with optional elements

2. Which of the following is the correct syntax to declare a read-only array of numbers in TypeScript?

easy

A. let nums: readonly number[] = [1, 2, 3];

B. let nums: number[] readonly = [1, 2, 3];

C. let nums: number readonly[] = [1, 2, 3];

D. let nums: number[] = readonly [1, 2, 3];

Solution

1. Step 1: Recall the correct readonly syntax

   In TypeScript, readonly comes before the array type, like readonly number[].

2. Step 2: Check each option

   let nums: readonly number[] = [1, 2, 3]; uses readonly number[], which is correct syntax. Others place readonly incorrectly.

3. Final Answer:

   let nums: readonly number[] = [1, 2, 3]; -> Option A

4. Quick Check:

   readonly before type [OK]

Hint: Put readonly before the array type, not after [OK]

Common Mistakes:

• Placing readonly after the array brackets
• Using readonly as a variable modifier
• Trying to put readonly inside the array literal

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

const arr: readonly string[] = ['a', 'b', 'c'];
// arr.push('d');
console.log(arr.length);

medium

A. 4

B. undefined

C. 3

D. Error: Property 'push' does not exist on type 'readonly string[]'

Solution

1. Step 1: Understand the array declaration

   The array arr is declared as readonly string[] with 3 elements: 'a', 'b', 'c'.

2. Step 2: Check the commented out push and output

   The push line is commented out, so it does not run. The length remains 3.

3. Final Answer:

   3 -> Option C

4. Quick Check:

   Readonly array length unchanged = 3 [OK]

Hint: Commented push means length stays same [OK]

Common Mistakes:

• Assuming push works on readonly arrays
• Expecting length to increase despite push commented
• Confusing runtime errors with compile-time errors

4. Identify the error in this TypeScript code using a read-only array:

const nums: readonly number[] = [1, 2, 3];
nums[0] = 10;

medium

A. Type 'number' is not assignable to type 'readonly number[]'

B. Cannot assign to '0' because it is a read-only property

C. Syntax error: missing semicolon

D. No error, code runs fine

Solution

1. Step 1: Understand the readonly array behavior

   The array nums is readonly, so its elements cannot be changed after creation.

2. Step 2: Analyze the assignment to an element

   Trying to assign nums[0] = 10 causes an error because elements are read-only.

3. Final Answer:

   Cannot assign to '0' because it is a read-only property -> Option B

4. Quick Check:

   Readonly elements cannot be changed [OK]

Hint: Readonly arrays block element assignment [OK]

Common Mistakes:

• Thinking only array structure is readonly, not elements
• Ignoring TypeScript error messages
• Assuming semicolon missing causes error

5. Given a function that accepts a read-only array, which of these operations inside the function is allowed?

function process(items: readonly number[]) {
  // Which line is valid?
  // A) items.push(5);
  // B) items[0] = 10;
  // C) const first = items[0];
  // D) items.length = 0;
}

hard

A. const first = items[0];

B. items.push(5);

C. items[0] = 10;

D. items.length = 0;

Solution

1. Step 1: Understand read-only array restrictions

   Read-only arrays do not allow modifying methods like push, element assignment, or length changes.

2. Step 2: Check each operation

   Only reading elements, like const first = items[0];, is allowed. Others cause errors.

3. Final Answer:

   const first = items[0]; -> Option A

4. Quick Check:

   Reading elements allowed, modifying disallowed [OK]

Hint: Readonly arrays allow reading, not modifying [OK]

Common Mistakes:

• Trying to push or assign elements in readonly arrays
• Attempting to change array length
• Confusing read-only with mutable arrays