format module

pprint

pprint(ss, values)

Pretty-print values passed to template strings.

Usage:

const { pprint } = Cu.import(
  "chrome://marionette/content/format.js", {}
);

let bool = {value: true};
pprint`Expected boolean, got ${bool}`;
=> 'Expected boolean, got [object Object] {"value": true}'

let htmlElement = document.querySelector("input#foo");
pprint`Expected element ${htmlElement}`;
=> 'Expected element <input id="foo" class="bar baz" type="input">'

pprint`Current window: ${window}`;
=> '[object Window https://www.mozilla.org/]'

truncate

truncate(strings, values)

Template literal that truncates string values in arbitrary objects.

Given any object, the template will walk the object and truncate any strings it comes across to a reasonable limit. This is suitable when you have arbitrary data and data integrity is not important.

The strings are truncated in the middle so that the beginning and the end is preserved. This will make a long, truncated string look like “X <…> Y”, where X and Y are half the number of characters of the maximum string length from either side of the string.

If the marionette.log.truncate preference is false, this function acts as a no-op.

Usage:

truncate`Hello ${"x".repeat(260)}!`;
// Hello xxx ... xxx!

Functions named toJSON or toString on objects will be called.