DEV Community

Cover image for Why `map()` Exists Everywhere
Amrishkhan Sheik Abdullah
Amrishkhan Sheik Abdullah

Posted on

Why `map()` Exists Everywhere

Most developers think map() is an array method.

It isn't.

Just like most developers think reduce() is an array method.

It isn't either.

In a previous article, I argued that reduce() has almost nothing to do with arrays.

Arrays are simply where most developers first encounter the idea.

The same thing is true for map().

Most developers learn it here:

const doubled = [1, 2, 3]
  .map(x => x * 2)

console.log(doubled)
// [2, 4, 6]
Enter fullscreen mode Exit fullscreen mode

Then they move on.

But something strange starts happening as your career progresses.

You begin seeing map() everywhere.

Not just in arrays.

In:

  • Promises
  • RxJS
  • React
  • Functional libraries
  • Streams
  • Option types
  • Result types
  • Immutable data structures

Different APIs.

Different libraries.

Different ecosystems.

Yet they all keep reinventing map().

Why?

Surely that can't be a coincidence.

The answer is that map() is not really an array operation.

It is a transformation pattern.

And once you understand that pattern, you start seeing it throughout software engineering.


The Weird Question Nobody Asks

Consider these examples.

Array:

const result = [1, 2, 3]
  .map(x => x * 2)
Enter fullscreen mode Exit fullscreen mode

Promise:

Promise.resolve(10)
  .then(x => x * 2)
Enter fullscreen mode Exit fullscreen mode

RxJS:

userStream.pipe(
  map(user => user.name)
)
Enter fullscreen mode Exit fullscreen mode

Option:

Option.some(10)
  .map(x => x * 2)
Enter fullscreen mode Exit fullscreen mode

These APIs were created by different people.

For different purposes.

At different times.

Yet they all contain the same operation.

Why?


What map() Actually Does

Most developers think:

map()
=
Loop over array
Enter fullscreen mode Exit fullscreen mode

That is not what map does.

The deeper idea is:

Take a value
Apply a transformation
Preserve the container
Enter fullscreen mode Exit fullscreen mode

Let's look at an array.

Input:

[1, 2, 3]
Enter fullscreen mode Exit fullscreen mode

Transformation:

x => x * 2
Enter fullscreen mode Exit fullscreen mode

Output:

[2, 4, 6]
Enter fullscreen mode Exit fullscreen mode

Notice something important.

The container stayed the same.

Array
↓
Transformation
↓
Array
Enter fullscreen mode Exit fullscreen mode

The values changed.

The structure did not.

That is the real abstraction.


map() Preserves Context

This is the part most tutorials never explain.

When you use:

array.map(...)
Enter fullscreen mode Exit fullscreen mode

the array remains an array.

const users = [
  { name: "John" },
  { name: "Sarah" }
]

const names = users.map(
  user => user.name
)
Enter fullscreen mode Exit fullscreen mode

Input:

Array<User>
Enter fullscreen mode Exit fullscreen mode

Output:

Array<String>
Enter fullscreen mode Exit fullscreen mode

The values changed.

The container remained.

That is what makes map() special.


Arrays Didn't Invent map()

Let's look at Promises.

Promise.resolve(10)
  .then(x => x * 2)
Enter fullscreen mode Exit fullscreen mode

Input:

Promise<Number>
Enter fullscreen mode Exit fullscreen mode

Output:

Promise<Number>
Enter fullscreen mode Exit fullscreen mode

Again:

Container
↓
Transformation
↓
Same Container
Enter fullscreen mode Exit fullscreen mode

The Promise remains a Promise.

Only the value inside changes.

This should feel familiar.

Because it is exactly what map() does.

In fact, many functional programming libraries literally implement Promise transformations as map().


RxJS Does The Same Thing

Let's look at Observables.

userStream.pipe(
  map(user => user.name)
)
Enter fullscreen mode Exit fullscreen mode

Input:

Observable<User>
Enter fullscreen mode Exit fullscreen mode

Output:

Observable<String>
Enter fullscreen mode Exit fullscreen mode

Again:

