ts-data-forge/dist/others/unknown-to-string.d.mts

[](https://www.npmjs.com/package/ts-data-forge) [](https://www.npmjs.com/package/ts-data-forge) [![License](https://img.shields.

/**
 * Converts an unknown value to its string representation in a type-safe manner.
 *
 * This function handles all JavaScript types and provides consistent string
 * conversion with proper error handling for edge cases like circular
 * references. Unlike naive toString() calls, this function never throws and
 * handles all value types gracefully.
 *
 * **Type conversion rules:**
 *
 * - Strings: returned as-is
 * - Numbers, booleans, bigints: converted via toString()
 * - Symbols: converted to their description string
 * - Functions: converted to their string representation
 * - null: returns "null" (not "null" from JSON)
 * - undefined: returns "undefined"
 * - Objects: JSON stringified (with optional pretty printing)
 *
 * @param value - The unknown value to convert to string
 * @param options - Optional configuration for the conversion
 * @param options.prettyPrintObject - If true, objects are formatted with
 *   2-space indentation
 * @returns The string representation of the value. For circular references or
 *   non-serializable objects, returns an error message string
 *
 *   **Error Handling:** Circular references and non-serializable objects return
 *   descriptive error messages instead of throwing
 * @see JSON.stringify - Underlying serialization for objects
 */
export declare const unknownToString: (value: unknown, options?: Partial<Readonly<{
    prettyPrintObject: boolean;
}>>) => string;
//# sourceMappingURL=unknown-to-string.d.mts.map