Skip to content
  • Home
  • About
  • No Access
  • Privacy Policy
Bits of .NET
Bits of .NET
  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy

Bits of .NET

Daily micro-tips for C#, SQL, performance, and scalable backend engineering.

  • Asp.Net Core
  • C#
  • SQL
  • JavaScript
  • CSS
  • About
  • ErcanOPAK.com
  • No Access
  • Privacy Policy
JavaScript

JavaScript: Fix a Map Used as a Cache Growing Forever Because Object Keys Inserted Into It Are Compared by Reference, So Two Structurally Identical Keys Never Collide

- 09.11.26 - ErcanOPAK

⚡ Fix a Map Used as a Cache Growing Forever Because Object Keys Inserted Into It Are Compared by Reference, So Two Structurally Identical Keys Never Collide

A Map lets you use objects as keys, unlike a plain object which coerces every key to a string, which looks like exactly what you want for caching by some data shape. But Map key equality is SameValueZero, which for objects means reference identity, not structural equality — two separately created object instances with exactly the same properties and values are two distinct keys as far as a Map is concerned. A cache that builds a fresh lookup object on every call and uses it as a Map key never produces a hit, because every call constructs a brand-new object reference, so the Map just keeps accumulating entries that are each permanently unique, growing without bound while never actually deduplicating anything.

🔎 The Problem

const cache = new Map();

function getCached(userId, scope) {
  const key = { userId, scope };     // new object reference every call
  if (cache.has(key)) return cache.get(key);
  const value = computeExpensiveResult(userId, scope);
  cache.set(key, value);
  return value;
}

getCached(1, "reports");   // cache.size === 1
getCached(1, "reports");   // identical-looking key, but a DIFFERENT reference
                            // cache.has(key) is false - cache.size === 2

✅ Fix: Key by Value, Not by a Freshly Built Reference

  • Derive a stable primitive key — a string built from the relevant fields, like `${userId}:${scope}` — and use that as the Map key instead of an object literal, since primitive keys compare by value the way a cache lookup actually needs.
  • If the key genuinely needs to be a specific object for identity-based caching, reuse the same object reference across calls rather than constructing a new one each time, which usually means caching the object itself somewhere stable instead of rebuilding it inline.
  • Switch to a WeakMap when the key really is meant to be a long-lived object you want garbage-collected automatically, or add a periodic size check, so a mismatch like this at least bounds memory growth instead of letting it run unbounded.

🚨 Why This Is Dangerous

  • An ever-growing Map backing a “cache” that never actually caches anything is a slow memory leak that looks, from the outside, like the opposite of its real symptom — a feature billed as a performance optimization that’s silently consuming more memory with every call it was supposed to speed up.

A Map lets an object be a key, but it never promised two objects that merely look alike would count as the same one.

— JavaScript Tip

Related posts:

JavaScript: Understand Closures for Scope and Privacy

JavaScript: Understand Closures for Scope and Privacy

Silent JSON Parsing Failures

Silent JSON Parsing Failures

JS “Undefined Errors in Loops” — The Closure Trap

JS “Undefined Errors in Loops” — The Closure Trap

Views: 7

Post navigation

Photoshop: Fix the History Brush Painting Back the Wrong Snapshot After Switching Image Mode From RGB to CMYK Because the Mode Change Resets Which History State the Brush Points To
WordPress: Fix a Multisite Subsite Serving the Main Site’s Content Because a Shared Object Cache Key Collided Across Blog IDs

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

November 2026
M T W T F S S
 1
2345678
9101112131415
16171819202122
23242526272829
30  
« Oct    

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (977)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (854)
  • How to enable, disable and check if Service Broker is enabled on a database in SQL Server (653)
  • Add Constraint to SQL Table to ensure email contains @ (608)
  • Average of all values in a column that are not zero in SQL (570)
  • How to use Map Mode for Vertical Scroll Mode in Visual Studio (546)
  • Find numbers with more than two decimal places in SQL (475)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit
  • SQL Server: Fix ROW_NUMBER Ties Reordering Between Identical Runs
  • C#: Fix an Enum HasFlag Returning True for the Zero Value
  • WordPress: Fix Featured Images Vanishing After a CDN Migration
  • Photoshop: Fix Content-Aware Fill Smearing a Repeating Pattern
  • Asp.Net Core: Fix Antiforgery Tokens Rejected Behind a Reverse Proxy

Most Viewed Posts

  • How to make theater mode the default for Youtube (1,055)
  • Get the User Name and Domain Name from an Email Address in SQL (980)
  • How to add default value for Entity Framework migrations for DateTime and Bool (977)
  • Get the First and Last Word from a String or Sentence in SQL (857)
  • How to select distinct rows in a datatable in C# (854)

Recent Posts

  • C#: Fix a ConditionalWeakTable Entry Vanishing Too Soon
  • Docker: Fix a Stale COPY Layer After Editing .dockerignore
  • Photoshop: Fix a Pattern Overlay Scaling Wrong on a High-DPI File
  • SQL Server: Fix a Computed Column Index Skipped by Implicit Cast
  • HTML5: Fix a required Input Inside a Hidden Tab Blocking Submit

Social

  • ErcanOPAK.com
  • GoodReads
  • LetterBoxD
  • Linkedin
  • The Blog
  • Twitter
© 2026 Bits of .NET | Built with Xblog Plus free WordPress theme by wpthemespace.com