Container
↓
Transformation
↓
Same Container
Enter fullscreen mode Exit fullscreen mode

The Observable remains an Observable.

Only the data changes.

Same pattern.

Different environment.


The Pattern Behind Everything

At this point we have seen:

Array:

Array<A>
↓
map
↓
Array<B>
Enter fullscreen mode Exit fullscreen mode

Promise:

Promise<A>
↓
map
↓
Promise<B>
Enter fullscreen mode Exit fullscreen mode

Observable:

Observable<A>
↓
map
↓
Observable<B>
Enter fullscreen mode Exit fullscreen mode

Same shape.

Different container.

This is why map keeps appearing everywhere.

Because software is full of containers.

And containers frequently need transformations.


Real World Example: API Responses

Suppose an API returns:

const users = [
  {
    id: 1,
    name: "John"
  },
  {
    id: 2,
    name: "Sarah"
  }
]
Enter fullscreen mode Exit fullscreen mode

Most UIs only need:

const names = users.map(
  user => user.name
)

console.log(names)
Enter fullscreen mode Exit fullscreen mode

Output:

[
  "John",
  "Sarah"
]
Enter fullscreen mode Exit fullscreen mode

This is one of the most common uses of map().

Transform data.

Preserve structure.


Real World Example: UI Dropdowns

Backend response:

const countries = [
  {
    code: "AE",
    name: "UAE"
  },
  {
    code: "IN",
    name: "India"
  }
]
Enter fullscreen mode Exit fullscreen mode

UI needs:

const options = countries.map(
  country => ({
    label: country.name,
    value: country.code
  })
)
Enter fullscreen mode Exit fullscreen mode

Output:

[
  {
    label: "UAE",
    value: "AE"
  },
  {
    label: "India",
    value: "IN"
  }
]
Enter fullscreen mode Exit fullscreen mode

This is map at its best.


Real World Example: React Components

function UserList({ users }) {
  return (
    <ul>
      {
        users.map(user => (
          <li key={user.id}>
            {user.name}
          </li>
        ))
      }
    </ul>
  )
}
Enter fullscreen mode Exit fullscreen mode

React developers use map() every day.

But the underlying idea is still:

Data
↓
Transformation
↓
UI Representation
Enter fullscreen mode Exit fullscreen mode

Why map() Feels So Natural

Because most business applications are transformation engines.

Think about what software does.

Input:

Database Records
Enter fullscreen mode Exit fullscreen mode

Transform.

Output:

API Response
Enter fullscreen mode Exit fullscreen mode

Input:

API Response
Enter fullscreen mode Exit fullscreen mode

Transform.

Output:

UI State
Enter fullscreen mode Exit fullscreen mode

Input:

UI State
Enter fullscreen mode Exit fullscreen mode

Transform.

Output:

Rendered Components
Enter fullscreen mode Exit fullscreen mode

Most software is simply:

State
↓
Transformation
↓
State
Enter fullscreen mode Exit fullscreen mode

And map() embodies that idea.


The Hidden Relationship Between map() and reduce()

In the previous article, we discussed how reduce represents:

Current State
+
Input
=
Next State
Enter fullscreen mode Exit fullscreen mode

Map is different.

Map represents:

Value
↓
Transformation
↓
Value
Enter fullscreen mode Exit fullscreen mode

Reduce evolves state.

Map transforms values.

Together they describe a huge percentage of software.


Performance Considerations

Let's talk about the elephant in the room.

Many developers write:

array
  .map(...)
  .map(...)
  .map(...)
  .map(...)
Enter fullscreen mode Exit fullscreen mode

This is readable.

But it creates intermediate arrays.

Example:

const result = users
  .map(...)
  .map(...)
  .map(...)
Enter fullscreen mode Exit fullscreen mode

Internally:

Array
↓
Array
↓
Array
↓
Array
Enter fullscreen mode Exit fullscreen mode

Each step creates a new collection.

For small datasets:

No problem.

For large datasets:

Potential issue.


The Loop Comparison

This:

const result = []

for (const user of users) {
  result.push(
    user.name.toUpperCase()
  )
}
Enter fullscreen mode Exit fullscreen mode

