Logo dévoreur 2 code

Mastering Map data structure in JavaScript

Fabien Schlegel

Fabien Schlegel

6 min

published: 11/22/2023

Cover image for Mastering Map data structure in JavaScript

Data structures are at the heart of software development, and JavaScript offers a variety of options to meet different needs.

Among them, the Map data structure stands out for its flexibility and power.

It's important to understand its value by examining its use and advantages. In this way, we can integrate it judiciously and effectively into our projects.

Understanding Map in JavaScript

What is a Map data structure?

In JavaScript, a Map is a collection of key-value pairs, where each key and value can be of any data type.

Unlike objects, Maps preserve the insertion order of elements, offering an orderly way of storing and accessing information.

Differences between Map and Object

Although Maps share similarities with Objects in terms of storing data in key-value pairs, there are some essential distinctions.

Keys in a Map can be of any type, including objects, whereas keys in a JavaScript object are limited to strings and symbols.

Maps provide built-in methods for performing common operations, making them more flexible in certain situations.

Advantages of using Maps

There are several advantages to using Maps. They enable more flexible data management, and offer practical methods for everyday operations.

Maps solve some of the problems associated with objects, particularly when it comes to key comparison.

Basic operations with Maps

Maps in JavaScript offer a range of fundamental operations that allow you to manipulate data efficiently.

Adding elements

Adding elements to a Map is a simple operation. Use the set method to associate a key with a value. The flexibility of key and value types makes Maps an interesting choice for storing heterogeneous elements.

// Example of adding elements to a Map
let myMap = new Map();

myMap.set('key1', 'value1');
myMap.set(42, 'a value associated with a number');
myMap.set({ fruit: 'apple' }, 'value associated with an object');

// The Map now contains three elements

Retrieving elements

Retrieving elements from a Map is done using the get method. This method returns the value associated with a specific key, offering a fast and efficient way of accessing data.

// Example of retrieving elements from a Map
console.log(myMap.get('key1')); // Display 'value1'
console.log(myMap.get(42)); // Displays 'a value associated with a number'.

Deleting elements

To remove an element from a map, use the delete method. This maintains the Map's structure while adjusting its content to suit your needs.

// Example of deleting elements from a Map
console.log(myMap); // The Map no longer contains the element associated with 'key1'.

Checking the existence of a key

Use the has method to check whether a specific key exists in the Map. This makes it easier to manage conditional operations based on the presence or absence of a key.

// Example of checking the existence of a key in a map
console.log(myMap.has('key1')); // Display false (the key has been deleted)
console.log(myMap.has(42)); // Display true (key still exists)

Advanced uses of maps

Beyond basic operations, JavaScript Maps offer advanced features that make them particularly powerful for data manipulation.

Iterating through a Map

Maps provide built-in methods for iterating through their elements. Using forEach is an elegant way of traversing the set of key-value pairs, opening the door to flexible data manipulation.

// Example of iteration through a Map
myMap.forEach((value, key) => {
  console.log(`Key: ${key}, Value: ${value}`);

Maps as an alternative to objects

Maps can be a more flexible alternative to objects in certain situations. For example, keys can be complex objects, which is not possible with JavaScript objects.

// Using objects as keys in a Map
let obj1 = { id: 1 };
let obj2 = { id: 2 };

let objMap = new Map();
objMap.set(obj1, 'Data associated with obj1');
objMap.set(obj2, 'Data associated with obj2');

console.log(objMap.get(obj1)); // Display 'Data associated with obj1'.

Combining with other data structures

Maps can be effectively combined with other data structures. For example, using objects as values in a Map offers an organized way of managing complex information.

// Combining Maps with other data structures
let nestedMap = new Map([
    new Map([
      ['subkey1', 'value1'],
      ['subkey2', 'value2'],
    new Map([
      ['subkey3', 'value3'],
      ['subkey4', 'value4'],

console.log(nestedMap.get('key1').get('subkey1')); // Display 'value1'.

By exploring these advanced uses, you can adapt Maps to more complex scenarios and enrich your development toolbox.

Performance and best practices with JavaScript Maps

JavaScript Maps are powerful data structures, but to get the most out of them, it's crucial to understand their relative performance compared to objects, and to follow good usage practices.

Performance of Maps relative to objects

Maps and objects perform differently, depending on the context in which they are used.

In general, Maps are faster for adding and deleting elements, while objects can be faster for direct access to specific properties.

It is advisable to choose the structure according to the predominant operations in your application.

// Performance measurement: Addition of a large number of elements
let startMap = performance.now();
let mapTest = new Map();

for (let i = 0; i < 1000000; i++) {
  mapTest.set(i, `Value ${i}`);

let endMap = performance.now();
console.log(`Time for Map: ${endMap - startMap} milliseconds`);

let startObj = performance.now();
let objTest = {};

for (let i = 0; i < 1000000; i++) {
  objTest[i] = `Value ${i}`;

let endObj = performance.now();
console.log(`Time for Object: ${endObj - startObj} milliseconds`);

Best practices for using Maps

To optimize your use of Maps, follow these best practices:

a. Choose wisely between Map and Object

  • Use a Map when keys can be of various types, or when the order of insertion is important.
  • Opt for an object when keys are strings or symbols and direct access is crucial.

b. Give preference to set and get methods

  • Use set and get methods to manipulate data in the Map, rather than working directly with properties.

c. Avoid excessive serialization

  • Avoid serializing a Map using JSON.stringify if data retrieval is critical, as this does not preserve key types.

d. Pay attention to memory

  • Maps can consume more memory than objects, so keep this in mind when handling large amounts of data.

By following these best practices, you can fully exploit the power of Maps while ensuring optimum performance in your JavaScript applications.

Advantages of Maps over objects

JavaScript Maps have several advantages over object structures, making them suitable for specific scenarios. Here are some of the key advantages of Maps over objects:

  1. Varied key types: Maps allow a variety of data types to be used as keys, including objects, functions and other primitives. In contrast, traditional JavaScript objects only accept strings or symbols as keys.
  2. Insertion order preserved: Maps preserve the insertion order of elements. This means that the order in which key-value pairs are added is maintained, which can be crucial in certain scenarios where sequence is important.
  3. Easy iteration: Maps offer built-in methods for iterating through their elements. The forEach method enables cleaner, more direct iteration than with objects, where it is necessary to use for...in or Object.keys() loops.
  4. Easy management of object keys: Maps manage objects as keys in a more predictable way. In an object, object keys are automatically converted to strings, whereas in a Map, object keys are treated separately, preserving their integrity.
  5. Dedicated methods: Maps provide dedicated methods for common operations such as adding (set), retrieving (get), deleting (delete), and checking the existence of a key (has). These methods simplify data manipulation compared with object syntax.
  6. Better performance for dynamic operations: In some cases, Maps can outperform objects, particularly for dynamic operations such as frequent addition and deletion of elements.

It's important to note that the choice between Map and object depends on the specific context of use. Objects are still suitable for many scenarios, particularly when keys are strings and the order of insertion is not crucial. Maps offer a powerful alternative for situations where the above-mentioned advantages are required.

Related Articles

Cover image of the post

How to Regex in Javascript

Want to write more efficient and effective JavaScript code? Understanding how regex works is a must. Our article covers the basics of regex to guide you through the process of creating flexible patterns for manipulating and validating strings.

Read the post

6 min
Cover image of the post

JavaScript - the Reduce method

Discover everything you need to know about the reduce method in JavaScript. This advanced guide will teach you how to use it, its tricks, and concrete examples to improve your JavaScript development expertise.

Read the post

6 min