Jasmine Test Runner

' ).addClass( 'foo' ); + $div.msg( 'en_replace', '

' ); // looks like HTML, but as a string, should be escaped. + // passing this through jQuery and back to string, because browsers may have subtle differences, like the case of tag names. + var expectedHtml = $( '

Simple <p>x</p> replacement

' ).html(); + var createdHtml = $div.html(); + expect( expectedHtml ).toEqual( createdHtml ); + delete $.fn.msg; + } ); + + + it( "jQuery plugin should never execute scripts", function() { + window.en_evil = false; + $.fn.msg = mw.jqueryMsg.getPlugin(); + var $div = $( '

' ); + $div.msg( 'en_evil' ); + expect( window.en_evil ).toEqual( false ); + delete $.fn.msg; + } ); + + + // n.b. this passes because jQuery already seems to strip scripts away; however, it still executes them if they are appended to any element. + it( "jQuery plugin should never emit scripts", function() { + $.fn.msg = mw.jqueryMsg.getPlugin(); + var $div = $( '

' ); + $div.msg( 'en_evil' ); + // passing this through jQuery and back to string, because browsers may have subtle differences, like the case of tag names. + var expectedHtml = $( '

This has tags

' ).html(); + var createdHtml = $div.html(); + expect( expectedHtml ).toEqual( createdHtml ); + console.log( 'expected: ' + expectedHtml ); + console.log( 'created: ' + createdHtml ); + delete $.fn.msg; + } ); + + + + } ); + + // The parser functions can throw errors, but let's not actually blow up for the user -- instead dump the error into the interface so we have + // a chance at fixing this + describe( "easy message interface functions with graceful failures", function() { + it( "should allow a global that returns strings, with graceful failure", function() { + var gM = mw.jqueryMsg.getMessageFunction(); + // passing this through jQuery and back to string, because browsers may have subtle differences, like the case of tag names. + // a surrounding is needed for html() to work right + var expectedHtml = $( 'en_fail: Parse error at position 20 in input: This should fail to {{parse' ).html(); + var result = gM( 'en_fail' ); + expect( typeof result ).toEqual( 'string' ); + expect( result ).toEqual( expectedHtml ); + } ); + + it( "should allow a global that returns strings, with graceful failure on missing magic words", function() { + var gM = mw.jqueryMsg.getMessageFunction(); + // passing this through jQuery and back to string, because browsers may have subtle differences, like the case of tag names. + // a surrounding is needed for html() to work right + var expectedHtml = $( 'en_fail_magic: unknown operation "sietname"' ).html(); + var result = gM( 'en_fail_magic' ); + expect( typeof result ).toEqual( 'string' ); + expect( result ).toEqual( expectedHtml ); + } ); + + + it( "should allow a jQuery plugin, with graceful failure", function() { + $.fn.msg = mw.jqueryMsg.getPlugin(); + var $div = $( '

' ).append( $( '

