moving tests to the mediawiki.util section + note about order
[lhc/web/wiklou.git] / resources / mediawiki.util / mediawiki.util.test.js
index 5da879e..c6be185 100644 (file)
@@ -1,7 +1,7 @@
 /**
  * mediaWiki JavaScript library test suite
  *
- * Available on "/Special:BlankPage?action=mwutiltest&debug=true")
+ * Available on Special:BlankPage?action=mwutiltest&debug=true
  *
  * @author Krinkle <krinklemail@gmail.com>
  */
                                contain = result;
                        }
                        this.addedTests.push( [code, result, contain] );
-                       this.$table.append( '<tr><td>' + mw.html.escape( code ).replace(/  /g, '&nbsp;&nbsp;' )
-                               + '</td><td>' + mw.html.escape( result ).replace(/  /g, '&nbsp;&nbsp;' )
+                       this.$table.append( '<tr><td>' + mw.html.escape( code ).replace( /  /g, '&nbsp;&nbsp;' )
+                               + '</td><td>' + mw.html.escape( result ).replace( /  /g, '&nbsp;&nbsp;' )
                                + '</td><td></td><td>?</td></tr>' );
+                       return true;
+               },
+
+               /**
+               * Adds a heading to the test-table
+               *
+               * @param title String   Title of the section
+               */
+               'addHead' : function( title ) {
+                       if ( !title ) {
+                               return false;
+                       }
+                       this.$table.append( '<tr><th colspan="4">' + mw.html.escape( title ).replace( /  /g, '&nbsp;&nbsp;' ) + '</th></tr>' );
+                       return true;
                },
 
                /* Initialisation */
                                                // Build page
                                                document.title = 'mediaWiki JavaScript library test suite - ' + mw.config.get( 'wgSiteName' );
                                                $( '#firstHeading' ).text( 'mediaWiki JavaScript library test suite' );
+                                               var     skinLinksText = 'Test in: ';
+                                                       skinLinks = [],
+                                                       availableSkins = mw.config.get( 'wgAvailableSkins' ),
+                                                       skincode = '';
+                                               for ( skincode in availableSkins ) {
+                                                       skinLinks.push( mw.html.element( 'a', {
+                                                               'href': mw.util.wikiGetlink( wgPageName ) + '?action=mwutiltest&debug=true&useskin=' + encodeURIComponent( skincode )
+                                                               }, availableSkins[skincode] ) );
+                                               }
+                                               skinLinksText += skinLinks.join( ' | ' ) + '.';
                                                mw.util.$content.html(
                                                        '<p>Below is a list of tests to confirm proper functionality of the mediaWiki JavaScript library</p>'
+                                                       + '<p>' + skinLinksText + '</p>'
                                                        + '<hr />'
                                                        + '<table id="mw-mwutiltest-table" class="wikitable sortable" style="white-space:break; font-family:monospace,\'Courier New\'">'
                                                        + '<tr><th>Exec</th><th>Should return</th><th>Does return</th><th>Equal ?</th></tr>'
                                                );
                                                mw.test.$table = $( 'table#mw-mwutiltest-table' );
 
-                                               // Populate tests
+                                               /* Populate tests */
+                                               // Try to roughly keep the order similar to the order in the files
+                                               // or alphabetical (depending on the context)
+
+                                               // Main modules and their aliases
+                                               mw.test.addHead( 'Main modules and their aliases' );
+
+                                               mw.test.addTest( 'typeof mediaWiki',
+                                                       'object (string)' );
+
+                                               mw.test.addTest( 'typeof mw',
+                                                       'object (string)' );
+
+                                               mw.test.addTest( 'typeof jQuery',
+                                                       'function (string)' );
+
+                                               mw.test.addTest( 'typeof $',
+                                                       'function (string)' );
+
+                                               // Prototype functions added by MediaWiki
+                                               mw.test.addHead( 'Prototype functions added by MediaWiki' );
+
                                                mw.test.addTest( 'typeof $.trimLeft',
                                                        'function (string)' );
