Readonly Arrays and Tuples

Pro Members Only

This lesson is available if you have an active subscription.

Alternatively, some member might be able to gift it to you.

If you already have a subscription, you can sign in.

Professional TypeScript Masterclass Lessons

1.Introduction
free
⏱️ 1:54
2.Setup
free
⏱️ 5:44
3.Primitive Types
free
⏱️ 1:42
4.Instance Types
free
⏱️ 1:52
5.Arrays And Tuples
free
⏱️ 1:38
6.Objects
free
⏱️ 1:33
7.const declarations
free
⏱️ 1:03
8.Function Types
free
⏱️ 1:57
9.Structural Typing
free
⏱️ 2:10
10.Classes in TypeScript
free
⏱️ 1:48
11.Target Compiler Option
free
⏱️ 2:37
12.Generics
⏱️ 3:02
13.Special Types any And unknown
⏱️ 2:00
14.JavaScript to TypeScript
⏱️ 1:32
15.Frontend Projects
⏱️ 3:49
16.Type Assertions
⏱️ 2:15
17.Type Casting
⏱️ 1:16
18.Modules
⏱️ 1:55
19.Type Declarations
⏱️ 4:25
20.Creating NPM packages
⏱️ 3:20
21.Async Await
⏱️ 3:05
22.Running in NodeJS
⏱️ 1:40
23.Lexical this
⏱️ 2:34
24.readonly Modifier
⏱️ 1:59
25.Union Types
⏱️ 2:57
26.Literal Types
⏱️ 2:58
27.Type Narrowing
⏱️ 4:19
28.Discriminated Unions
⏱️ 3:29
29.Class Parameter Properties
⏱️ 1:02
30.Strict Compiler Option
⏱️ 6:18
31.null vs undefined
⏱️ 4:19
32.Intersection Types
⏱️ 2:03
33.Optional Modifier
⏱️ 2:47
34.Non Null Assertion Operator
⏱️ 3:40
35.Interfaces
⏱️ 2:28
36.Interface Declaration Merging
⏱️ 1:01
37.Types vs Interfaces
⏱️ 2:16
38.never Type
⏱️ 3:00
39.implements Keyword
⏱️ 1:25
40.Definite Assignment Assertion
⏱️ 2:31
41.User Defined Type Guards
⏱️ 2:02
42.Assertion Functions
⏱️ 3:42
43.Function Overloading
⏱️ 4:15
44.Call Signatures
⏱️ 2:53
45.Abstract Classes
⏱️ 1:53
46.Index Signatures
⏱️ 3:08
47.Readonly Arrays and Tuples
⏱️ 2:58
48.Double Assertions
⏱️ 2:20
49.const Assertions
⏱️ 3:55
50.this Parameter
⏱️ 2:33
51.Generic Constraints
⏱️ 2:43
52.typeof Type Operator
⏱️ 2:12
53.Lookup Types
⏱️ 3:12
54.keyof Type Operator
⏱️ 3:55
55.Conditional Types
⏱️ 4:39
56.Contitional Types with Unions and never
⏱️ 3:32
57.infer Keyword and `ReturnType<T>`
⏱️ 3:47
58.Mapped Types
⏱️ 2:48
59.Mapped Type Modifiers
⏱️ 3:37
60.Template Literal Type
⏱️ 4:28
61.Partial<T>
⏱️ 1:27
62.Required<T>
⏱️ 1:36
63.Readonly<T>
⏱️ 1:34
64.Record<K, T>
⏱️ 4:05
65.Project References
⏱️ 4:18
66.undefined vs. optional
⏱️ 2:48
67.satisfies Operator
⏱️ 2:42
68.PropertyKey Type
⏱️ 0:57
69.ThisType<T>
⏱️ 4:11
70.Awaited<T>
⏱️ 4:12
71.String Manipulation Types
⏱️ 3:36
72.Mapped Types as Clauses
⏱️ 4:01
73.Union vs Intersection Mental Model
⏱️ 3:36
74.Enums are Bad
⏱️ 8:11

Readonly Arrays and Tuples

Subscription Required

You must have an active subscription to access this content.
If you already have a subscription, you can sign in.

Without readonly

Array mutation is too easy in JavaScript e.g.:

function reverseSorted(input: number[]): number[] {
return input.sort().reverse();
}

const start = [1, 2, 3, 5, 4];
const result = reverseSorted(start);

console.log(result); // [5, 4, 3, 2, 1]
console.log(start); // [5, 4, 3, 2, 1] 💥

With readonly

Add readonly to the array type and TypeScript will keep you from making silly mistakes. e.g.:

function reverseSorted(input: readonly number[]): number[] {
return input.slice().sort().reverse();
}

const start = [1, 2, 3, 5, 4];
const result = reverseSorted(start);

console.log(result); // [5, 4, 3, 2, 1]
console.log(start); // [1, 2, 3, 4, 5] 🧊

Generic Definition

Just like we can use Array<T> for arrays, we can use ReadonlyArray<T> for readonly versions e.g.:

type Neat = readonly number[];
type Long = ReadonlyArray<number>;

Tuples

readonly can also be added to tuples e.g.:

type Point = readonly [number, number];

function move(point: Point, x: number, y: number): Point {
return [point[0] + x, point[1] + y];
}
javascript
typescript
react
playwright

Enjoy free content straight from your inbox 💌

No spam, unsubscribe at any time.

Transcript

00:00

Here we have a JavaScript function that takes an input array and then invokes sort and reverse. To return a reverse sorted array, we create an array of five numbers stored in a start variable. Then we invoke this reverse sorted function and then store the result in a result variable. Now at this point, our result is exactly what we expected it to be. It is the five numbers in reverse sorted order. However, sadly, the reverse sorted function has also mutated our input array. This is a very common mistake to make when beginning JavaScript development.

