JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 22327
  • Score
    100M100P100Q140638F
  • License MIT

colorful diffs for javascript objects

Package Exports

  • difflet

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (difflet) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

difflet

Create colorful diffs for javascript objects.

example

string.js

var difflet = require('difflet');

var s = difflet.compare({ a : 2, c : 5 }, { a : 3, b : 4 });
process.stdout.write(s);

output:

colorful output

colors.js

var diff = require('difflet')({ indent : 2 });

var prev = {
    yy : 6,
    zz : 5,
    a : [1,2,3],
    fn : 'beep',
    c : { x : 7, z : 3 }
};

var next = {
    a : [ 1, 2, "z", /beep/, new Buffer(3) ],
    fn : function qqq () {},
    b : [5,6,7],
    c : { x : 8, y : 5 }
};

diff(prev, next).pipe(process.stdout);

output:

colorful output

green for inserts, blue for updates, red for deletes

methods

var difflet = require('difflet')

var diff = difflet(opts={})

Create a difflet from optional options opts.

With opts.start(type, stream) and opts.stop(type, stream), you can write custom handlers for all the types of differences: 'inserted', 'updated', and 'deleted'. By default green is used for insertions, blue for updates, and red for deletions.

If opts.indent is set, output will span multiple lines and opts.indent spaces will be used for leading whitespace.

If opts.comma === 'first' then commas will be placed at the start of lines.

Setting opts.comment to true will turn on comments with the previous contents like this:

Setting opts.deepEqual allows a different equality function to be used. By default deep-is is used.

object comments

diff(prev, next)

Return a stream with the colorful changes between objects prev and next.

diff.compare(prev, next)

Return a string with the colorful changes between prev and next.

difflet.compare(prev, next)

Return a string with the colorful changes between prev and next with the default options.

install

With npm do:

npm install difflet

test

With npm do:

npm test

license

Copyright (C) 2012, 2013 James Halliday mail@substack.net

Licensed under the MIT license, see LICENSE for details.