assert interface: add nestedInclude and notNestedInclude

Author: zetamorph

lib/chai/interface/assert.js

@@ -1012,6 +1012,51 @@ module.exports = function (chai, util) {
  new Assertion(exp, msg, assert.notDeepInclude, true).not.deep.include(inc);
  };
 
+ /**
+ * ### .nestedInclude
+ * 
+ * Asserts that 'targetObject' includes 'nestedObject'. 
+ * Enables the use of dot- and bracket-notation for referencing nested properties.
+ * '[]' and '.' in property names can be escaped using double backslashes.
+ * 
+ * assert.nestedInclude({'.a': {'b': 'x'}}, {'\\.a.[b]': 'x'});
+ * assert.nestedInclude({'a': {'[b]': 'x'}}, {'a.\\[b\\]': 'x'});
+ * 
+ * @name nestedInclude
+ * @param {Object} targetObject
+ * @param {Object} nestedObject
+ * @param {String} message
+ * @namespace Assert
+ * @api public 
+ */ 
+
+ assert.nestedInclude = function (exp, inc, msg) {
+ new Assertion(exp, msg, assert.nestedInclude, true).nested.include(inc);
+ };
+
+ /**
+ * ### .notNestedInclude
+ * 
+ * Asserts that 'targetObject' does not include 'nestedObject'. 
+ * Enables the use of dot- and bracket-notation for referencing nested properties.
+ * '[]' and '.' in property names can be escaped using double backslashes.
+ * 
+ * assert.notNestedInclude({'.a': {'b': 'x'}}, {'\\.a.[b]': 'y'});
+ * assert.notNestedInclude({'a': {'[b]': 'x'}}, {'a.\\[b\\]': 'y'});
+ * 
+ * 
+ * @name notNestedInclude
+ * @param {Object} targetObject
+ * @param {Object} nestedObject
+ * @param {String} message
+ * @namespace Assert
+ * @api public 
+ */ 
+
+ assert.notNestedInclude = function (exp, inc, msg) {
+ new Assertion(exp, msg, assert.notNestedInclude, true).not.nested.include(inc);
+ };
+
  /**
  * ### .match(value, regexp, [message])
  *