In TypeScript, arrays are considered to be collections of single, “generic” types of values. All elements must be of the same type of data as prescribed in the array definition.
Defining an array
Array types can be inferred during the initialization of a new array.
In this example, the
vowels array is inferred to consist of elements of type
const vowels = ['a', 'e', 'i', 'o', 'u'];vowels.push('y'); // Okvowels.push(7);// Error: Argument of type 'number' is not assignable to parameter of type 'string'.
Arrays can also be defined with the “generic” type of its elements already preset in two ways:
const vowels: string = ['a', 'e', 'i', 'o', 'u'];// alternate way using Array classconst altVowels: Array<string> = ['a', 'e', 'i', 'o', 'u'];
More than one type can be prescribed in the array definition with the “or”
const numbers: (string | number) = [1, '2', 3, 'four'];// Alternative syntax// const numbers: [string, number] = [1, "2", 3, "four"];
As long as each element in
numbers is of type
number, it is valid.
An array type consists of the type of values inside the array followed by square brackets
Arrays without any initial contents may be declared as that type to tell TypeScript what will later go into them.
In this example,
dates doesn’t initially include a value, so declaring it as
Date tells TypeScript what’s allowed in it:
const dates: Date = ;dates.push(new Date('2021-12-1994')); // Okdates.push(10241995);// Error: Argument of type 'number' is not assignable to parameter of type 'Date'.
- Learn more about how to get involved.
- Edit this page on GitHub to fix an error or make an improvement.
- Submit feedback to let us know how we can improve Docs.