# Array.prototype.map 参考

URL: https://caijiao.org/reference/javascript/array-map
Source: docs/reference/javascript/array-map.md
Description: Array.prototype.map Reference，整理语法、参数、示例、返回值和常见错误，适合快速查询 JavaScript 写法。

Array.prototype.map Reference，整理语法、参数、示例、返回值和常见错误，适合快速查询 JavaScript 写法。

## 语法

```js
const result = array.map((item, index, array) => item);
```

## 参数

- `callback`：遍历数组时执行的函数，通常接收 item、index 和 array。
- `thisArg`：可选，指定 callback 内部的 this 值。

## 返回值

返回新数组、字符串或指定位置的元素；是否修改原数组取决于具体方法。

## 示例

```js
const list = [1, 2, 3];
const result = list.map((item) => item * 2);
console.log(result);
```

## 常见错误

- 在 `null` 或 `undefined` 上调用实例方法会抛出 TypeError。
- 回调里没有显式返回值时，结果可能变成 undefined 或空结果。

## 相关内容

- [JavaScript 教程](/javascript/)
- [JavaScript 问题库](/how-to/javascript/)
- [JSON Formatter](/tool/json-formatter)
- [JSON Validator](/tool/json-validator)