← 返回首页
Map.prototype.forEach() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. 개발자를 위한 웹 기술
  2. JavaScript
  3. JavaScript 참고서
  4. 표준 내장 객체
  5. Map
  6. Map.prototype.forEach()
Theme
  • OS default
  • Light
  • Dark
한국어
Remember language Learn more

This page was translated from English by the community. Learn more and join the MDN Web Docs community.

View in English Always switch to English

Map.prototype.forEach()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015년 7월.

Map 인스턴스의 forEach() 메서드는 이 Map 객체의 키/값 쌍마다 각각 제공된 함수를 삽입되었던 순서대로 실행합니다.

In this article

시도해 보기

function logMapElements(value, key, map) { console.log(`m[${key}] = ${value}`); } new Map([ ["foo", 3], ["bar", {}], ["baz", undefined], ]).forEach(logMapElements); // Expected output: "m[foo] = 3" // Expected output: "m[bar] = [object Object]" // Expected output: "m[baz] = undefined"

구문

js
forEach(callbackFn) forEach(callbackFn, thisArg)

매개변수

callbackFn

맵의 각 항목에 대해 실행할 함수입니다. 이 함수는 다음 인수를 사용하여 호출됩니다.

value

각 반복의 값입니다.

key

각 반복의 키입니다.

map

반복되는 Map 입니다.

thisArg Optional

callbackFn을 실행하고 있을 때 this로 사용하는 값.

반환 값

없음 (undefined).

설명

forEach 메서드는 실제로 존재하는 맵의 각 키에 대해 제공된 callback을 한 번씩 실행합니다. 삭제된 키에 대해서는 호출되지 않습니다. 그러나 값은 존재하지만 undefined값일 경우에는 callback이 실행됩니다.

callback은 인자 3개와 함께 호출됩니다.

  • 항목의 value
  • 항목의 key
  • 순회하고 있는 Map 객체

thisArg가 forEach의 매개 변수로 제공되면 호출 시 this 값으로 사용하기 위해 callback에 전달됩니다. 그렇지 않으면 undefined 값이 this 값으로 사용되도록 전달됩니다. callback이 궁극적으로 관찰할 수 있는 this 값은 함수가 보는 this를 결정하기 위한 일반적인 규칙에 따라 결정됩니다.

forEach가 완료되기 전에 삭제했다가 다시 추가한 경우를 제외하고 각 값은 한 번씩 방문합니다. 방문하기 전에 삭제된 값에 대해서는 callback이 호출되지 않습니다. forEach가 완료되기 전에 추가된 새 값은 나중에 방문합니다.

예제

Map 객체의 내용을 출력하기

다음 코드는 Map 객체에서 각 요소의 내용을 한 줄의 로그로 남깁니다.

js
function logMapElements(value, key, map) { console.log(`map.get('${key}') = ${value}`); } new Map([ ["foo", 3], ["bar", {}], ["baz", undefined], ]).forEach(logMapElements); // Logs: // "map.get('foo') = 3" // "map.get('bar') = [object Object]" // "map.get('baz') = undefined"

명세서

Specification
ECMAScript® 2027 Language Specification
# sec-map.prototype.foreach

브라우저 호환성

Enable JavaScript to view this browser compatibility table.

같이 보기

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 2025년 2월 11일 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. 표준 내장 객체
  2. Map
  3. 생성자
    1. Map() 생성자
  4. 정적 메서드
    1. Map.groupBy()
  5. 정적 속성
    1. Map[@@species]
  6. 인스턴스 메서드
    1. Map.prototype.clear()
    2. Map.prototype.delete()
    3. Map.prototype.entries()
    4. Map.prototype.forEach()
    5. Map.prototype.get()
    6. getOrInsert()
    7. getOrInsertComputed()
    8. Map.prototype.has()
    9. Map.prototype.keys()
    10. Map.prototype.set()
    11. Map.prototype.values()
    12. Map.prototype[@@iterator]()
  7. 인스턴스 속성
    1. Map.prototype.size
  8. 상속
  9. Object/Function
  10. 정적 메서드
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toSource()
    5. Function.prototype[@@hasInstance]()
  11. 정적 속성
    1. Function: displayName
    2. Function.prototype.length
    3. Function: name
    4. Function
    5. Function.arguments
    6. Function.prototype.caller
  12. 인스턴스 메서드
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  13. 인스턴스 속성
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.