resources/mediawiki.api/mediawiki.api.parse.js

   1 /**
   2  * @class mw.Api.plugin.parse
   3  */
   4 ( function ( mw, $ ) {
   5
   6         $.extend( mw.Api.prototype, {
   7                 /**
   8                  * Convinience method for 'action=parse'.
   9                  *
  10                  * @param {string} wikitext
  11                  * @param {Function} [ok] Success callback (deprecated)
  12                  * @param {Function} [err] Error callback (deprecated)
  13                  * @return {jQuery.Promise}
  14                  * @return {Function} return.done
  15                  * @return {string} return.done.data Parsed HTML of `wikitext`.
  16                  */
  17                 parse: function ( wikitext, ok, err ) {
  18                         var d = $.Deferred();
  19                         // Backwards compatibility (< MW 1.20)
  20                         d.done( ok );
  21                         d.fail( err );
  22
  23                         this.get( {
  24                                         action: 'parse',
  25                                         text: wikitext
  26                                 } )
  27                                 .done( function ( data ) {
  28                                         if ( data.parse && data.parse.text && data.parse.text['*'] ) {
  29                                                 d.resolve( data.parse.text['*'] );
  30                                         }
  31                                 } )
  32                                 .fail( d.reject );
  33
  34                         return d.promise();
  35                 }
  36         } );
  37
  38         /**
  39          * @class mw.Api
  40          * @mixins mw.Api.plugin.parse
  41          */
  42
  43 }( mediaWiki, jQuery ) );