Issue 4878 - Start using ESLint for adblockpluscore

lib/filterNotifier.js

 /*
  * This file is part of Adblock Plus <https://adblockplus.org/>,
  * Copyright (C) 2006-2016 Eyeo GmbH
  *
  * Adblock Plus is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License version 3 as
  * published by the Free Software Foundation.
  *
  * Adblock Plus is distributed in the hope that it will be useful,
  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  * GNU General Public License for more details.
  *
  * You should have received a copy of the GNU General Public License
  * along with Adblock Plus.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+"use strict";
+
 /**
  * @fileOverview This component manages listeners and calls them to distributes
  * messages about filter changes.
  */
 
 let {EventEmitter} = require("events");
 let {desc} = require("coreUtils");
 
 const CATCH_ALL = "__all";
 
 /**
+ * @callback FilterNotifierOnListener
+ * @param {String} action
+ * @param {Subscription|Filter} item
+ * @param {any} newValue

[Sebastian Noack, 2017/02/20 13:14:51]

JSdoc interprets "any" as a class of the name "any". The special value that
indicates any type/class is "*". Alternatively, you may just omit the type.

[kzar, 2017/02/21 06:13:59]

Done.

+ * @param {any} oldValue
+ */
+
+/**
  * This class allows registering and triggering listeners for filter events.
  * @class
  */
 exports.FilterNotifier = Object.create(new EventEmitter(), desc({
   /**
    * Adds a listener
    *
    * @deprecated use FilterNotifier.on(action, callback)
+   * @param {FilterNotifierOnListener} listener
    */
-  addListener: function(/**function(action, item, newValue, oldValue)*/ listener)
+  addListener(listener)
   {
     let listeners = this._listeners[CATCH_ALL];
     if (!listeners || listeners.indexOf(listener) == -1)
       this.on(CATCH_ALL, listener);
   },
 
   /**
    * Removes a listener that was previosly added via addListener
    *
    * @deprecated use FilterNotifier.off(action, callback)
+   * @param {FilterNotifierOnListener} listener
    */
-  removeListener: function(/**function(action, item, newValue, oldValue)*/ listener)
+  removeListener(listener)
   {
     this.off(CATCH_ALL, listener);
   },
 
   /**
    * Notifies listeners about an event
    * @param {String} action event code ("load", "save", "elemhideupdate",
    *                 "subscription.added", "subscription.removed",
    *                 "subscription.disabled", "subscription.title",
    *                 "subscription.lastDownload", "subscription.downloadStatus",
    *                 "subscription.homepage", "subscription.updated",
    *                 "filter.added", "filter.removed", "filter.moved",
    *                 "filter.disabled", "filter.hitCount", "filter.lastHit")
    * @param {Subscription|Filter} item item that the change applies to
+   * @param {any} param1
+   * @param {any} param2
+   * @param {any} param3
    * @deprecated use FilterNotifier.emit(action)
    */
-  triggerListeners: function(action, item, param1, param2, param3)
+  triggerListeners(action, item, param1, param2, param3)
   {
     this.emit(action, item, param1, param2, param3);
     this.emit(CATCH_ALL, action, item, param1, param2, param3);
   }
 }));