bitburner-src/utils/uiHelpers/removeChildrenFromElement.ts

import { isString } from "../helpers/isString";
import { getElementById } from "./getElementById";

/**
 * Clears out all children from the provided element.
 * If a string is passed in, it will treat it as an ID and search for the element to delete all children from.
 * @param el The element or ID of an element to remove all children from.
 */
export function removeChildrenFromElement(el: string | null | Element): void {
    if (el === null) {
        return;
    }

    try {
        const elem: HTMLElement | Element = (isString(el) ? getElementById(el as string) : el as Element);

        if (elem instanceof Element) {
            while (elem.firstChild !== null) {
                elem.removeChild(elem.firstChild);
            }
        }
    } catch (e) {
        // tslint:disable-next-line:no-console
        console.debug(e);

        return;
    }
}