第16章 索引签名

案例16:索引签名 — 动态键字符串对象

题目:设计一个商品库存登记器,允许用任意字符串作为键(如"SKU-001")动态添加商品数量,并支持批量更新与统计总库存。

设计思路

使用TypeScript索引签名定义动态对象接口,键为字符串,值为数字。通过类封装添加、更新和求和逻辑,避免直接操作对象,保证类型安全。

interface Inventory {
  [sku: string]: number;
}

class StockManager {
  private items: Inventory = {};

  set(sku: string, qty: number): void {
    this.items[sku] = qty;
  }

  add(sku: string, qty: number): void {
    this.items[sku] = (this.items[sku] ?? 0) + qty;
  }

  total(): number {
    return Object.values(this.items).reduce((sum, q) => sum + q, 0);
  }

  snapshot(): Inventory {
    return { ...this.items };
  }
}

// 使用示例
const stock = new StockManager();
stock.set("SKU-001", 10);
stock.add("SKU-001", 5);
stock.set("SKU-002", 20);
console.log(stock.snapshot());
console.log("总库存:", stock.total());
运行验证:执行 ts-node index.ts,输出 { 'SKU-001': 15, 'SKU-002': 20 } 和 总库存: 35。
注意事项:索引签名会覆盖同接口内其他属性的类型要求,若需固定属性(如 name: string),需确保其类型兼容数字签名的值类型。
成功要点:合理使用 ?? 空值合并处理首次添加,利用 Object.values 与 reduce 实现高效统计,快照返回副本防止外部篡改。