wiki.techinc.nl/tests/phpunit/unit/includes/htmlform/HTMLCheckMatrixTest.php
Thiemo Kreuz e4272518f7 tests: Replace PHPUnit's loose assertEquals(false) with assertFalse()
assertEquals( false, … ) still succeeds when the actual value is 0, null,
an empty string, even an empty array. All these should be reported as a
failure, I would argue.

Note this patch previously also touched assertSame( false ). I reverted
these. The only benefit would have been consistency within this codebase,
but there is no strict reason to prefer one over the other. assertFalse()
and assertSame( false ) are functionally identical.

Change-Id: Ic5f1c7d504e7249002d3184520012e03313137b4
2019-10-04 00:30:36 +00:00

104 lines
3.2 KiB
PHP

<?php
/**
* @covers HTMLCheckMatrix
*/
class HTMLCheckMatrixTest extends MediaWikiUnitTestCase {
private static $defaultOptions = [
'rows' => [ 'r1', 'r2' ],
'columns' => [ 'c1', 'c2' ],
'fieldname' => 'test',
];
public function testPlainInstantiation() {
try {
new HTMLCheckMatrix( [] );
} catch ( MWException $e ) {
$this->assertInstanceOf( HTMLFormFieldRequiredOptionsException::class, $e );
return;
}
$this->fail( 'Expected MWException indicating missing parameters but none was thrown.' );
}
public function testInstantiationWithMinimumRequiredParameters() {
new HTMLCheckMatrix( self::$defaultOptions );
$this->assertTrue( true ); // form instantiation must throw exception on failure
}
public function testValidateCallsUserDefinedValidationCallback() {
$called = false;
$field = new HTMLCheckMatrix( self::$defaultOptions + [
'validation-callback' => function () use ( &$called ) {
$called = true;
return false;
},
] );
$this->assertFalse( $this->validate( $field, [] ) );
$this->assertTrue( $called );
}
public function testValidateRequiresArrayInput() {
$field = new HTMLCheckMatrix( self::$defaultOptions );
$this->assertFalse( $this->validate( $field, null ) );
$this->assertFalse( $this->validate( $field, true ) );
$this->assertFalse( $this->validate( $field, 'abc' ) );
$this->assertFalse( $this->validate( $field, new stdClass ) );
$this->assertEquals( true, $this->validate( $field, [] ) );
}
public function testValidateAllowsOnlyKnownTags() {
$field = new HTMLCheckMatrix( self::$defaultOptions );
$this->assertInstanceOf( Message::class, $this->validate( $field, [ 'foo' ] ) );
}
public function testValidateAcceptsPartialTagList() {
$field = new HTMLCheckMatrix( self::$defaultOptions );
$this->assertTrue( $this->validate( $field, [] ) );
$this->assertTrue( $this->validate( $field, [ 'c1-r1' ] ) );
$this->assertTrue( $this->validate( $field, [ 'c1-r1', 'c1-r2', 'c2-r1', 'c2-r2' ] ) );
}
/**
* This form object actually has no visibility into what happens later on, but essentially
* if the data submitted by the user passes validate the following is run:
* foreach ( $field->filterDataForSubmit( $data ) as $k => $v ) {
* $user->setOption( $k, $v );
* }
*/
public function testValuesForcedOnRemainOn() {
$field = new HTMLCheckMatrix( self::$defaultOptions + [
'force-options-on' => [ 'c2-r1' ],
] );
$expected = [
'c1-r1' => false,
'c1-r2' => false,
'c2-r1' => true,
'c2-r2' => false,
];
$this->assertEquals( $expected, $field->filterDataForSubmit( [] ) );
}
public function testValuesForcedOffRemainOff() {
$field = new HTMLCheckMatrix( self::$defaultOptions + [
'force-options-off' => [ 'c1-r2', 'c2-r2' ],
] );
$expected = [
'c1-r1' => true,
'c1-r2' => false,
'c2-r1' => true,
'c2-r2' => false,
];
// array_keys on the result simulates submitting all fields checked
$this->assertEquals( $expected, $field->filterDataForSubmit( array_keys( $expected ) ) );
}
protected function validate( HTMLFormField $field, $submitted ) {
return $field->validate(
$submitted,
[ self::$defaultOptions['fieldname'] => $submitted ]
);
}
}