zulip/static/js/dict.ts

export class Dict<V> {
    private _items: Map<string, V> = new Map();

    get(key: string): V | undefined {
        return this._items.get(this._munge(key));
    }

    set(key: string, value: V): V {
        this._items.set(this._munge(key), value);
        return value;
    }

    has(key: string): boolean {
        return this._items.has(this._munge(key));
    }

    del(key: string): void {
        this._items.delete(this._munge(key));
    }

    keys(): string[] {
        return [...this._items.keys()];
    }

    values(): V[] {
        return [...this._items.values()];
    }

    items(): [string, V][] {
        return [...this._items];
    }

    num_items(): number {
        return this._items.size;
    }

    is_empty(): boolean {
        return this._items.size === 0;
    }

    each(f: (v: V, k?: string) => void): void {
        this._items.forEach(f);
    }

    clear(): void {
        this._items.clear();
    }

    // Convert keys to strings and handle undefined.
    private _munge(key: string): string | undefined {
        if (key === undefined) {
            blueslip.error("Tried to call a Dict method with an undefined key.");
            return undefined;
        }

        if (typeof key !== 'string') {
            blueslip.error("Tried to call a Dict method with a non-string.");
            key = (key as object).toString();
        }

        return key;
    }
}