JavaScript Array map()

Definicja i użycie

map() Metoda tworzy nową tablicę z wynikami wywołania funkcji dla każdego elementu tablicy.

map() Metoda wywołuje dostarczoną funkcję dla każdego elementu tablicy w kolejności.

Komentarz:map() Nie wykona funkcji dla elementów tablicy bez wartości.

Komentarz:map() Nie zmienia oryginalnej tablicy.

Przykład

Przykład 1

Zwraca tablicę ze wszystkimi pierwiastkami kwadratowymi wartości z oryginalnej tablicy:

var numbers = [4, 9, 16, 25];
var x = numbers.map(Math.sqrt);
document.getElementById("demo").innerHTML = x;

Spróbuj sam

Przykład 2

Zmnoż wszystkie wartości w tablicy przez 10:

var numbers = [65, 44, 12, 4];
var newarray = numbers.map(myFunction)
function myFunction(num) {
  return num * 10;
}
document.getElementById("demo").innerHTML = newarray;;

Spróbuj sam

Przykład 3

Pobierz pełne imiona każdego członka tablicy:

var persons = [
  {firstname : "Malcom", lastname: "Reynolds"},
  {firstname : "Kaylee", lastname: "Frye"},
  {firstname : "Jayne", lastname: "Cobb"}
];
function getFullName(item) {
  var fullname = [item.firstname,item.lastname].join(" ");
  return fullname;
}
function myFunction() {
  document.getElementById("demo").innerHTML = persons.map(getFullName);
}

Spróbuj sam

Gramatyka

array.map(function(currentValue, index, arr), thisValue)

Wartość parametru

Parametry Opis
function(currentValue, index, arr) Wymagane. Funkcja, która jest uruchamiana dla każdego elementu tablicy.

Parametry funkcji:

Parametry Opis
currentValue Wymagane. Wartość bieżącego elementu.
index Opcjonalnie. Indeks tablicy bieżącego elementu.
arr Opcjonalnie. Obiekt tablicy, do którego należy bieżący element.
thisValue

Opcjonalnie. Wartość, która ma być przekazana jako wartość "this" do funkcji.

Jeśli ten parametr jest pusty, wartość "undefined" zostanie przekazana jako jej wartość "this".

Szczegóły techniczne

Wartość zwracana: Tablica, która zawiera wyniki wywołania podanej funkcji dla każdego elementu oryginalnej tablicy.
Wersja JavaScript: ECMAScript 5

Obsługa przeglądarek

Liczby w tabeli wskazują pierwszą wersję przeglądarki, która w pełni obsługuje tę metodę.

Wszystkie przeglądarki obsługują tę metodę w pełni map() Metoda:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Wsparcie 9.0 Wsparcie Wsparcie Wsparcie Wsparcie

Strony związane

Tutorial:Tablica JavaScript

Tutorial:Const tablicy JavaScript

Tutorial:Metody tablicy JavaScript

Tutorial:Sortowanie tablicy JavaScript

Tutorial:Iteracja tablicy JavaScript