Function createCircularSafeReplacer

lib/utils.js:626–655

* Creates a circular-safe replacer function for JSON.stringify * @param {string[]} keysToSkip - Keys to skip during serialization to break circular references * @returns {Function} Replacer function for JSON.stringify

(keysToSkip = [])

 * @returns {Function} Replacer function for JSON.stringify
 */
function createCircularSafeReplacer(keysToSkip = []) {
  const seen = new WeakSet()
  const defaultSkipKeys = ['parent', 'tests', 'suite', 'root', 'runner', 'ctx']
  const skipKeys = new Set([...defaultSkipKeys, ...keysToSkip])

  return function (key, value) {
    // Skip specific keys that commonly cause circular references
    if (key && skipKeys.has(key)) {
      return undefined
    }

    // Coerce types that JSON.stringify can't handle natively
    if (typeof value === 'function') return `[Function: ${value.name || 'anonymous'}]`
    if (typeof value === 'bigint') return `${value.toString()}n`
    if (typeof value === 'symbol') return value.toString()
    if (value instanceof Error) return { name: value.name, message: value.message, stack: value.stack }

    if (value === null || typeof value !== 'object') {
      return value
    }

    // Handle circular references
    if (seen.has(value)) {
      return `[Circular Reference to ${value.constructor?.name || 'Object'}]`
    }

    seen.add(value)
    return value
  }
}

/**
 * Safely stringify an object, handling circular references