Function dispose

src/platform/common/utils/lifecycle.ts:40–57

(arg: T | Iterable<T> | undefined)

export function dispose<T extends IDisposable>(disposables: ReadonlyArray<T>): ReadonlyArray<T>;
// eslint-disable-next-line @typescript-eslint/no-explicit-any
export function dispose<T extends IDisposable>(arg: T | Iterable<T> | undefined): any {
    if (Iterable.is(arg)) {
        for (const d of arg) {
            if (d) {
                try {
                    d.dispose();
                } catch (e) {
                    console.warn(`dispose() failed for ${d}`, e);
                }
            }
        }

        return Array.isArray(arg) ? [] : arg;
    } else if (arg) {
        arg.dispose();
        return arg;
    }
}

/**
 * Combine multiple disposable values into a single {@link IDisposable}.