QUnit.dump.parse()

Categories: Configuration and Utilities

QUnit.dump.parse( data )

Description: Advanced and extensible data dumping for JavaScript

This method does string serialization by parsing data structures and objects. It parses DOM elements to a string representation of their outer HTML. By default, nested structures will be displayed up to five levels deep. Anything beyond that is replaced by [object Object] and [object Array] placeholders.

If you need more or less output, change the value of QUnit.dump.maxDepth, representing how deep the elements should be parsed.

Note: This method used to be in QUnit.jsDump, which was changed to QUnit.dump. The old property will be removed in QUnit 3.0.

Examples:

The following example is used on grunt-contrib-qunit to send messages from QUnit to PhantomJS.

1
2
3
4
5
6
7
8
9
 
QUnit.log(function( obj ) {
 
  // Parse some stuff before sending it.
  var actual = QUnit.dump.parse( obj.actual );
  var expected = QUnit.dump.parse( obj.expected );
 
  // Send it.
  sendMessage( "qunit.log", obj.result, actual, expected, obj.message, obj.source );
});

This example shows the parsed output of a simple JS object with a DOM reference.

1
2
3
4
5
6
 
var qHeader = document.getElementById( "qunit-header" ),
  parsed = QUnit.dump.parse( qHeader );
 
console.log( parsed );
 
// Logs: "<h1 id=\"qunit-header\"></h1>"

Limit output to one or two levels

1
2
3
4
5
6
7
8
9
10
11
12
13
 
var input = {
  parts: {
    front: [],
    back: []
  }
};
QUnit.dump.maxDepth = 1;
console.log( QUnit.dump.parse( input ) );
// Logs: { "parts": [object Object] }
 
QUnit.dump.maxDepth = 2;
console.log( QUnit.dump.parse( input ) );
// Logs: { "parts": { "back": [object Array], "front": [object Array] } }