TypeScript Array Type

Summary: in this tutorial, you’ll learn about the TypeScript array type and its basic operations.

Introduction to TypeScript array type

A TypeScript array is an ordered list of data. To declare an array that holds values of a specific type, you use the following syntax:

let arrayName: type[];Code language: JavaScript (javascript)

For example, the following declares an array of strings:

let skills: string[];Code language: TypeScript (typescript)

And you can add one or more strings to the array:

skills[0] = "Problem Solving";
skills[1] = "Programming";Code language: TypeScript (typescript)

or use the push() method:

skills.push('Software Design');Code language: JavaScript (javascript)

The following declares a variable and assigns an array of strings to it:

let skills = ['Problem Sovling','Software Design','Programming'];Code language: TypeScript (typescript)

In this example, TypeScript infers the skills array as an array of strings. It is equivalent to the following:

let skills: string[];
skills = ['Problem Sovling','Software Design','Programming'];Code language: TypeScript (typescript)

Once you define an array of a specific type, TypeScript will prevent you from adding incompatible values to the array.

The following will cause an error:

skills.push(100);Code language: CSS (css)

… because we’re trying to add a number to the string array.

Error:

Argument of type 'number' is not assignable to parameter of type 'string'.Code language: Shell Session (shell)

When you extract an element from the array, TypeScript can do type inference. For example:

let skill = skills[0];
console.log(typeof(skill));Code language: TypeScript (typescript)

Output:

string 

In this example, we extract the first element of the skills array and assign it to the skill variable.

Since an element in a string array is a string, TypeScript infers the type of the skill variable to string as shown in the output.

TypeScript array properties and methods

TypeScript arrays can access the properties and methods of JavaScript. For example, the following uses the length property to get the number of elements in an array:

let series = [1, 2, 3];
console.log(series.length); // 3Code language: TypeScript (typescript)

And you can use all the useful array methods such as forEach(), map(), reduce(), and filter(). For example:

let series = [1, 2, 3];
let doubleIt = series.map(e => e* 2);
console.log(doubleIt);Code language: TypeScript (typescript)

Output:

[ 2, 4, 6 ] Code language: JSON / JSON with Comments (json)

Storing values of mixed types

The following illustrates how to declare an array that holds both strings and numbers:

let scores = ['Programming', 5, 'Software Design', 4]; Code language: TypeScript (typescript)

In this case, TypeScript infers the scores array as an array of string | number.

It’s equivalent to the following:

let scores : (string | number)[];
scores = ['Programming', 5, 'Software Design', 4]; Code language: TypeScript (typescript)

Summary

• In TypeScript, an array is an ordered list of values. An array can store a mixed type of values.
• To declare an array of a specific type, you use the let arr: type[] syntax.