サンプルコードで身につける: null合体演算子 ??

// ?? は左が null / undefined のときだけ右の値を使う
function pickMessage(savedMessage: string | null): string {
  return savedMessage ?? "メッセージはまだありません";
}

console.log(pickMessage("こんにちは")); // 値があるのでそのまま
console.log(pickMessage(null));          // null なので右の既定値

// 音量 0(消音)は有効な設定値
function pickVolume(savedVolume: number | null): number {
  return savedVolume ?? 50;
}

function pickVolumeBad(savedVolume: number | null): number {
  return savedVolume || 50; // 0 も「偽」なので置き換わってしまう
}

console.log(pickVolume(0));    // 0(消音設定が守られる)
console.log(pickVolumeBad(0)); // 50(消音のつもりが音が出るバグ)
console.log(pickVolume(null)); // 50(無いときだけ既定値)

type Commenter = {
  nickname?: string;
  contact?: { mail: string };
};

const userA: Commenter = { nickname: "Tar-kun" };
const userB: Commenter = {};

// ?. でたどって、最後に ?? で既定値を埋める
console.log(userA.nickname ?? "名無しさん");
console.log(userB.nickname ?? "名無しさん");
console.log(userA.contact?.mail ?? "メール未登録");
console.log(userB.contact?.mail ?? "メール未登録");

interface ReportOptions {
  pageSize?: number;
  showHeader?: boolean;
  fileLabel?: string;
}

// 省略された項目だけを既定値で埋めて、完全な設定を作る
function buildReportOptions(given: ReportOptions): { pageSize: number; showHeader: boolean; fileLabel: string } {
  return {
    pageSize: given.pageSize ?? 20,
    showHeader: given.showHeader ?? true, // false は有効な指定として残る
    fileLabel: given.fileLabel ?? "report",
  };
}

console.log(buildReportOptions({}));
console.log(buildReportOptions({ pageSize: 50, showHeader: false }));

// 設定は「個人 → チーム → アプリ既定値」の順で解決する
function resolveTimeout(personalSec: number | null, teamSec: number | null): number {
  return personalSec ?? teamSec ?? 30;
}

console.log(resolveTimeout(60, 15));     // 60(個人設定が最優先)
console.log(resolveTimeout(null, 15));   // 15(チーム設定に落ちる)
console.log(resolveTimeout(null, null)); // 30(アプリの既定値)
console.log(resolveTimeout(0, 15));      // 0(0 も有効な個人設定)