type StringifyParams = Parameters<typeof JSON.stringify>;

/**
 * Converts a JavaScript value to a JavaScript Object Notation (JSON) string with protection against thrown errors.
 *
 * @param value A JavaScript value, usually an object or array, to be converted.
 * @param replacer The JSON.stringify() `replacer` argument.
 * @param space Adds indentation, white space, and line break characters to the return-value JSON text to make it easier
 *   to read.
 * @returns The JSON string. If the operation fails, an error string value is returned (no exception thrown).
 */
export const stringify = (value: any, replacer?: StringifyParams[1], space?: StringifyParams[2]): string => {
    try {
        return JSON.stringify(value, replacer, space);
    } catch (err) {
        const error = err as Error;

        return '[Cannot display object: ' + error.message + ']';
    }
};