' ).addClass( 'foo' ) ); + $div.find( '.foo' ).msg( 'en_fail' ); + // passing this through jQuery and back to string, because browsers may have subtle differences, like the case of tag names. + // a surrounding is needed for html() to work right + var expectedHtml = $( 'en_fail: Parse error at position 20 in input: This should fail to {{parse' ).html(); + var createdHtml = $div.find( '.foo' ).html(); + expect( createdHtml ).toEqual( expectedHtml ); + delete $.fn.msg; + } ); + + } ); + + + + + describe( "test plurals and other language-specific functions", function() { + /* copying some language definitions in here -- it's hard to make this test fast and reliable + otherwise, and we don't want to have to know the mediawiki URL from this kind of test either. + We also can't preload the langs for the test since they clobber the same namespace. + In principle Roan said it was okay to change how languages worked so that didn't happen... maybe + someday. We'd have to the same kind of importing of the default rules for most rules, or maybe + come up with some kind of subclassing scheme for languages */ + var languageClasses = { + ar: { + /** + * Arabic (العربية) language functions + */ + + convertPlural: function( count, forms ) { + forms = mw.language.preConvertPlural( forms, 6 ); + if ( count === 0 ) { + return forms[0]; + } + if ( count == 1 ) { + return forms[1]; + } + if ( count == 2 ) { + return forms[2]; + } + if ( count % 100 >= 3 && count % 100 <= 10 ) { + return forms[3]; + } + if ( count % 100 >= 11 && count % 100 <= 99 ) { + return forms[4]; + } + return forms[5]; + }, + + digitTransformTable: { + '0': '٠', // ٠ + '1': '١', // ١ + '2': '٢', // ٢ + '3': '٣', // ٣ + '4': '٤', // ٤ + '5': '٥', // ٥ + '6': '٦', // ٦ + '7': '٧', // ٧ + '8': '٨', // ٨ + '9': '٩', // ٩ + '.': '٫', // ٫ wrong table ? + ',': '٬' // ٬ + } + + }, + en: { }, + fr: { + convertPlural: function( count, forms ) { + forms = mw.language.preConvertPlural( forms, 2 ); + return ( count <= 1 ) ? forms[0] : forms[1]; + } + }, + jp: { }, + zh: { } + }; + + /* simulate how the language classes override, or don't, the standard functions in mw.language */ + $.each( languageClasses, function( langCode, rules ) { + $.each( [ 'convertPlural', 'convertNumber' ], function( i, propertyName ) { + if ( typeof rules[ propertyName ] === 'undefined' ) { + rules[ propertyName ] = mw.language[ propertyName ]; + } + } ); + } ); + + $.each( jasmineMsgSpec, function( i, test ) { + it( "should parse " + test.name, function() { + // using language override so we don't have to muck with global namespace + var parser = new mw.jqueryMsg.parser( { language: languageClasses[ test.lang ] } ); + var parsedHtml = parser.parse( test.key, test.args ).html(); + expect( parsedHtml ).toEqual( test.result ); + } ); + } ); + + } ); + + } ); +} )( window.mediaWiki, jQuery ); diff --git a/tests/jasmine/spec_makers/makeJqueryMsgSpec.php b/tests/jasmine/spec_makers/makeJqueryMsgSpec.php new file mode 100644 index 00000000..1ac8dcba --- /dev/null +++ b/tests/jasmine/spec_makers/makeJqueryMsgSpec.php @@ -0,0 +1,114 @@ + array( + array( 0 ), + array( 1 ), + array( 2 ), + array( 5 ), + array( 21 ), + array( 101 ) + ), + 'category-subcat-count' => array( + array( 0, 10 ), + array( 1, 1 ), + array( 1, 2 ), + array( 3, 30 ) + ) + ); + + public function __construct() { + parent::__construct(); + $this->mDescription = "Create a JasmineBDD-compatible specification for message parsing"; + // add any other options here + } + + public function execute() { + list( $messages, $tests ) = $this->getMessagesAndTests(); + $this->writeJavascriptFile( $messages, $tests, "spec/mediawiki.language.parser.spec.data.js" ); + } + + private function getMessagesAndTests() { + $messages = array(); + $tests = array(); + $wfMsgExtOptions = array( 'parsemag' ); + foreach ( array( 'en', 'fr', 'ar', 'jp', 'zh' ) as $languageCode ) { + $wfMsgExtOptions['language'] = $languageCode; + foreach ( self::$keyToTestArgs as $key => $testArgs ) { + foreach ($testArgs as $args) { + // get the raw template, without any transformations + $template = wfMsgGetKey( $key, /* useDb */ true, $languageCode, /* transform */ false ); + + // get the magic-parsed version with args + $wfMsgExtArgs = array_merge( array( $key, $wfMsgExtOptions ), $args ); + $result = call_user_func_array( 'wfMsgExt', $wfMsgExtArgs ); + + // record the template, args, language, and expected result + // fake multiple languages by flattening them together + $langKey = $languageCode . '_' . $key; + $messages[ $langKey ] = $template; + $tests[] = array( + 'name' => $languageCode . " " . $key . " " . join( ",", $args ), + 'key' => $langKey, + 'args' => $args, + 'result' => $result, + 'lang' => $languageCode + ); + } + } + } + return array( $messages, $tests ); + } + + private function writeJavascriptFile( $messages, $tests, $dataSpecFile ) { + global $argv; + $arguments = count($argv) ? $argv : $_SERVER[ 'argv' ]; + + $json = new Services_JSON; + $json->pretty = true; + $javascriptPrologue = "// This file stores the results from the PHP parser for certain messages and arguments,\n" + . "// so we can test the equivalent Javascript libraries.\n" + . '// Last generated with ' . join(' ', $arguments) . ' at ' . gmdate('c') . "\n\n"; + $javascriptMessages = "mediaWiki.messages.set( " . $json->encode( $messages, true ) . " );\n"; + $javascriptTests = 'var jasmineMsgSpec = ' . $json->encode( $tests, true ) . ";\n"; + + $fp = fopen( $dataSpecFile, 'w' ); + if ( !$fp ) { + die( "couldn't open $dataSpecFile for writing" ); + } + $success = fwrite( $fp, $javascriptPrologue . $javascriptMessages . $javascriptTests ); + if ( !$success ) { + die( "couldn't write to $dataSpecFile" ); + } + $success = fclose( $fp ); + if ( !$success ) { + die( "couldn't close $dataSpecFile" ); + } + } +} + +$maintClass = "MakeLanguageSpec"; +require_once( "$maintenanceDir/doMaintenance.php" ); + + + -- cgit v1.2.3-54-g00ecf