unexpected-htmllike-jsx-adapter

This is the JSX / ReactElement adapter for unexpected-htmllike

Usage

You need to instantiate a new instance of the adapter in order to use it. With the instance, you can set options (using setOptions({ ... })) to influence how certain things are returned to unexpected-htmllike.

var UnexpectedHtmlLike = require('unexpected-htmllike');
var JsxAdapter = require('unexpected-htmllike-jsx-adapter');

var adapter = new JsxAdapter();

var jsxHtmlLike = new UnexpectedHtmlLike(adapter);

// Now you can use jsxHtmlLike.diff(...) etc

Options

setOptions(object)

Available options:

• concatTextContent - (default false) set this to true, to concatenate text content items.
• convertToString - (default false) converts the content to strings. This is useful when comparing against a rendered result, where only strings are available, but you want to maintain the separate items
• convertMultipleRawToStrings - (default: false) - converts content to strings, when there is more than one content item. This is done specifically for comparing with rendered react elements, where the type is the original for single children, but is already converted to a string when there are multiple raw siblings
• includeKeyProp - (default false) includes the key prop in the returned attributes
• includeRefProp - (default false) includse the ref prop in the returned attributes

For example, with the following JSX

<button>
  Button was clicked {this.state.clickCount} times
</button>

The <button> will have 3 content items:

(Let's say this.state.clickCount === 10)

[ 'Button was clicked ', 10, ' times' ]

If you're diffing with unexpected-htmllike, these 3 content items must match exactly. When setting concatTextContent to true, this would result in a single string content item

[ 'Button was clicked 10 times' ]

If the convertToString option is true, the following is returned

[ 'Button was clicked ', '10', ' times' ]

The options take immediate effect, and can be changed per instance of the adapter (hence, you could, although not recommended), set the options differently for the actualAdapter and the expectedAdapter for unexpected-htmllike

License

MIT

v0.1.0

Initial version

v0.2.0

• Fixed convertToString option
• Added convertMultipleRawToStrings option to assist in comparing to rendered react components For multiple children, all raw content (e.g. strings, numbers) are converted to strings, but a single child (e.g. a single number), is left as the original type

v0.3.0

• Add support for expect.it() assertions in the content

v0.4.0

• Add support for iterators - thanks to @jkimbo for the failing test in unexpected-react, and @Lugribossk for reporting

v0.4.1

• Republish with added changelog and credits

v0.5.0

• Add classAttributeName, for compatibility with unexpected-htmllike v0.4.0

v0.5.1

• Fix nested children (thanks @sunesimonsen) e.g. For the component

  var list = [ <span>one</span>, <span>two</span> ];
  
  var component = (
    <Test>
      Hi
      {list}
    </Test>
  );

  The contents of the Test component are nested arrays ([ 'Hi', [ <span>one</span>, <span>two</span> ] ]). These are now supported

v1.0.0

Update React support to v0.14 and v15, drop support for React 0.13.x (thanks Christian Hoffmeister @choffmeister)

v1.0.1

Fix issue with multiple children, when one or more child is a generator (e.g. Immutable.List) Reported by @Raigen, under https://github.com/bruderstein/unexpected-react/issues/28

v1.0.2

Add React 16RC support as peerDep

v1.0.3

Add React 16 support as peerDep