is often:

  • Faster
  • Simpler
  • Easier to debug

So why not always use loops?

Because loops are usually less composable.

This is the tradeoff.

Loop
↓
Performance
Enter fullscreen mode Exit fullscreen mode

versus

Map
↓
Composability
Enter fullscreen mode Exit fullscreen mode

Neither is universally correct.

Context matters.


The Problem With Over-Chaining

This:

users
  .map(...)
  .filter(...)
  .map(...)
  .filter(...)
  .map(...)
Enter fullscreen mode Exit fullscreen mode

can become difficult to reason about.

Especially when transformations are complex.

At that point:

for...of
Enter fullscreen mode Exit fullscreen mode

might actually be clearer.

Senior engineering is not about choosing one pattern.

It is about choosing the right pattern.


Why Functional Developers Love map()

Because it is predictable.

Input:

Array<User>
Enter fullscreen mode Exit fullscreen mode

Output:

Array<UserDto>
Enter fullscreen mode Exit fullscreen mode

Input:

Promise<User>
Enter fullscreen mode Exit fullscreen mode

Output:

Promise<UserDto>
Enter fullscreen mode Exit fullscreen mode

Input:

Observable<User>
Enter fullscreen mode Exit fullscreen mode

Output:

Observable<UserDto>
Enter fullscreen mode Exit fullscreen mode

The container never changes.

Only the value changes.

That predictability makes software easier to compose.


The Scary Word: Functor

At this point, some FP developers will say:

Congratulations.

You just described a Functor.

And they're right.

A Functor is simply:

Something that can be mapped over.

That sounds intimidating.

But you've already been using Functors for years.

Arrays are Functors.

Promises are Functors.

Observables are Functors.

You already understand the concept.

You just didn't know the name.


Pros Of map()

1. Easy To Read

users.map(
  user => user.name
)
Enter fullscreen mode Exit fullscreen mode

Extremely clear.


2. Composable

Transformations can be chained.


3. Predictable

Container remains unchanged.


4. Encourages Declarative Code

You describe the transformation.

Not the mechanics.


5. Works Across Many Abstractions

Arrays.

Promises.

Observables.

Streams.

And many more.


Cons Of map()

1. Intermediate Allocations

Every map creates a new collection.


2. Can Become Over-Chained

Long pipelines become difficult to follow.


3. Not Always Fastest

Loops often outperform chained maps.


4. Can Hide Complexity

A small callback is great.

A 50-line callback is not.


5. Not Every Transformation Is A map()

Sometimes:

reduce()
Enter fullscreen mode Exit fullscreen mode

or

for...of
Enter fullscreen mode Exit fullscreen mode

is the better tool.


The Real Lesson

The biggest lesson I learned about map() was that it had very little to do with arrays.

Arrays merely introduced me to the idea.

The real idea was:

Container<Value>
↓
Transformation
↓
Container<NewValue>
Enter fullscreen mode Exit fullscreen mode

Once you understand that pattern, you start seeing map() everywhere.

In Promises.

In RxJS.

In React.

In functional programming.

In software architecture.

And suddenly the question changes.

Instead of asking:

How do I loop over this?
Enter fullscreen mode Exit fullscreen mode

you start asking:

How do I transform this value
while preserving its context?
Enter fullscreen mode Exit fullscreen mode

That shift in thinking is far more valuable than the map() function itself.


About The Author

Hi, I'm Amrish Khan.

I enjoy building developer tools, exploring software architecture, and writing about the deeper ideas behind everyday programming concepts.

I'm also building Aruvix — a growing ecosystem of local-first developer tools designed to process data directly in the browser without unnecessary uploads.

Here's a detailed blog on Aruvix: https://dev.to/amrishkhan05/aruvix-the-ultimate-offline-first-developer-toolkit-e0i

You can follow my work and thoughts here:

Portfolio: https://www.amrishkhan.dev

LinkedIn: https://www.linkedin.com/in/amrishkhan

GitHub: https://www.github.com/amrishkhan05

If you enjoyed this article, consider following for more deep dives into JavaScript, architecture, local-first software, and performance engineering.

Top comments (0)