4 * Unit tests for the HTMLCheckMatrix
5 * @covers HTMLCheckMatrix
7 class HtmlCheckMatrixTest extends MediaWikiTestCase {
8 static private $defaultOptions = [
9 'rows' => [ 'r1', 'r2' ],
10 'columns' => [ 'c1', 'c2' ],
11 'fieldname' => 'test',
14 public function testPlainInstantiation() {
16 new HTMLCheckMatrix( [] );
17 } catch ( MWException $e ) {
18 $this->assertInstanceOf( 'HTMLFormFieldRequiredOptionsException', $e );
22 $this->fail( 'Expected MWException indicating missing parameters but none was thrown.' );
25 public function testInstantiationWithMinimumRequiredParameters() {
26 new HTMLCheckMatrix( self::$defaultOptions );
27 $this->assertTrue( true ); // form instantiation must throw exception on failure
30 public function testValidateCallsUserDefinedValidationCallback() {
32 $field = new HTMLCheckMatrix( self::$defaultOptions + [
33 'validation-callback' => function () use ( &$called ) {
39 $this->assertEquals( false, $this->validate( $field, [] ) );
40 $this->assertTrue( $called );
43 public function testValidateRequiresArrayInput() {
44 $field = new HTMLCheckMatrix( self::$defaultOptions );
45 $this->assertEquals( false, $this->validate( $field, null ) );
46 $this->assertEquals( false, $this->validate( $field, true ) );
47 $this->assertEquals( false, $this->validate( $field, 'abc' ) );
48 $this->assertEquals( false, $this->validate( $field, new stdClass ) );
49 $this->assertEquals( true, $this->validate( $field, [] ) );
52 public function testValidateAllowsOnlyKnownTags() {
53 $field = new HTMLCheckMatrix( self::$defaultOptions );
54 $this->assertInstanceOf( Message::class, $this->validate( $field, [ 'foo' ] ) );
57 public function testValidateAcceptsPartialTagList() {
58 $field = new HTMLCheckMatrix( self::$defaultOptions );
59 $this->assertTrue( $this->validate( $field, [] ) );
60 $this->assertTrue( $this->validate( $field, [ 'c1-r1' ] ) );
61 $this->assertTrue( $this->validate( $field, [ 'c1-r1', 'c1-r2', 'c2-r1', 'c2-r2' ] ) );
65 * This form object actually has no visibility into what happens later on, but essentially
66 * if the data submitted by the user passes validate the following is run:
67 * foreach ( $field->filterDataForSubmit( $data ) as $k => $v ) {
68 * $user->setOption( $k, $v );
71 public function testValuesForcedOnRemainOn() {
72 $field = new HTMLCheckMatrix( self::$defaultOptions + [
73 'force-options-on' => [ 'c2-r1' ],
81 $this->assertEquals( $expected, $field->filterDataForSubmit( [] ) );
84 public function testValuesForcedOffRemainOff() {
85 $field = new HTMLCheckMatrix( self::$defaultOptions + [
86 'force-options-off' => [ 'c1-r2', 'c2-r2' ],
94 // array_keys on the result simulates submitting all fields checked
95 $this->assertEquals( $expected, $field->filterDataForSubmit( array_keys( $expected ) ) );
98 protected function validate( HTMLFormField $field, $submitted ) {
99 return $field->validate(
101 [ self::$defaultOptions['fieldname'] => $submitted ]