能否为JavaScript原始字符串添加带缓存的hashCode方法？

核心结论 #

JavaScript没有内置的builtInHashCode()函数，标准ECMAScript规范中未提供这类API。针对你遇到的字符串无法添加属性缓存哈希、WeakMap不支持原始类型键的问题，以下是几种可行方案：

方案1：使用Map作为缓存（最直接） #

Map支持将原始类型字符串作为键，完全适配你的需求。只需将WeakMap替换为Map即可正常运行：

declare global {
  interface String {
    hashCode(): number
  }
}

const hashes = new Map<string, number>() // 替换为Map
String.prototype.hashCode = function (this: string): number {
  let hash = hashes.get(this)
  if (hash == undefined) {
    console.log('calculating hash')
    hash = this.length // 替换为你的复杂哈希计算逻辑
    hashes.set(this, hash)
  }
  return hash
}

console.log('hi'.hashCode()) // 输出：calculating hash、2
console.log('hi'.hashCode()) // 直接输出：2（无需重复计算）

优缺点

• 优点：实现简单，完全满足哈希缓存需求，调用逻辑和你原本的代码一致。
• 缺点：Map不会自动回收缓存项，若场景中会生成大量临时字符串，可能导致内存占用过高。可通过手动调用hashes.clear()或hashes.delete(key)清理不再需要的缓存。

方案2：WeakRef + FinalizationRegistry（自动回收缓存） #

如果需要缓存项随字符串引用释放自动回收，可结合ES2021引入的WeakRef和FinalizationRegistry实现弱缓存：

declare global {
  interface String {
    hashCode(): number
  }
}

const hashCache = new Map<string, { hash: number; ref: WeakRef<object> }>()
const registry = new FinalizationRegistry((key: string) => {
  hashCache.delete(key)
})

String.prototype.hashCode = function (this: string): number {
  const existing = hashCache.get(this)
  if (existing) {
    // 检查关联的虚拟对象是否还存在
    if (existing.ref.deref()) {
      return existing.hash
    } else {
      hashCache.delete(this)
    }
  }
  console.log('calculating hash')
  const hash = this.length // 替换为你的复杂哈希计算逻辑
  // 创建虚拟对象用于WeakRef追踪
  const dummyObj = {}
  hashCache.set(this, { hash, ref: new WeakRef(dummyObj) })
  registry.register(dummyObj, this)
  return hash
}

let s = "test"
console.log(s.hashCode()) // 输出：calculating hash、4
console.log(s.hashCode()) // 直接输出：4

s = null // 解除字符串引用，JS引擎会在合适时机自动清理缓存项

优缺点

• 优点：缓存项会随字符串引用释放自动回收，避免内存泄漏。
• 缺点：实现复杂，且缓存清理时机由JS引擎决定，无法保证即时性。

内容的提问来源于stack exchange，提问作者Alex Craft