Updated example for 'matches'

index.js

@@ -245,9 +245,9 @@ exports['in'] = function(values) {
 
 /**
  * Check if one field matches another
- * @param  {String} Value of field
- * @param  {String} field Field to match
- * @param   {Object} attributes All of the data
+ * @param attr {String} - name of field to validate - e.g "ConfirmNewPassword"
+ * @param val {String} input value of field to compare match - e.g data.NewPassword
+ * @param data {Object} the whole data object (model)
  * @return {Boolean}
  */
 exports.matches = function(attr) {

test/tests.js

@@ -199,12 +199,17 @@ describe('Validation Methods', function(){
   });
 
   it('should validate the if a value matches another value', function(){
-    var fn = methods.matches('foo');
-    fn('bar', { foo: 'bar' }).should.be.true;
-    fn('bar', { foo: 'foo' }).should.be.false;
-    fn(null, { foo: 'bar' }).should.be.false;
-    fn('', { foo: 'bar' }).should.be.false;
-    fn(undefined, { foo: 'bar' }).should.be.false;
+    // model
+    var data = {
+      NewPassword: 'eggplant' // < the value we're comparing to
+    };
+
+    var fn = methods.matches('NewPassword');
+    fn('eggplant', data).should.be.true;
+    fn('celery', data).should.be.false;
+    fn(null, data).should.be.false;
+    fn('', data).should.be.false;
+    fn(undefined, data).should.be.false;
   });
 
   it('should validate if a value is made up of only numbers or not', function(){