-                                               mw.test.addTest( '$.trimLeft(\'  foo bar  \')',
+
+                                               mw.test.addTest( '$.trimLeft( "  foo bar  " )',
                                                        'foo bar   (string)' );
+
                                                mw.test.addTest( 'typeof $.trimRight',
                                                        'function (string)' );
-                                               mw.test.addTest( '$.trimRight(\'  foo bar  \')',
+
+                                               mw.test.addTest( '$.trimRight( "  foo bar  " )',
                                                        '  foo bar (string)' );
+
+                                               mw.test.addTest( 'typeof $.ucFirst',
+                                                       'function (string)' );
+
+                                               mw.test.addTest( '$.ucFirst( "mediawiki" )',
+                                                       'Mediawiki (string)' );
+
+                                               mw.test.addTest( 'typeof $.escapeRE',
+                                                       'function (string)' );
+
+                                               mw.test.addTest( '$.escapeRE( ".st{e}$st" )',
+                                                       '\\.st\\{e\\}\\$st (string)' );
+
                                                mw.test.addTest( 'typeof $.isEmpty',
                                                        'function (string)' );
-                                               mw.test.addTest( '$.isEmpty(\'string\')',
+
+                                               mw.test.addTest( '$.isEmpty( "string" )',
                                                        'false (boolean)' );
-                                               mw.test.addTest( '$.isEmpty(\'0\')',
+
+                                               mw.test.addTest( '$.isEmpty( "0" )',
                                                        'true (boolean)' );
+
                                                mw.test.addTest( '$.isEmpty([])',
                                                        'true (boolean)' );
+
                                                mw.test.addTest( 'typeof $.compareArray',
                                                        'function (string)' );
-                                               mw.test.addTest( '$.compareArray( [1, "a", [], [2, \'b\'] ], [1, \'a\', [], [2, "b"] ] )',
+
+                                               mw.test.addTest( '$.compareArray( [1, "a", [], [2, "b"] ], [1, "a", [], [2, "b"] ] )',
                                                        'true (boolean)' );
+
                                                mw.test.addTest( '$.compareArray( [1], [2] )',
                                                        'false (boolean)' );
-                                               mw.test.addTest( '4',
-                                                       '4 (number)' );
-                                               mw.test.addTest( 'typeof mediaWiki',
+
+                                               mw.test.addTest( 'typeof $.compareObject',
+                                                       'function (string)' );
+
+                                               // mediawiki.js
+                                               mw.test.addHead( 'mediawiki.js' );
+
+                                               mw.test.addTest( 'mw.config instanceof mw.Map',
+                                                       'true (boolean)' );
+
+                                               mw.test.addTest( 'mw.config.exists()',
+                                                       'true (boolean)' );
+
+                                               mw.test.addTest( 'mw.config.exists( "wgSomeName" )',
+                                                       'false (boolean)' );
+
+                                               mw.test.addTest( 'mw.config.exists( ["wgCanonicalNamespace", "wgTitle"] )',
+                                                       'true (boolean)' );
+
+                                               mw.test.addTest( 'mw.config.exists( ["wgSomeName", "wgTitle"] )',
+                                                       'false (boolean)' );
+
+                                               mw.test.addTest( 'mw.config.get( "wgTitle" )',
+                                                       'BlankPage (string)' );
+
+                                               mw.test.addTest( 'var a = mw.config.get( ["wgTitle"] ); a.wgTitle',
+                                                       'BlankPage (string)' );
+
+                                               mw.test.addTest( 'typeof mw.html',
                                                        'object (string)' );
-                                               mw.test.addTest( 'typeof mw',
+
+                                               mw.test.addTest( 'mw.html.escape( \'<mw awesome="awesome">\' )',
+                                                       '&lt;mw awesome=&quot;awesome&quot;&gt; (string)' );
+
+                                               mw.test.addTest( 'mw.html.element( "hr" )',
+                                                       '<hr/> (string)' );
+
+                                               mw.test.addTest( 'mw.html.element( "img", { "src": "http://mw.org/?title=Main page&action=edit" } )',
+                                                       '<img src="http://mw.org/?title=Main page&amp;action=edit"/> (string)' );
+
+                                               mw.test.addTest( 'typeof mw.loader',
                                                        'object (string)' );
-                                               mw.test.addTest( 'typeof mw.util',
+
+                                               mw.test.addTest( 'typeof mw.loader.using',
+                                                       'function (string)' );
+
+                                               mw.test.addTest( 'typeof mw.Map',
+                                                       'function (string)' );
+
+                                               mw.test.addTest( 'typeof mw.user',
                                                        'object (string)' );
-                                               mw.test.addTest( 'typeof mw.html',
+
+                                               mw.test.addTest( 'typeof mw.user.anonymous()',
+                                                       'boolean (string)' );
+
+                                               // mediawiki.util.js
+                                               mw.test.addHead( 'mediawiki.util.js' );
+
+                                               mw.test.addTest( 'typeof mw.util',
                                                        'object (string)' );
-                                               mw.test.addTest( 'typeof $.ucFirst',
-                                                       'function (string)' );
-                                               mw.test.addTest( '$.ucFirst( \'mediawiki\' )',
-                                                       'Mediawiki (string)' );
-                                               mw.test.addTest( 'typeof $.escapeRE',
+
+                                               mw.test.addTest( 'typeof mw.util.rawurlencode',
                                                        'function (string)' );
-                                               mw.test.addTest( '$.escapeRE( \'.st{e}$st\' )',
-                                                       '\\.st\\{e\\}\\$st (string)' );
-                                               mw.test.addTest( 'typeof $.fn.checkboxShiftClick',
+
+                                               mw.test.addTest( 'mw.util.rawurlencode( "Test:A & B/Here" )',
+                                                       'Test%3AA%20%26%20B%2FHere (string)' );
+
+                                               mw.test.addTest( 'typeof mw.util.wikiUrlencode',
                                                        'function (string)' );
-                                               mw.test.addTest( 'typeof mw.util.rawurlencode',
+
+                                               mw.test.addTest( 'mw.util.wikiUrlencode( "Test:A & B/Here" )',
+                                                       'Test:A_%26_B/Here (string)' );
+
+                                               mw.test.addTest( 'typeof mw.util.addCSS',
                                                        'function (string)' );
-                                               mw.test.addTest( 'mw.util.rawurlencode( \'Test: A&B/Here\' )',
-                                                       'Test%3A%20A%26B%2FHere (string)' );
+
+                                               mw.test.addTest( 'var a = mw.util.addCSS( ".plainlinks { color:green; }" ); a.disabled;',
+                                                       'false (boolean)',
+                                                       '(boolean)' );
+
                                                mw.test.addTest( 'typeof mw.util.wikiGetlink',
                                                        'function (string)' );
+
                                                mw.test.addTest( 'typeof mw.util.getParamValue',
                                                        'function (string)' );
-                                               mw.test.addTest( 'mw.util.getParamValue( \'action\' )',
+
+                                               mw.test.addTest( 'mw.util.getParamValue( "action" )',
                                                        'mwutiltest (string)' );
-                                               mw.test.addTest( 'mw.util.getParamValue( \'foo\', \'http://mw.org/?foo=wrong&foo=right#&foo=bad\' )',
+
+                                               mw.test.addTest( 'mw.util.getParamValue( "foo", "http://mw.org/?foo=wrong&foo=right#&foo=bad" )',
                                                        'right (string)' );
+
                                                mw.test.addTest( 'mw.util.tooltipAccessKeyRegexp.constructor.name',
                                                        'RegExp (string)' );
+
                                                mw.test.addTest( 'typeof mw.util.updateTooltipAccessKeys',
                                                        'function (string)' );
+
+                                               mw.test.addTest( 'mw.util.$content instanceof jQuery',
+                                                       'true (boolean)' );
+
+                                               mw.test.addTest( 'mw.util.$content.size()',
+                                                       '1 (number)' );
+
                                                mw.test.addTest( 'typeof mw.util.addPortletLink',
                                                        'function (string)' );
-                                               mw.test.addTest( 'typeof mw.util.addPortletLink( "p-tb", "http://mediawiki.org/", "MediaWiki.org", "t-mworg", "Go to MediaWiki.org ", "m", "#t-print" )',
+
+                                               mw.test.addTest( 'typeof mw.util.addPortletLink( "p-tb", "http://mediawiki.org/wiki/ResourceLoader", "ResourceLoader", "t-rl", "More info about ResourceLoader on MediaWiki.org ", "l", "#t-specialpages" )',
                                                        'object (string)' );
-                                               mw.test.addTest( 'a = mw.util.addPortletLink( "p-tb", "http://mediawiki.org/", "MediaWiki.org", "t-mworg", "Go to MediaWiki.org ", "m", "#t-print" ); $(a).text();',
+
+                                               mw.test.addTest( 'var a = mw.util.addPortletLink( "p-tb", "http://mediawiki.org/", "MediaWiki.org", "t-mworg", "Go to MediaWiki.org ", "m", "#t-rl" ); $(a).text();',
                                                        'MediaWiki.org (string)' );
-                                               mw.test.addTest( 'mw.html.element( \'hr\' )',
-                                                       '<hr/> (string)' );
-                                               mw.test.addTest( 'mw.html.element( \'img\', { \'src\': \'http://mw.org/?title=Main page&action=edit\' } )',
-                                                       '<img src="http://mw.org/?title=Main page&amp;action=edit"/> (string)' );
+
+                                               mw.test.addTest( 'typeof mw.util.jsMessage',
+                                                       'function (string)' );
+
+                                               mw.test.addTest( 'mw.util.jsMessage( mw.config.get( "wgSiteName" ) + " is <b>Awesome</b>." )',
+                                                       'true (boolean)' );
+
+                                               // TODO: Import tests from PHPUnit test suite for user::isValidEmailAddr
+                                               mw.test.addTest( 'mw.util.validateEmail( "" )',
+                                                       'null (object)' );
+
+                                               mw.test.addTest( 'mw.util.validateEmail( "user@localhost" )',
+                                                       'true (boolean)' );
+
+                                               // jQuery plugins
+                                               mw.test.addHead( 'jQuery plugins' );
+
+                                               mw.test.addTest( 'typeof $.client',
+                                                       'object (string)' );
+
+                                               mw.test.addTest( 'typeof $.client.profile',
+                                                       'function (string)' );
+
+                                               mw.test.addTest( 'var a = $.client.profile(); typeof a.name',
+                                                       'string (string)' );
+
+                                               mw.test.addTest( 'typeof $.fn.makeCollapsible',
+                                                       'function (string)' );
 
                                                // Run tests and compare results
                                                var     exec,
                                                        numberofpasseds = 0,
                                                        numberofpartials = 0,
                                                        numberoferrors = 0,
-                                                       $testrows = mw.test.$table.find( 'tr' );
+                                                       $testrows = mw.test.$table.find( 'tr:has(td)' );
 
                                                $.each( mw.test.addedTests, function( i ) {
                                                        numberoftests++;
                                                        shouldcontain = mw.test.addedTests[i][2];
                                                        doesreturn = eval( exec );
                                                        doesreturn = doesreturn + ' (' + typeof doesreturn + ')';
-                                                       $thisrow = $testrows.eq( i + 1 );
+                                                       $thisrow = $testrows.eq( i );
                                                        $thisrow.find( '> td' ).eq(2).html( mw.html.escape( doesreturn ).replace(/  /g, '&nbsp;&nbsp;' ) );
 
                                                        if ( doesreturn.indexOf( shouldcontain ) !== -1 ) {
-                                                               if (doesreturn == shouldreturn){
+                                                               if ( doesreturn == shouldreturn ) {
                                                                        $thisrow.find( '> td' ).eq(3).css( 'background', '#EFE' ).text( 'OK' );
                                                                        numberofpasseds++;
                                                                } else {
 
        mediaWiki.test.init();
 
-} )(jQuery, mediaWiki);
\ No newline at end of file
+} )(jQuery, mediaWiki);