Add helper method for testing function is named correctly (#56)

* Add helper method for testing function is named correctly

* fix linting issues

* ignore line as it is used only in really old js engines

* Update proclaim.js

README.md

@@ -348,6 +348,11 @@ Assert that `obj[property]` is not enumerable.
 
 Assert that `obj[property]` is enumerable.
 
+### proclaim.hasName( fn, expected, [message] )
+
+Assert that `fn.name === expected`.
+
+
 Why?
 ----
 

lib/proclaim.js

@@ -312,6 +312,16 @@
 		}
 	};
 
+	var functionsHaveNames = (function foo() { }).name === 'foo';
+	proclaim.hasName = function(fn, expected, msg) {
+		if (functionsHaveNames) {
+			proclaim.strictEqual(fn.name, expected, msg);
+		} else {
+			/* istanbul ignore next */
+			proclaim.equal(Function.prototype.toString.call(fn).match(/function\s*([^\s]*)\s*\(/)[1], expected, msg);
+		}
+	};
+
 	// Assert that a function has the expected number of arguments
 	proclaim.arity = function(fn, expected, msg) {
 		proclaim.isFunction(fn, msg);

test/unit/lib/proclaim.js

@@ -1160,6 +1160,31 @@
 
 		});
 
+		describe('.hasName()', function() {
+
+			it('should be a function', function() {
+				assert.isFunction(proclaim.hasName);
+			});
+
+			it('should not throw when called with a function that has the same name as the expected value', function() {
+				assert.doesNotThrow(callFn(proclaim.hasName, function foo() {}, 'foo'));
+			});
+
+			it('should throw when called with a value that is not a function', function() {
+				assert.throws(callFn(proclaim.hasName, 1, 'foo'));
+				assert.throws(callFn(proclaim.hasName, {}, 'foo'));
+				assert.throws(callFn(proclaim.hasName, false, 'foo'));
+				assert.throws(callFn(proclaim.hasName, [], 'foo'));
+				assert.throws(callFn(proclaim.hasName, /./, 'foo'));
+			});
+
+			it('should throw when called with a value that is a function that has a different name than the expected value', function() {
+				assert.throws(callFn(proclaim.hasName, function() {}, 'foo'));
+				assert.throws(callFn(proclaim.hasName, function bar() {}, 'foo'));
+			});
+
+		});
+
 		describe('.arity()', function() {
 
 			it('should be a function', function() {