مرجع نگاشت (Map Reference)
اینجا «مرجع نگاشت (Map Reference)» است. نگاشت «کلید/مقدار» نگه می دارد. کلید می تواند هر نوعی باشد. ترتیب ورود هم حفظ می شود.
روش های اصلی در مرجع نگاشت
در این مرجع، متدها و ویژگی های Map فهرست شده اند. توضیحات کوتاه و دقیق هستند.
new Map(): ساخت یک Map جدید.set(key, value): مقداردهی برای یک کلید.get(key): گرفتن مقدار یک کلید.has(key): بررسی وجود کلید.delete(key): حذف یک زوج کلید/مقدار.clear(): پاک کردن همه ی ورودی ها.size: تعداد عناصر نگاشت.forEach(cb): اجرای تابع روی هر ورودی.entries(): پیمایش جفت های [کلید، مقدار].keys(): پیمایش کلیدها.values(): پیمایش مقدارها.groupBy(): گروه بندی آرایه بر اساس خروجیِ تابع.
نمونه ی کوتاه: ساخت، افزودن، خواندن
با چند خط کد، کلید و مقدار را ست و گت کن. «پیمایش (Iteration)» یعنی حرکت روی داده ها با حلقه.
// Create a Map
const scores = new Map();
// Add items
scores.set("ali", 18);
scores.set("sara", 20);
// Read item
const top = scores.get("sara");
// Check existence
const hasAli = scores.has("ali");
// Count items
const count = scores.size;
پیمایش ورودی ها و پاکسازی
با entries()، keys() و values() پیمایش کن. سپس با delete() یا clear() پاکسازی کن.
// Iterate entries
for (const [k, v] of scores.entries()) {
console.log(k);
console.log(v);
}
// Iterate keys
for (const k of scores.keys()) {
console.log(k);
}
// Iterate values
for (const v of scores.values()) {
console.log(v);
}
// Remove one
scores.delete("ali");
// Remove all
scores.clear();
گام های عملی سریع
- یک Map بساز و دو مقدار ست کن.
- با get مقدار یک کلید را بخوان.
- با has وجود کلید را چک کن.
- با entries روی زوج ها پیمایش کن.
- با clear همه چیز را پاک کن.
جمع بندی سریع
- مرجع نگاشت همه ی متدها را فهرست می کند.
- کلید می تواند هر نوعی باشد.
- ترتیب ورود حفظ می شود.
- size تعداد عناصر را می دهد.
- entries/keys/values برای پیمایش هستند.
برای جزئیات هر متد، به مرجع نگاشت مراجعه کن. همچنین نگاشت ها (Maps) و متدهای نگاشت را ببین. اگر نیاز داشتی، WeakMap را مرور کن.