XmlTest.php

Go to the documentation of this file.

<?php

class XmlTest extends MediaWikiTestCase {

    protected function setUp() {
        parent::setUp();

        $langObj = Language::factory( 'en' );
        $langObj->setNamespaces( [
            -2 => 'Media',
            -1 => 'Special',
            0 => '',
            1 => 'Talk',
            2 => 'User',
            3 => 'User_talk',
            4 => 'MyWiki',
            5 => 'MyWiki_Talk',
            6 => 'File',
            7 => 'File_talk',
            8 => 'MediaWiki',
            9 => 'MediaWiki_talk',
            10 => 'Template',
            11 => 'Template_talk',
            100 => 'Custom',
            101 => 'Custom_talk',
        ] );

        $this->setMwGlobals( [
            'wgLang' => $langObj,
            'wgUseMediaWikiUIEverywhere' => false,
        ] );
    }

    public function testExpandAttributes() {
        $this->assertNull( Xml::expandAttributes( null ),
            'Converting a null list of attributes'
        );
        $this->assertEquals( '', Xml::expandAttributes( [] ),
            'Converting an empty list of attributes'
        );
    }

    public function testExpandAttributesException() {
        $this->setExpectedException( 'MWException' );
        Xml::expandAttributes( 'string' );
    }

    public function testElementOpen() {
        $this->assertEquals(
            '<element>',
            Xml::element( 'element', null, null ),
            'Opening element with no attributes'
        );
    }

    public function testElementEmpty() {
        $this->assertEquals(
            '<element />',
            Xml::element( 'element', null, '' ),
            'Terminated empty element'
        );
    }

    public function testElementInputCanHaveAValueOfZero() {
        $this->assertEquals(
            '<input name="name" value="0" />',
            Xml::input( 'name', false, 0 ),
            'Input with a value of 0 (bug 23797)'
        );
    }

    public function testElementEscaping() {
        $this->assertEquals(
            '<element>hello &lt;there&gt; you &amp; you</element>',
            Xml::element( 'element', null, 'hello <there> you & you' ),
            'Element with no attributes and content that needs escaping'
        );
    }

    public function testEscapeTagsOnly() {
        $this->assertEquals( '&quot;&gt;&lt;', Xml::escapeTagsOnly( '"><' ),
            'replace " > and < with their HTML entitites'
        );
    }

    public function testElementAttributes() {
        $this->assertEquals(
            '<element key="value" <>="&lt;&gt;">',
            Xml::element( 'element', [ 'key' => 'value', '<>' => '<>' ], null ),
            'Element attributes, keys are not escaped'
        );
    }

    public function testOpenElement() {
        $this->assertEquals(
            '<element k="v">',
            Xml::openElement( 'element', [ 'k' => 'v' ] ),
            'openElement() shortcut'
        );
    }

    public function testCloseElement() {
        $this->assertEquals( '</element>', Xml::closeElement( 'element' ), 'closeElement() shortcut' );
    }

    public function testDateMenu() {
        $curYear = intval( gmdate( 'Y' ) );
        $prevYear = $curYear - 1;

        $curMonth = intval( gmdate( 'n' ) );

        $nextMonth = $curMonth + 1;
        if ( $nextMonth == 13 ) {
            $nextMonth = 1;
        }

        $this->assertEquals(
            '<label for="year">From year (and earlier):</label> ' .
                '<input id="year" maxlength="4" size="7" type="number" value="2011" name="year"/> ' .
                '<label for="month">From month (and earlier):</label> ' .
                '<select name="month" id="month" class="mw-month-selector">' .
                '<option value="-1">all</option>' . "\n" .
                '<option value="1">January</option>' . "\n" .
                '<option value="2" selected="">February</option>' . "\n" .
                '<option value="3">March</option>' . "\n" .
                '<option value="4">April</option>' . "\n" .
                '<option value="5">May</option>' . "\n" .
                '<option value="6">June</option>' . "\n" .
                '<option value="7">July</option>' . "\n" .
                '<option value="8">August</option>' . "\n" .
                '<option value="9">September</option>' . "\n" .
                '<option value="10">October</option>' . "\n" .
                '<option value="11">November</option>' . "\n" .
                '<option value="12">December</option></select>',
            Xml::dateMenu( 2011, 02 ),
            "Date menu for february 2011"
        );
        $this->assertEquals(
            '<label for="year">From year (and earlier):</label> ' .
                '<input id="year" maxlength="4" size="7" type="number" value="2011" name="year"/> ' .
                '<label for="month">From month (and earlier):</label> ' .
                '<select name="month" id="month" class="mw-month-selector">' .
                '<option value="-1">all</option>' . "\n" .
                '<option value="1">January</option>' . "\n" .
                '<option value="2">February</option>' . "\n" .
                '<option value="3">March</option>' . "\n" .
                '<option value="4">April</option>' . "\n" .
                '<option value="5">May</option>' . "\n" .
                '<option value="6">June</option>' . "\n" .
                '<option value="7">July</option>' . "\n" .
                '<option value="8">August</option>' . "\n" .
                '<option value="9">September</option>' . "\n" .
                '<option value="10">October</option>' . "\n" .
                '<option value="11">November</option>' . "\n" .
                '<option value="12">December</option></select>',
            Xml::dateMenu( 2011, -1 ),
            "Date menu with negative month for 'All'"
        );
        $this->assertEquals(
            Xml::dateMenu( $curYear, $curMonth ),
            Xml::dateMenu( '', $curMonth ),
            "Date menu year is the current one when not specified"
        );

        $wantedYear = $nextMonth == 1 ? $curYear : $prevYear;
        $this->assertEquals(
            Xml::dateMenu( $wantedYear, $nextMonth ),
            Xml::dateMenu( '', $nextMonth ),
            "Date menu next month is 11 months ago"
        );

        $this->assertEquals(
            '<label for="year">From year (and earlier):</label> ' .
                '<input id="year" maxlength="4" size="7" type="number" name="year"/> ' .
                '<label for="month">From month (and earlier):</label> ' .
                '<select name="month" id="month" class="mw-month-selector">' .
                '<option value="-1">all</option>' . "\n" .
                '<option value="1">January</option>' . "\n" .
                '<option value="2">February</option>' . "\n" .
                '<option value="3">March</option>' . "\n" .
                '<option value="4">April</option>' . "\n" .
                '<option value="5">May</option>' . "\n" .
                '<option value="6">June</option>' . "\n" .
                '<option value="7">July</option>' . "\n" .
                '<option value="8">August</option>' . "\n" .
                '<option value="9">September</option>' . "\n" .
                '<option value="10">October</option>' . "\n" .
                '<option value="11">November</option>' . "\n" .
                '<option value="12">December</option></select>',
            Xml::dateMenu( '', '' ),
            "Date menu with neither year or month"
        );
    }

