توضیح:
این متد شبیه به متد foreach است با این تفاوت که مقدار بازگشتی آن یک آرایه جدید است که در صورت تغییر مقادیر آرایه اصلی در آرایه جدید تغییر پیدا می کند.
این تابع بر روی آرایه خالی کار نمیکند
این متد بعنوان ورودی می‌تواند به متد دیگر را فراخوانی کند.
نحوه نوشتن:
|
1 |
array.map(function(currentValue, index, arr), thisValue); |
پارامترها:
- مقدار currentValue: مقدار جاری المنت آرایه موردنظر(ضروری)
- مقدار index: اندیس المنت جاری.(اختیاری)
- مقدار arr: آرایه جدیدی که زیرمجموعه المنت جاری است.(اختیاری)
- مقدار thisValue: تعیین مقدار this در صورت استفاده در کد.در صورت استفاده از دستور this و عدم تعیین پارامتر آن مقدار undefined در نظر گرفته میشود.(اختیاری)
مقدار بازگشت:
آرایه جدید با تغییر المنت ها براساس تابع تعیین شده.
وضعیت پشتیبانی از مرورگرها:
| مرورگر Chrome | مرورگر Firefox | مرورگر Edge | مرورگر Safari | مرورگر Opera |
|---|---|---|---|---|
| همگی | همگی | همگی | همگی | همگی |
مثال:
|
1 2 3 4 5 6 7 8 9 10 11 12 |
const numbers = [65, 44, 12, 4]; const newArr = numbers.map(myFunction) function myFunction(num) { return num * 10; } /* 650 440 120 40 */ |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
const persons = [ {firstname : "amir", lastname: "javanmir"}, {firstname : "shahryar", lastname: "barati"}, {firstname : "ali", lastname: "aghaei"} ]; persons.map(getFullName); function getFullName(item) { return [item.firstname,item.lastname].join(" "); } /* amir javanmir shahryar barati ali aghaei */ |
|
1 2 3 4 5 6 7 8 |
const numbers = [4, 9, 16, 25]; const newArr = numbers.map(Math.sqrt); /* 2 3 4 5 */ |
