resources/src/mediawiki.api/mediawiki.api.login.js

   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, apiPromise,
  18                                 api = this;
  19
  20                         params = {
  21                                 action: 'login',
  22                                 lgname: username,
  23                                 lgpassword: password
  24                         };
  25
  26                         apiPromise = api.post( params );
  27                         return apiPromise
  28                                 .then( function ( data ) {
  29                                         params.lgtoken = data.login.token;
  30                                         return api.post( params )
  31                                                 .then( function ( data ) {
  32                                                         var code;
  33                                                         if ( data.login.result !== 'Success' ) {
  34                                                                 // Set proper error code whenever possible
  35                                                                 code = data.error && data.error.code || 'unknown';
  36                                                                 return $.Deferred().reject( code, data );
  37                                                         }
  38                                                         return data;
  39                                                 } );
  40                                 } )
  41                                 .promise( { abort: apiPromise.abort } );
  42                 }
  43         } );
  44
  45         /**
  46          * @class mw.Api
  47          * @mixins mw.Api.plugin.login
  48          */
  49
  50 }( mediaWiki, jQuery ) );