Assert: Introduce strict boolean assertions.

docs/assert/false.md

@@ -0,0 +1,36 @@
+---
+layout: default
+title: false
+description: A boolean check. Passes if the first argument is false.
+categories:
+  - assert
+---
+
+## `false( state [, message ] )`
+
+A boolean check, inverse of `true()` equivalent to Chais's `assert.isFalse()`, and JUnit's `assertFalse()`. Passes if the first argument is false.
+
+| name               | description                          |
+|--------------------|--------------------------------------|
+| state              | Expression being tested              |
+| message (string)   | A short description of the assertion |
+
+### Description
+
+`false()` requires just one argument. If the argument evaluates to false, the assertion passes; otherwise, it fails. If a second message argument is provided, it will be displayed in place of the result.
+
+### Examples:
+
+```js
+QUnit.test( "false test", function( assert ) {
+  assert.false( false, "false succeeds" );
+
+  assert.false( "", "empty string fails" );
+  assert.false( NaN, "NaN fails" );
+  assert.false( null, "null fails" );
+  assert.false( undefined, "undefined fails" );
+  assert.false( true, "true fails" );
+  assert.false( 1, "1 fails" );
+  assert.false( "not-empty", "not-empty string fails" );
+});
+```

docs/assert/true.md

@@ -0,0 +1,37 @@
+---
+layout: default
+title: true
+description: A boolean check, equivalent to Chai's assert.isTrue() and JUnit's assertTrue(). Passes if the first argument is true.
+categories:
+  - assert
+redirect_from:
+  - "/true/"
+---
+
+## `true( state [, message ] )`
+
+A boolean check, equivalent to Chai's assert.true() and JUnit's assertTrue(). Passes if the first argument is `true`.
+
+| name               | description                          |
+|--------------------|--------------------------------------|
+| `state`            | Expression being tested              |
+| `message` (string) | A short description of the assertion |
+
+### Description
+
+The most basic assertion in QUnit, `true()` requires just one argument. If the argument evaluates to true, the assertion passes; otherwise, it fails. If a second message argument is provided, it will be displayed in place of the result.
+
+```js
+QUnit.test( "true test", function( assert ) {
+  assert.true( true, "true succeeds" );
+
+  assert.true( "non-empty", "non-empty string fails" );
+  assert.true( false, "false fails" );
+  assert.true( 0, "0 fails" );
+  assert.true( NaN, "NaN fails" );
+  assert.true( "", "empty string fails" );
+  assert.true( null, "null fails" );
+  assert.true( undefined, "undefined fails" );
+});
+```
+

src/assert.js

@@ -173,6 +173,38 @@ class Assert {
 		} );
 	}
 
+	true( result, message ) {
+		const isTrue = result === true;
+		if ( !message ) {
+			message = isTrue ?
+				"true" :
+				`failed, expected argument to be true, was: ${dump.parse( result )}`;
+		}
+
+		this.pushResult( {
+			result: isTrue,
+			actual: result,
+			expected: true,
+			message
+		} );
+	}
+
+	false( result, message ) {
+		const isFalse = result === false;
+		if ( !message ) {
+			message = isFalse ?
+				"false" :
+				`failed, expected argument to be false, was: ${dump.parse( result )}`;
+		}
+
+		this.pushResult( {
+			result: isFalse,
+			actual: result,
+			expected: false,
+			message
+		} );
+	}
+
 	equal( actual, expected, message ) {
 
 		// eslint-disable-next-line eqeqeq

test/main/assert.js

@@ -38,6 +38,22 @@ QUnit.test( "notOk", function( assert ) {
 	assert.notOk( NaN );
 } );
 
+QUnit.test( "true", function( assert ) {
+	function functionThatReturnsTrue() {
+		return true;
+	}
+	assert.true( true );
+	assert.true( functionThatReturnsTrue() );
+} );
+
+QUnit.test( "false", function( assert ) {
+	function functionThatReturnsFalse() {
+		return false;
+	}
+	assert.false( false );
+	assert.false( functionThatReturnsFalse() );
+} );
+
 QUnit.test( "equal", function( assert ) {
 	assert.equal( 1, 1 );
 	assert.equal( "foo", "foo" );