## **Огляд**  
Функція `arrayToHashMap` призначена для перетворення масиву об''єктів у хеш-мапу (об''єкт), де ключами є значення певного поля (наприклад, `id`), а значеннями — самі об''єкти або їхні підмножини. Вона підтримує:  
✅ **Гнучкий вибір ключа** (не лише `id`)  
✅ **Фільтрація полів** (включення або виключення)  
✅ **Сумісність із старими версіями JavaScript**  
✅ **Обробка крайових випадків** (пусті масиви, відсутні ключі)  

Це ідеальне рішення для роботи з даними у фронтенд- та бекенд-додатках.  

---

## **Призначення**  
Часто виникає потреба швидко отримати доступ до елементів масиву за певним ключем (наприклад, `id`, `email`, `slug`). Наївний підхід із `Array.find()` має лінійну складність `O(n)`, тоді як хеш-мапа дає доступ `O(1)`.  

**Приклад використання:**  
- Перетворення списку товарів у мапу для швидкого пошуку  
- Створення кешу даних на клієнті  
- Оптимізація роботи з API-відповідями  

---

## **API документація**  

### **Синтаксис**  
```javascript
arrayToHashMap(array, options)
```  

### **Параметри**  
| Параметр | Тип | Обов''язковий? | Значення за замовчуванням | Опис |  
|----------|-----|--------------|------------------|------|  
| `array` | `Array` | Так | — | Вхідний масив об''єктів |  
| `options` | `Object` | Ні | `{}` | Налаштування перетворення |  
| `options.key` | `string` | Ні | `''id''` | Поле, яке використовується як ключ |  
| `options.pick` | `Array<string>` | Ні | Усі поля | Включає лише зазначені поля |  
| `options.omit` | `Array<string>` | Ні | Жодного | Виключає зазначені поля (пріоритет над `pick`) |  

### **Повертає**  
`Object` — хеш-мапа виду `{ [key]: object }`.  

---

## **Приклади**  

### **1. Базове використання**  
```javascript
const users = [
  { id: 1, name: ''Alice'', role: ''admin'' },
  { id: 2, name: ''Bob'', role: ''user'' }
];

const usersMap = arrayToHashMap(users);
// Результат:
// {
//   1: { id: 1, name: ''Alice'', role: ''admin'' },
//   2: { id: 2, name: ''Bob'', role: ''user'' }
// }
```  

### **2. Зміна ключа**  
```javascript
const products = [
  { sku: ''p1'', title: ''Phone'', price: 999 },
  { sku: ''p2'', title: ''Laptop'', price: 1499 }
];

const productsMap = arrayToHashMap(products, { key: ''sku'' });
// Результат:
// {
//   p1: { sku: ''p1'', title: ''Phone'', price: 999 },
//   p2: { sku: ''p2'', title: ''Laptop'', price: 1499 }
// }
```  

### **3. Вибір полів (`pick`)**  
```javascript
const orders = [
  { id: 101, userId: 1, total: 50, paid: true },
  { id: 102, userId: 2, total: 75, paid: false }
];

const ordersMap = arrayToHashMap(orders, { pick: [''id'', ''total''] });
// Результат:
// {
//   101: { id: 101, total: 50 },
//   102: { id: 102, total: 75 }
// }
```  

### **4. Виключення полів (`omit`)**  
```javascript
const posts = [
  { id: 1, title: ''Post 1'', content: ''...'', draft: false },
  { id: 2, title: ''Post 2'', content: ''...'', draft: true }
];

const postsMap = arrayToHashMap(posts, { omit: [''content'', ''draft''] });
// Результат:
// {
//   1: { id: 1, title: ''Post 1'' },
//   2: { id: 2, title: ''Post 2'' }
// }
```  

---

## **Чому це краще, ніж `Object.fromEntries`?**  
1. **Сумісність:** Працює навіть у старих браузерах (не вимагає ES2019+).  
2. **Гнучкість:** Підтримує `pick`/`omit` для фільтрації полів.  
3. **Безпека:** Ігнорує елементи без ключа (не ламає виконання).  
4. **Оптимізація:** Не створює проміжних масивів (як у `Object.fromEntries`).  

---

## **Код функції**
```javascript
/**
 * Converts an array of objects to a hash map with configurable key and field selection
 * @param {Array} array - Input array of objects
 * @param {Object} options - Configuration options
 * @param {string} [options.key=''id''] - Field name to use as hash key
 * @param {Array} [options.pick] - Fields to include (default: all)
 * @param {Array} [options.omit] - Fields to exclude (takes precedence over pick)
 * @returns {Object} Hash map of objects
 */
function arrayToHashMap(array, { 
  key = ''id'', 
  pick, 
  omit 
} = {}) {
  if (!Array.isArray(array)) return {};

  return array.reduce((acc, item) => {
    // Filter fields based on pick/omit options
    let resultItem = item;
    
    if (omit && Array.isArray(omit)) {
      resultItem = Object.keys(item).reduce((obj, field) => {
        if (!omit.includes(field)) {
          obj[field] = item[field];
        }
        return obj;
      }, {});
    }
    else if (pick && Array.isArray(pick)) {
      resultItem = pick.reduce((obj, field) => {
        if (item.hasOwnProperty(field)) {
          obj[field] = item[field];
        }
        return obj;
      }, {});
    }

    // Add to hash map
    if (item && item.hasOwnProperty(key)) {
      acc[item[key]] = resultItem;
    }
    
    return acc;
  }, {});
}
```

Імпорт в код:
```javascript
/**
 * @type {import(''./utils/arrayToHashMap'').arrayToHashMap}
 */
const { arrayToHashMap } = require(''./utils/arrayToHashMap'');
```

---

## **Висновок**  
Функція `arrayToHashMap` — це потужний інструмент для роботи з даними, який:  
🔹 **Прискорює пошук** (O(1) замість O(n))  
🔹 **Дає контроль над структурою** (`pick`/`omit`)  
🔹 **Працює всюди** (навіть у старих JS-рушіях)  

Додайте її до вашої бібліотеки утиліт, щоб спростити роботу з масивами!


Функція arrayToHashMap перетворює масив об'єктів у хеш-мапу для швидкого доступу за обраним ключем. Вона підтримує гнучкий вибір ключа, фільтрацію полів і сумісність зі старими версіями JavaScript. Це зручний інструмент для оптимізації роботи з даними як на фронтенді, так і на бекенді.

Функція `arrayToHashMap`: Універсальне перетворення масиву в хеш-мапу

Знайдіть статтю за темою наSpotlib🔎