node-stream/lib/modifiers/stringify.js

Utilities for consuming, creating and manipulating node streams.

var map = require('./map.js');

/**
 * Creates a new stream where every element in the source stream
 * is converted to a string by using `JSON.stringify`.
 *
 * @static
 * @since    1.1.0
 * @category Modifiers
 *
 * @returns  {Stream.Transform} - Transform stream.
 *
 * @example
 *
 * // stringify every element in an object stream so it can be
 * // piped to a non-object stream.
 * objStream
 *   .pipe(nodeStream.stringify())
 *   .pipe(process.stdout);
 */
function stringify() {

  return map(function (chunk, next) {
    var stringified;

    try {
      stringified = JSON.stringify(chunk);
    } catch (e) {
      return next(e);
    }

    return next(null, stringified);
  });
}

module.exports = stringify;