1 files changed, 70 insertions, 0 deletions
diff --git a/www/wiki/resources/src/mediawiki/api/watch.js b/www/wiki/resources/src/mediawiki/api/watch.js
new file mode 100644
index 00000000..025c111e
--- /dev/null
+++ b/www/wiki/resources/src/mediawiki/api/watch.js
@@ -0,0 +1,70 @@
+/**
+ * @class mw.Api.plugin.watch
+ * @since 1.19
+ */
+( function ( mw, $ ) {
+
+	/**
+	 * @private
+	 * @static
+	 * @context mw.Api
+	 *
+	 * @param {string|mw.Title|string[]|mw.Title[]} pages Full page name or instance of mw.Title, or an
+	 *  array thereof. If an array is passed, the return value passed to the promise will also be an
+	 *  array of appropriate objects.
+	 * @param {Object} [addParams]
+	 * @return {jQuery.Promise}
+	 * @return {Function} return.done
+	 * @return {Object|Object[]} return.done.watch Object or list of objects (depends on the `pages`
+	 *  parameter)
+	 * @return {string} return.done.watch.title Full pagename
+	 * @return {boolean} return.done.watch.watched Whether the page is now watched or unwatched
+	 */
+	function doWatchInternal( pages, addParams ) {
+		// XXX: Parameter addParams is undocumented because we inherit this
+		// documentation in the public method...
+		var apiPromise = this.postWithToken( 'watch',
+			$.extend(
+				{
+					formatversion: 2,
+					action: 'watch',
+					titles: Array.isArray( pages ) ? pages : String( pages )
+				},
+				addParams
+			)
+		);
+
+		return apiPromise
+			.then( function ( data ) {
+				// If a single page was given (not an array) respond with a single item as well.
+				return Array.isArray( pages ) ? data.watch : data.watch[ 0 ];
+			} )
+			.promise( { abort: apiPromise.abort } );
+	}
+
+	$.extend( mw.Api.prototype, {
+		/**
+		 * Convenience method for `action=watch`.
+		 *
+		 * @inheritdoc #doWatchInternal
+		 */
+		watch: function ( pages ) {
+			return doWatchInternal.call( this, pages );
+		},
+
+		/**
+		 * Convenience method for `action=watch&unwatch=1`.
+		 *
+		 * @inheritdoc #doWatchInternal
+		 */
+		unwatch: function ( pages ) {
+			return doWatchInternal.call( this, pages, { unwatch: 1 } );
+		}
+	} );
+
+	/**
+	 * @class mw.Api
+	 * @mixins mw.Api.plugin.watch
+	 */
+
+}( mediaWiki, jQuery ) );