配列したい（[] / Array）

// JavaScript
const array = ["a1", "a2", "a3"];

// TypeScript
const array: string[] = ["a1", "a2", "a3"];
const array: Array<string> = ["a1", "a2", "a3"];

[]リテラルで配列を初期化できます。 TypeScriptでは、配列の要素の型名も指定する必要があります。

const array = new Array("a1", "a2", "a3");

new Array()コンストラクターでも配列を初期化できます。 ただし、引数の扱いに注意が必要なため、通常はリテラル記法で記述すれば問題ありません。

2次元配列したい（[][]）

// セル用の型を定義
type Cell = string | number | boolean | Date | null;
const values: Cell[][] = sheet.getDataRange().getValues();

スプレッドシートにあるデータを取得すると、2次元配列（行x列）として返ってきます。 Cell型を定義することで型安全を保つことができます。

// ヘッダー（header）とデータ（rows）に分割
// ヘッダー = 1行目：文字列に変換（Cell[] -> string[]）
// データ = 2行目以降：型はそのまま（Cell[]）
const header = values[0].map(String);
const rows = values
  .slice(1)
  .filter(row => row.some(cell => cell !== null && cell !== ""));

さらに、1行目がヘッダー、2行目以降がデータ領域となっていることが多いです。 ヘッダー（header）とデータ（rows）に分割しておくとよいです。

ヒント

スプレッドシートから取得したデータは Cell[][]型となっています。 ヘッダーに相当する1行目もCell[]になっているため、 上記のサンプルではstring[]に変換しています。 また、データ領域からは、["", ""] や ["", null]、[null, null]のようなどのカラムにも値が入っていない空行を除外しています。

// 配列として取得
for (const row of rows) {
    const col0 = row[0];
    const col1 = row[1];
}

// オブジェクトとして取り出す
// ヘッダー名をキーとして利用
const data = rows.map(row =>
  Object.fromEntries(
    header.map( (key, i) => [key, row[i]] )
  )
);

// Mapとして取り出す
const maps: Map<string, Cell>[] = rows.map(row =>
  new Map(header.map((key, i) => [key, row[i]]))
);

データ（rows）をそのまま2次元配列（Cell[][]）として扱ってもよいですが、ヘッダー名をキーとしたオブジェクトやMap型に変換すると便利です。

値を追加したい（Array.push）

// 空の配列を作成し、値を追加する
const array = new Array();
array.push("a1");
array.push("a2");
array.push("a3");

.pushで配列に値を追加できます。

// 配列の要素を取得
console.log(array[0]);  // -> a1
console.log(array[1]);  // -> a2
console.log(array[3]);  // -> a3

配列のインデックスを指定して、要素を取得できます。

array.length;  // -> 3
for (let i = 0; i < array.length; i++ ) {
    const item = array[i];
    console.log(item);
}

.lengthで配列の長さを取得できます。

結合したい（Array.concat）

const array1 = ["a", "b", "c"];
const array2 = [1, 2, 3];
const array3 = ["7", "8", "9"];
const array4 = array1.concat(array2, array3);
console.log(array4);
// -> ["a", "b", "c", 1, 2, 3, "7", "8", "9"];

concatメソッドで配列を連結できます。 複数の配列を連結できます。

const array5 = [...array1, ...array2];
console.log(array5);
// -> ["a", "b", "c", 1, 2, 3];

スプレッド演算子（...配列）でも連結できます。

ループしたい

// for...ofループ
for (const item of arrays) {
    console.log(item);
}

forEachしたい

// forEachメソッド
const newArrays = arrays.forEach(item => {
    // 処理
    console.log(item)
})

mapしたい

// mapメソッド
const newArrays = arrays.map(item => {
    // 処理
    return 結果;
})

mapメソッドで配列の要素に対して、同じ処理を適用できます。

// 平方根を計算したい
const numbers = [1, 4, 9, 16];
const sqrtNumbers = numbers.map(Math.sqrt);
console.log(sqrtNumbers);
// -> [1, 2, 3, 4];

filterしたい

// filterメソッド
const newArrays = arrays.filter(callbackFn);

const newArrays = arrays.filter(item => {
    // フィルター処理
    return 条件;
})

filterメソッドを使って、配列から条件にマッチした要素を抽出できます。

// 正の数を取得したい
const numbers = [1, -4, 9, -16];
const positives = numbers.filter(num => num > 0);
console.log(positives);
// -> [1, 9];

reduceしたい

const newScalar = arrays.reduce(callbackFn, initialValue);

const numbers = [10, 20, 30, 40];
const sum = numbers.reduce((left, right) => left + right, 0);
// step1. 初期値を 0 に設定
// step2. left=0, right=10 で計算 -> 10
// step3. left=直前の値, right=20 で計算 -> 30
// step4. left=直前の値, right=30 で計算 -> 60
// step5. left=直前の値, right=40 で計算 -> 100
const average = sum / numbers.length;
console.log(sum);  // -> 100
console.log(average);  // -> 25

flatしたい

const array1 = [1, 2, [3, 4]];
const array2 = array1.flat();
console.log(array2);
// -> [1, 2, 3, 4];

flatメソッドで配列を平坦化できます。 引数に平坦化の深さを指定できます。 平坦化する際、配列の空要素は削除されます。

最大値・最小値したい（Math.max / Math.min）

const numbers = [10, 20, 5, 40];
const max = Math.max(...numbers);
const min = Math.min(...numbers);

Math.max、Math.minとスプレッド演算子（...配列名）を使って、 最大値、最小値を取得できます。

配列同士の演算したい

left = [1, 2, 3];
right = [4, 5, 6];
const added = left.map((value, index) => value + right[index]);
const subtracted = left.map((value, index) => value - right[index]);
const multiplied = left.map((value, index) => value * right[index]);
const divided = left.map((value, index) => value / right[index]);
const modulo = left.map((value, index) => value % right[index]);
const powered = left.map((value, index) => Math.pow(value, right[index]));

配列同士の演算はビルトインされていないので、mapメソッドを使って自分で定義します。

function addLists(left, right) {
    if (left.length !== right.length) {
        throw new Error("Arrays must have the same length.");
    }
    return left.map((value, index) => value + right[index]);
}

それぞれ関数にしておくとよさそうです。

const arrays = [
    [1, 2, 3],
    [4, 5, 6],
    [7, 8, 9]
];
const result = arrays.reduce((left, right) => AddLists(left, right));
// step1. arrays[0] を初期値として使用
// step2. left=arrays[0], right=arrays[1] を計算
//    -> [5, 7, 9]
// step3. left=直前の結果, right=arrays[2] を計算
//    -> [12, 15, 18]

複数の配列を処理する場合reduceメソッドを利用すると簡潔にかけます。

リファレンス

• Array - JavaScript | MDN