    public function testTextareaNoContent() {
        $this->assertEquals(
            '<textarea name="name" id="name" cols="40" rows="5"></textarea>',
            Xml::textarea( 'name', '' ),
            'textarea() with not content'
        );
    }

    public function testTextareaAttribs() {
        $this->assertEquals(
            '<textarea name="name" id="name" cols="20" rows="10">&lt;txt&gt;</textarea>',
            Xml::textarea( 'name', '<txt>', 20, 10 ),
            'textarea() with custom attribs'
        );
    }

    public function testLabelCreation() {
        $this->assertEquals(
            '<label for="id">name</label>',
            Xml::label( 'name', 'id' ),
            'label() with no attribs'
        );
    }

    public function testLabelAttributeCanOnlyBeClassOrTitle() {
        $this->assertEquals(
            '<label for="id">name</label>',
            Xml::label( 'name', 'id', [ 'generated' => true ] ),
            'label() can not be given a generated attribute'
        );
        $this->assertEquals(
            '<label for="id" class="nice">name</label>',
            Xml::label( 'name', 'id', [ 'class' => 'nice' ] ),
            'label() can get a class attribute'
        );
        $this->assertEquals(
            '<label for="id" title="nice tooltip">name</label>',
            Xml::label( 'name', 'id', [ 'title' => 'nice tooltip' ] ),
            'label() can get a title attribute'
        );
        $this->assertEquals(
            '<label for="id" class="nice" title="nice tooltip">name</label>',
            Xml::label( 'name', 'id', [
                    'generated' => true,
                    'class' => 'nice',
                    'title' => 'nice tooltip',
                    'anotherattr' => 'value',
                ]
            ),
            'label() skip all attributes but "class" and "title"'
        );
    }

    public function testLanguageSelector() {
        $select = Xml::languageSelector( 'en', true, null,
            [ 'id' => 'testlang' ], wfMessage( 'yourlanguage' ) );
        $this->assertEquals(
            '<label for="testlang">Language:</label>',
            $select[0]
        );
    }

    public function testEscapeJsStringSpecialChars() {
        $this->assertEquals(
            '\\\\\r\n',
            Xml::escapeJsString( "\\\r\n" ),
            'escapeJsString() with special characters'
        );
    }

    public function testEncodeJsVarBoolean() {
        $this->assertEquals(
            'true',
            Xml::encodeJsVar( true ),
            'encodeJsVar() with boolean'
        );
    }

    public function testEncodeJsVarNull() {
        $this->assertEquals(
            'null',
            Xml::encodeJsVar( null ),
            'encodeJsVar() with null'
        );
    }

    public function testEncodeJsVarArray() {
        $this->assertEquals(
            '["a",1]',
            Xml::encodeJsVar( [ 'a', 1 ] ),
            'encodeJsVar() with array'
        );
        $this->assertEquals(
            '{"a":"a","b":1}',
            Xml::encodeJsVar( [ 'a' => 'a', 'b' => 1 ] ),
            'encodeJsVar() with associative array'
        );
    }

    public function testEncodeJsVarObject() {
        $this->assertEquals(
            '{"a":"a","b":1}',
            Xml::encodeJsVar( (object)[ 'a' => 'a', 'b' => 1 ] ),
            'encodeJsVar() with object'
        );
    }

    public function testEncodeJsVarInt() {
        $this->assertEquals(
            '123456',
            Xml::encodeJsVar( 123456 ),
            'encodeJsVar() with int'
        );
    }

    public function testEncodeJsVarFloat() {
        $this->assertEquals(
            '1.23456',
            Xml::encodeJsVar( 1.23456 ),
            'encodeJsVar() with float'
        );
    }

    public function testEncodeJsVarIntString() {
        $this->assertEquals(
            '"123456"',
            Xml::encodeJsVar( '123456' ),
            'encodeJsVar() with int-like string'
        );
    }

    public function testEncodeJsVarFloatString() {
        $this->assertEquals(
            '"1.23456"',
            Xml::encodeJsVar( '1.23456' ),
            'encodeJsVar() with float-like string'
        );
    }
}