1. module json-stringify-safe
   1. function json-stringify-safe (obj, replacer, spaces, cycleReplacer)
   2. function json-stringify-safe.getSerialize (replacer, cycleReplacer)

module json-stringify-safe

function json-stringify-safe (obj, replacer, spaces, cycleReplacer)

• description and source-code

  function stringify(obj, replacer, spaces, cycleReplacer) {
    return JSON.stringify(obj, serializer(replacer, cycleReplacer), spaces)
  }

• example usage

  n/a

function json-stringify-safe.getSerialize (replacer, cycleReplacer)

• description and source-code

  function serializer(replacer, cycleReplacer) {
    var stack = [], keys = []
  
    if (cycleReplacer == null) cycleReplacer = function(key, value) {
      if (stack[0] === value) return "[Circular ~]"
      return "[Circular ~." + keys.slice(0, stack.indexOf(value)).join(".") + "]"
    }
  
    return function(key, value) {
      if (stack.length > 0) {
        var thisPos = stack.indexOf(this)
        ~thisPos ? stack.splice(thisPos + 1) : stack.push(this)
        ~thisPos ? keys.splice(thisPos, Infinity, key) : keys.push(key)
        if (~stack.indexOf(value)) value = cycleReplacer.call(this, key, value)
      }
      else stack.push(value)
  
      return replacer == null ? value : replacer.call(this, key, value)
    }
  }

• example usage

  ...
  The default `decycler` function returns the string `'[Circular]'`.
  If, for example, you pass in `function(k,v){}` (return nothing) then it
  will prune cycles.  If you pass in `function(k,v){ return {foo: 'bar'}}`,
  then cyclical objects will always be represented as `{"foo":"bar"}` in
  the result.
  
  ```
  stringify.getSerialize(serializer, decycler)
  ```
  
  Returns a serializer that can be used elsewhere.  This is the actual
  function that's passed to JSON.stringify.
  
  **Note** that the function returned from `getSerialize` is stateful for now, so
  do **not** use it more than once.
  ...