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 Array.prototype.flat Not Flattening a Nested Array Returned From an Async Map Because the Outer Array Still Holds Unresolved Promises Instead of Arrays

- 06.11.26 - ErcanOPAK

⚡ JavaScript: Fix Array.prototype.flat Not Flattening a Nested Array Returned From an Async Map Because the Outer Array Still Holds Unresolved Promises Instead of Arrays

Array.prototype.map with an async callback doesn’t wait for each callback to resolve before moving to the next element — it immediately returns a Promise from every call, so the array map produces is an array of Promises, not an array of whatever your async function eventually resolves to. Calling flat() on that array sees exactly what’s there: a flat array of Promise objects, none of which are themselves arrays, so there’s nothing for flat() to flatten yet.

🔎 The Problem

const nested = items.map(async item => {
  const related = await fetchRelatedIds(item);
  return related; // resolves to an array, e.g. [1, 2, 3]
});

console.log(nested);
// [Promise, Promise, Promise] - NOT [[1,2,3], [4,5], ...]

const flat = nested.flat();
// still [Promise, Promise, Promise] - flat() sees Promises,
// not arrays, so there's nothing to flatten yet

✅ Fix: Await the Promises First, Then Flatten the Resolved Array

  • Await all the Promises first with Promise.all(nested) to get the actual array of arrays, and only call flat() on that resolved result.
  • Reach for flatMap only when your callback is synchronous; for an async callback there is no single built-in that both awaits and flattens in one call, so the explicit two-step pattern is the correct choice rather than something to work around.
  • Add a quick runtime check in development confirming no element of the mapped array is itself still a Promise right before any flat() or flatMap() call that might receive async-mapped input, so this mistake fails loudly in testing instead of silently returning pending Promises in production.

🚨 Why This Is Dangerous

  • Because nested.flat() doesn’t throw — it just returns an array of Promises that still looks array-shaped — this bug can pass code review and even casual testing if nobody happens to log or inspect an individual element, surfacing only once something downstream tries to use a value and gets a Promise object instead of real data.

map with an async callback gives you an array of promises to deal with, not an array of answers — flat() can only flatten what’s already there, and promises aren’t arrays.

— JavaScript Tip

Related posts:

Passing parameters to JavaScript files

Passing parameters to JavaScript files

JavaScript: Fix a parseInt() Call That Silently Stops at the First Non-Digit Character Instead of Th...

JavaScript: Fix a parseInt() Call That Silently Stops at the First Non-Digit Character Instead of Th...

JavaScript: Fix a ResizeObserver Callback Firing in an Infinite Loop Because It Resizes the Very Ele...

JavaScript: Fix a ResizeObserver Callback Firing in an Infinite Loop Because It Resizes the Very Ele...

Views: 8

Post navigation

The AI Prompt That Checks Your Feature Flags for a Stale One Still Gating Code a Previous Rollout Already Made Permanent
Ajax: Fix a Fetch Call Silently Reusing a Cached Response After a POST Because a Redirected GET Fallback Was Cacheable All Along

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 @ (609)
  • 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