サンプルコードで身につける: 関数オーバーロード — 複数の呼び出し方を宣言する

// 呼び出し方の宣言を2つ並べる
function makeLabel(itemName: string): string;
function makeLabel(itemName: string, count: number): string;
// 実装は両方を受け止められる形で1つだけ書く
function makeLabel(itemName: string, count?: number): string {
  if (count !== undefined) {
    return itemName + " x " + count;
  }
  return itemName;
}

console.log(makeLabel("りんご"));
console.log(makeLabel("りんご", 3));
// makeLabel(); // どの宣言にも合わないのでエラー

// 1個なら 0 から end まで、2個なら start から end まで
function makeRange(end: number): number[];
function makeRange(startValue: number, end: number): number[];
function makeRange(a: number, b?: number): number[] {
  let startNum = 0;
  let endNum = a;
  if (b !== undefined) {
    startNum = a;
    endNum = b;
  }
  const resultList: number[] = [];
  for (let i = startNum; i < endNum; i = i + 1) {
    resultList.push(i);
  }
  return resultList;
}

console.log(makeRange(3));    // [0, 1, 2]
console.log(makeRange(2, 5)); // [2, 3, 4]

// 個数なしなら先頭の1件、個数ありなら配列を返す
function pickItems(items: string[]): string;
function pickItems(items: string[], count: number): string[];
// 実装の戻り値は any でまとめる(呼び出し側には宣言の型が見える)
function pickItems(items: string[], count?: number): any {
  if (count !== undefined) {
    return items.slice(0, count);
  }
  return items[0];
}

const topMember = pickItems(["sato", "suzuki", "tanaka"]); // string
const topTwo = pickItems(["sato", "suzuki", "tanaka"], 2); // string[]

console.log(topMember.toUpperCase()); // string のメソッドが使える
console.log(topTwo.length);           // 配列として扱える

function makeAddress(pref: string): string;
function makeAddress(pref: string, city: string): string;
function makeAddress(pref: string, city: string, street: string): string;
function makeAddress(pref: string, city?: string, street?: string): string {
  let address = pref;
  if (city !== undefined) {
    address = address + city;
  }
  if (street !== undefined) {
    address = address + street;
  }
  return address;
}

console.log(makeAddress("東京都"));
console.log(makeAddress("東京都", "千代田区"));
console.log(makeAddress("東京都", "千代田区", "1-1"));
// makeAddress("東京都", "千代田区", "1-1", "ビル名"); // 宣言にない形はエラー

// 宛先を省略する形と、宛先リストを渡す形を宣言する
function sendNotice(text: string): string;
function sendNotice(text: string, channels: string[]): string;
function sendNotice(text: string, channels?: string[]): string {
  let targets = "mail"; // 省略時の既定の宛先
  if (channels !== undefined) {
    targets = channels.join(", ");
  }
  return "[" + targets + "] " + text;
}

console.log(sendNotice("メンテナンスのお知らせ"));
console.log(sendNotice("障害が発生しました", ["mail", "chat", "sms"]));