00:33

And the reason is that the sort and the reverse methods, in addition to returning the results, also mutate the original array. Fortunately, with TypeScript, instead of declaring the input as a number array, we can declare it as a read only number array, and now any mutating methods will no longer be available on input. So if you want to use the sort and the reverse methods, the first thing that we will need to do is to create a copy of the input array using the built-in slice method. This creates a new non read only array, which can then be safely sorted

01:05

and reversed and then returned. And now when we invoke this reverse sorted method on the start variable, the start variable is no longer mutated, which is very, very cool. Now, you might remember that for JavaScript arrays, TypeScript has a needs syntax, which we prefer as well as a more verbose array generic syntax. The same is true for read only arrays. We prefer the needs syntax, as you saw us already use that for the input parameter, but there is an equivalent read only array generic interface. Now, TypeScript also supports read only couples,

01:37

and we've mentioned this before, that couples are simply erased with fixed length. So let's look at a topple example. Here we have a topple representing a point in two dimensional space with two members, both of type number. We create this utility move function that accepts a given point and the distance to move in the X and Y dimensions, and then updates the values in the input double, and then returns the modified double. So if we create a point with X and Y zero and move it by amount 10 and 10 in the x and Y dimensions, we do get the moved point with 10 10.

02:11

However, this results in a side effect of mutating our input point also to 10 10, which makes us set. Now just like a arrays, we can annotate a couple as read only by using the read only modifier before the double declaration. And now any attempts to modify any given point we'll result in a compiler error. For example, here you can see that we cannot mutate the Y value. So now we can fix this error by replacing our mutating implementation with an implementation that returns a new double created from the existing double plus the moves in the X and Y dimensions.

02:45

So now when we invoke the move method on an existing point, we no longer mutate the original point, which replaces our sad tears with tears of joy.

Professional TypeScript Masterclass

Professional TypeScript Masterclass

1.Introduction
free
⏱️ 1:54
2.Setup
free
⏱️ 5:44
3.Primitive Types
free
⏱️ 1:42
4.Instance Types
free
⏱️ 1:52
5.Arrays And Tuples
free
⏱️ 1:38
6.Objects
free
⏱️ 1:33
7.const declarations
free
⏱️ 1:03
8.Function Types
free
⏱️ 1:57
9.Structural Typing
free
⏱️ 2:10
10.Classes in TypeScript
free
⏱️ 1:48
11.Target Compiler Option
free
⏱️ 2:37
12.Generics
⏱️ 3:02
13.Special Types any And unknown
⏱️ 2:00
14.JavaScript to TypeScript
⏱️ 1:32
15.Frontend Projects
⏱️ 3:49
16.Type Assertions
⏱️ 2:15
17.Type Casting
⏱️ 1:16
18.Modules
⏱️ 1:55
19.Type Declarations
⏱️ 4:25
20.Creating NPM packages
⏱️ 3:20
21.Async Await
⏱️ 3:05
22.Running in NodeJS
⏱️ 1:40
23.Lexical this
⏱️ 2:34
24.readonly Modifier
⏱️ 1:59
25.Union Types
⏱️ 2:57
26.Literal Types
⏱️ 2:58
27.Type Narrowing
⏱️ 4:19
28.Discriminated Unions
⏱️ 3:29
29.Class Parameter Properties
⏱️ 1:02
30.Strict Compiler Option
⏱️ 6:18
31.null vs undefined
⏱️ 4:19
32.Intersection Types
⏱️ 2:03
33.Optional Modifier
⏱️ 2:47
34.Non Null Assertion Operator
⏱️ 3:40
35.Interfaces
⏱️ 2:28
36.Interface Declaration Merging
⏱️ 1:01
37.Types vs Interfaces
⏱️ 2:16
38.never Type
⏱️ 3:00
39.implements Keyword
⏱️ 1:25
40.Definite Assignment Assertion
⏱️ 2:31
41.User Defined Type Guards
⏱️ 2:02
42.Assertion Functions
⏱️ 3:42
43.Function Overloading
⏱️ 4:15
44.Call Signatures
⏱️ 2:53
45.Abstract Classes
⏱️ 1:53
46.Index Signatures
⏱️ 3:08
47.Readonly Arrays and Tuples
⏱️ 2:58
48.Double Assertions
⏱️ 2:20
49.const Assertions
⏱️ 3:55
50.this Parameter
⏱️ 2:33
51.Generic Constraints
⏱️ 2:43
52.typeof Type Operator
⏱️ 2:12
53.Lookup Types
⏱️ 3:12
54.keyof Type Operator
⏱️ 3:55
55.Conditional Types
⏱️ 4:39
56.Contitional Types with Unions and never
⏱️ 3:32
57.infer Keyword and `ReturnType<T>`
⏱️ 3:47
58.Mapped Types
⏱️ 2:48
59.Mapped Type Modifiers
⏱️ 3:37
60.Template Literal Type
⏱️ 4:28
61.Partial<T>
⏱️ 1:27
62.Required<T>
⏱️ 1:36
63.Readonly<T>
⏱️ 1:34
64.Record<K, T>
⏱️ 4:05
65.Project References
⏱️ 4:18
66.undefined vs. optional
⏱️ 2:48
67.satisfies Operator
⏱️ 2:42
68.PropertyKey Type
⏱️ 0:57
69.ThisType<T>
⏱️ 4:11
70.Awaited<T>
⏱️ 4:12
71.String Manipulation Types
⏱️ 3:36
72.Mapped Types as Clauses
⏱️ 4:01
73.Union vs Intersection Mental Model
⏱️ 3:36
74.Enums are Bad
⏱️ 8:11