Property assertions

The following methods analyze the components of an entity, rather than the entity as a whole. As with entity assertions, property assertions can be negated with not and maybe (see core selectors and modifiers).

.with.properties

Recursively asserts over the expected object's properties.

The following example demonstrates several ways of making these assertions.

  Expect(viewModel).with.properties({
    username: /exampleuser\d+/,
    email: e => Expect(e).to.match(/\w+\@example.com/),
    academicInfo: {
      gpa: g => g > 3.5,
      type: "Graduate Student"
    }
  });

Each property can be a:

1. lambda returning a boolean pass/fail
2. void lambda
3. lambda using a complete FluentExpect sentence (as opposed to one with dangling core functions)
4. regular expression
5. value whose type is the same as the original property. In this case, a strict equals (===) will be performed.
6. nested dictionary of property assertions for that (complex) value's properties

.with.allProperties

Like .with.properties, except that it requires (at compile time) all properties to be specified, not only a subset. Failure to do so will result in compile-time errors. This helps ensure that your tests stay up-to-date with any model changes.

.with.keys

Verifies that the expected object contains the given keys, with no assumptions made about the corresponding values.

Expect(viewModel).with.keys(["one", "two", "three");

// .without is synonymous with .not.with
Expect(viewModel).without.keys(["four", "five", "six"]);

.with.elements

Verifies that the expected array contains the given elements.

Expect(results).with.elements([4,5,6]);

// .without is synonymous with .not.with
Expect(viewModel).without.elements([1,2,3]);