TypeScript中强制Map包含特定值并安全访问的技巧：非空断言

type SupportedUnits = Map<string, BigNumber>;

class CurrencyTools {
  private supportedUnits: SupportedUnits;

  constructor(supportedUnits: SupportedUnits) {
    this.supportedUnits = supportedUnits;
  }

  getMainUnit(): string {
    const denomination = Array.from(this.supportedUnits.keys()).find(
      (key) => this.supportedUnits.get(key)?.toString() === '1'
    );
    // 这里denomination的类型是 string | undefined
    // 因此需要使用 || '' 来处理 undefined 的情况，以满足返回类型 string
    return denomination || '';
  }
}

type SupportedUnits = Map<string, BigNumber>;

class CurrencyTools {
  private supportedUnits: SupportedUnits;

  constructor(supportedUnits: SupportedUnits) {
    this.supportedUnits = supportedUnits;
  }

  getMainUnit(): string {
    const denomination = Array.from(this.supportedUnits.keys()).find(
      (key) => this.supportedUnits.get(key)?.toString() === '1'
    );
    // 使用非空断言操作符 '!'
    // 告诉TypeScript，denomination在这里绝不会是 undefined
    return denomination!; // 返回类型现在是 string
  }
}

import { BigNumber } from 'bignumber.js'; // 假设BigNumber是一个外部库

/**
 * 定义支持的单位类型，键为单位名称（string），值为其相对于主单位的比率（BigNumber）。
 */
type SupportedUnits = Map<string, BigNumber>;

/**
 * CurrencyTools 类提供货币单位相关的工具方法。
 * 构造函数接收一个 Map，其中应包含至少一个值为 '1' 的主单位。
 */
class CurrencyTools {
  private supportedUnits: SupportedUnits;

  /**
   * 构造函数
   * @param supportedUnits - 一个 Map，键是单位名称，值是它们相对于主单位的比率。
   *                         要求：此Map中必须包含至少一个值为 '1' 的条目作为主单位。
   */
  constructor(supportedUnits: SupportedUnits) {
    this.supportedUnits = supportedUnits;

    // 在构造函数中添加运行时检查，以确保主单位存在，
    // 从而增强非空断言的合理性。如果不存在，则抛出错误。
    if (!Array.from(this.supportedUnits.values()).some(val => val.toString() === '1')) {
        throw new Error("Supported units map must contain a main unit with ratio '1'.");
    }
  }

  /**
   * 获取主单位的名称。
   * 基于构造函数中的保证，此方法总是能找到一个主单位。
   * @returns 主单位的名称（string）。
   */
  getMainUnit(): string {
    // 查找值为 '1' 的键，即主单位的名称
    const denomination = Array.from(this.supportedUnits.keys()).find(
      (key) => this.supportedUnits.get(key)?.toString() === '1'
    );

    // 使用非空断言操作符 '!'，因为我们确信 denomination 绝不会是 undefined
    // （基于构造函数中的检查或外部业务逻辑保证）
    return denomination!;
  }
}

// 示例用法
const units = new Map<string, BigNumber>();
units.set('USD', new BigNumber(1));
units.set('Cents', new BigNumber(0.01));

const currencyTool = new CurrencyTools(units);
console.log(`Main unit: ${currencyTool.getMainUnit()}`); // 输出: Main unit: USD

// 尝试创建一个没有主单位的 CurrencyTools (会抛出错误)
try {
    const invalidUnits = new Map<string, BigNumber>();
    invalidUnits.set('Cents', new BigNumber(0.01));
    new CurrencyTools(invalidUnits);
} catch (error: any) {
    console.error(`Error: ${error.message}`); // 输出: Error: Supported units map must contain a main unit with ratio '1'.
}