unexpected/documentation/assertions/object/to-have-properties.md

Extensible BDD assertion toolkit

Assert presence of properties in an object.

```javascript
expect({ a: 'a', b: { c: 'c' }, d: 'd' }, 'to have properties', ['a', 'b']);
expect({ a: 'a', b: { c: 'c' }, d: 'd' }, 'to have properties', {
    a: 'a',
    b: { c: 'c' }
});
expect([ 'a', { c: 'c' }, 'd' ], 'to have properties', {
    1: { c: 'c' },
    2: 'd'
});
```

Using the `own` flag, you can assert presence of an own properties.

```javascript
expect({ a: 'a', b: { c: 'c' }, d: 'd' }, 'to have own properties', ['a', 'b']);
expect({ a: 'a', b: { c: 'c' }, d: 'd' }, 'to have own properties', {
    a: 'a',
    b: { c: 'c' }
});
```

In case of a failing expectation you get the following output:

```javascript
expect({ a: 'f00', b: 'bar' }, 'to have own properties', {
  a: 'foo',
  c: 'baz'
});
```

```output
expected { a: 'f00', b: 'bar' } to have own properties { a: 'foo', c: 'baz' }

{
  a: 'f00', // should equal 'foo'
            // -f00
            // +foo
  b: 'bar',
  c: undefined // should equal 'baz'
}
```

This assertion can be negated using the `not` flag:

```javascript
expect({ a: 'a', b: { c: 'c' }, d: 'd' }, 'not to have properties', ['k', 'l']);
expect(Object.create({ a: 'a', b: 'b' }), 'not to have own properties', ['a', 'b']);
```

In case of a failing expectation you get the following output:

```javascript
expect({ a: 'a', b: { c: 'c' }, d: 'd' }, 'not to have properties', ['b', 'd']);
```

```output
expected { a: 'a', b: { c: 'c' }, d: 'd' } not to have properties [ 'b', 'd' ]
```