[Summary view] [Print] [Text view]

   1  /**
   2   * Make the two-step login easier.
   3   * @author Niklas Laxström
   4   * @class mw.Api.plugin.login
   5   * @since 1.22
   6   */
   7  ( function ( mw, $ ) {
   8      'use strict';
   9  
  10      $.extend( mw.Api.prototype, {
  11          /**
  12           * @param {string} username
  13           * @param {string} password
  14           * @return {jQuery.Promise} See mw.Api#post
  15           */
  16          login: function ( username, password ) {
  17              var params, request,
  18                  deferred = $.Deferred(),
  19                  api = this;
  20  
  21              params = {
  22                  action: 'login',
  23                  lgname: username,
  24                  lgpassword: password
  25              };
  26  
  27              request = api.post( params );
  28              request.fail( deferred.reject );
  29              request.done( function ( data ) {
  30                  params.lgtoken = data.login.token;
  31                  api.post( params )
  32                      .fail( deferred.reject )
  33                      .done( function ( data ) {
  34                          var code;
  35                          if ( data.login && data.login.result === 'Success' ) {
  36                              deferred.resolve( data );
  37                          } else {
  38                              // Set proper error code whenever possible
  39                              code = data.error && data.error.code || 'unknown';
  40                              deferred.reject( code, data );
  41                          }
  42                      } );
  43              } );
  44  
  45              return deferred.promise( { abort: request.abort } );
  46          }
  47      } );
  48  
  49      /**
  50       * @class mw.Api
  51       * @mixins mw.Api.plugin.login
  52       */
  53  
  54  }( mediaWiki, jQuery ) );