2 * Additional mw.Api methods to assist with (un)watching wiki pages.
7 $.extend( mw
.Api
.prototype, {
9 * Convinience method for 'action=watch'.
11 * @param page {String|mw.Title} Full page name or instance of mw.Title
12 * @param success {Function} callback to which the watch object will be passed
13 * watch object contains 'title' (full page name), 'watched' (boolean) and
14 * 'message' (parsed HTML of the 'addedwatchtext' message).
15 * @param err {Function} callback if error (optional)
18 watch: function( page
, success
, err
) {
22 title
: String( page
),
23 token
: mw
.user
.tokens
.get( 'watchToken' ),
24 uselang
: mw
.config
.get( 'wgUserLanguage' )
26 ok = function( data
) {
27 success( data
.watch
);
29 return this.post( params
, { ok
: ok
, err
: err
} );
32 * Convinience method for 'action=watch&unwatch='.
34 * @param page {String|mw.Title} Full page name or instance of mw.Title
35 * @param success {Function} callback to which the watch object will be passed
36 * watch object contains 'title' (full page name), 'unwatched' (boolean) and
37 * 'message' (parsed HTML of the 'removedwatchtext' message).
38 * @param err {Function} callback if error (optional)
41 unwatch: function( page
, success
, err
) {
46 title
: String( page
),
47 token
: mw
.user
.tokens
.get( 'watchToken' ),
48 uselang
: mw
.config
.get( 'wgUserLanguage' )
50 ok = function( data
) {
51 success( data
.watch
);
53 return this.post( params
, { ok
: ok
, err
: err
} );
58 } )( jQuery
, mediaWiki
);