@playkit-js/playkit-js/src/utils/multi-map.ts

[](https://github.com/kaltura/playkit-js/actions/workflows/run_canary.yaml) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.

/**
 * A simple multimap template.
 * @constructor
 * @struct
 * @template T
 */
class MultiMap<K, T> {
  private _map: Map<K, T[]>;

  constructor() {
    /** @private {!Object.<K, !Array.<T>>} */
    this._map = new Map();
  }

  /**
   * Add a key, value pair to the map.
   * @param {K} key -
   * @param {T} value  -
   * @returns {void}
   */
  public push(key: K, value: T): void {
    if (this._map.has(key)) {
      const list = this._map.get(key);
      if (Array.isArray(list)) {
        list.push(value);
        this._map.set(key, list);
      }
    } else {
      this._map.set(key, [value]);
    }
  }

  /**
   * Set an array of values for the key, overwriting any previous data.
   * @param {K} key -
   * @param {!Array.<T>} values -
   * @returns {void}
   */
  public set(key: K, values: T[]): void {
    this._map.set(key, values);
  }

  /**
   * Check for a key.
   * @param {K} key -
   * @return {boolean} true if the key exists.
   */
  public has(key: K): boolean {
    return this._map.has(key);
  }

  /**
   * Get a list of values by key.
   * @param {K} key -
   * @return {Array.<T>} or null if no such key exists.
   */
  public get(key: K): Array<T> {
    const list = this._map.get(key);
    // slice() clones the list so that it and the map can each be modified
    // without affecting the other.
    return list ? list.slice() : [];
  }

  /**
   * Get a list of all values.
   * @returns {!Array.<T>} -
   */
  public getAll(): T[] {
    let list: T[] = [];
    for (const value of this._map.values()) {
      list = list.concat(value);
    }
    return list;
  }

  /**
   * Remove a specific value, if it exists. If there are no more values to the key, the key is removed
   * @param {K} key -
   * @param {T} value -
   * @returns {void}
   */
  public remove(key: K, value: T): void {
    if (!this._map.has(key)) return;
    const list = this._map.get(key);
    if (Array.isArray(list)) {
      for (let i = 0; i < list.length; ++i) {
        if (list[i] === value) {
          list.splice(i, 1);
          --i;
        }
      }
      if (list.length === 0) {
        this._map.delete(key);
      }
    }
  }

  /**
   * Get all keys from the multimap.
   * @return {!Array.<K>}
   */
  // eslint-disable-next-line no-undef
  public keys(): Iterator<K> {
    return this._map.keys();
  }

  /**
   * Clear all keys and values from the multimap.
   * @returns {void}
   */
  public clear(): void {
    this._map.clear();
  }
}
export {MultiMap};