Merge 923382f into 7bfd8b4

README.md

@@ -320,6 +320,11 @@ Assert that `actual > expected`.
 Assert that `actual >= expected`.
 
 
+### proclaim.hasName( fn, expected, [message] )
+
+Assert that `fn.name === expected`.
+
+
 Why?
 ----
 

lib/proclaim.js

@@ -300,6 +300,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);
+		}
+	};
+
 
 	// Aliases
 	// -------

test/unit/lib/proclaim.js

@@ -1114,6 +1114,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'));
+			});
+
+		});
+
 	});
 
 }());