LEFT | RIGHT |
1 /* | 1 /* |
2 * This file is part of Adblock Plus <https://adblockplus.org/>, | 2 * This file is part of Adblock Plus <https://adblockplus.org/>, |
3 * Copyright (C) 2006-2016 Eyeo GmbH | 3 * Copyright (C) 2006-2016 Eyeo GmbH |
4 * | 4 * |
5 * Adblock Plus is free software: you can redistribute it and/or modify | 5 * Adblock Plus is free software: you can redistribute it and/or modify |
6 * it under the terms of the GNU General Public License version 3 as | 6 * it under the terms of the GNU General Public License version 3 as |
7 * published by the Free Software Foundation. | 7 * published by the Free Software Foundation. |
8 * | 8 * |
9 * Adblock Plus is distributed in the hope that it will be useful, | 9 * Adblock Plus is distributed in the hope that it will be useful, |
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of | 10 * but WITHOUT ANY WARRANTY; without even the implied warranty of |
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | 11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
12 * GNU General Public License for more details. | 12 * GNU General Public License for more details. |
13 * | 13 * |
14 * You should have received a copy of the GNU General Public License | 14 * You should have received a copy of the GNU General Public License |
15 * along with Adblock Plus. If not, see <http://www.gnu.org/licenses/>. | 15 * along with Adblock Plus. If not, see <http://www.gnu.org/licenses/>. |
16 */ | 16 */ |
17 | 17 |
18 "use strict"; | 18 "use strict"; |
19 | 19 |
20 /** | 20 /** |
21 * @fileOverview This component manages listeners and calls them to distributes | 21 * @fileOverview This component manages listeners and calls them to distributes |
22 * messages about filter changes. | 22 * messages about filter changes. |
23 */ | 23 */ |
24 | 24 |
25 let {EventEmitter} = require("events"); | 25 const {EventEmitter} = require("events"); |
26 let {desc} = require("coreUtils"); | 26 const {desc} = require("coreUtils"); |
27 | 27 |
28 const CATCH_ALL = "__all"; | 28 const CATCH_ALL = "__all"; |
29 | 29 |
30 /** | 30 /** |
31 * @callback FilterNotifierOnListener | 31 * @callback FilterNotifierCatchAllListener |
32 * @param {string} action | 32 * @param {string} action |
33 * @param {Subscription|Filter} item | 33 * @param {Subscription|Filter} item |
34 * @param {*} newValue | 34 * @param {...*} additionalInfo |
35 * @param {*} oldValue | |
36 */ | 35 */ |
37 | 36 |
38 /** | 37 /** |
39 * This class allows registering and triggering listeners for filter events. | 38 * This class allows registering and triggering listeners for filter events. |
40 * @class | 39 * @class |
41 */ | 40 */ |
42 exports.FilterNotifier = Object.create(new EventEmitter(), desc({ | 41 exports.FilterNotifier = Object.create(new EventEmitter(), desc({ |
43 /** | 42 /** |
44 * Adds a listener | 43 * Adds a listener |
45 * | 44 * |
46 * @deprecated use FilterNotifier.on(action, callback) | 45 * @deprecated use FilterNotifier.on(action, callback) |
47 * @param {FilterNotifierOnListener} listener | 46 * @param {FilterNotifierCatchAllListener} listener |
48 */ | 47 */ |
49 addListener(listener) | 48 addListener(listener) |
50 { | 49 { |
51 let listeners = this._listeners[CATCH_ALL]; | 50 let listeners = this._listeners[CATCH_ALL]; |
52 if (!listeners || listeners.indexOf(listener) == -1) | 51 if (!listeners || listeners.indexOf(listener) == -1) |
53 this.on(CATCH_ALL, listener); | 52 this.on(CATCH_ALL, listener); |
54 }, | 53 }, |
55 | 54 |
56 /** | 55 /** |
57 * Removes a listener that was previosly added via addListener | 56 * Removes a listener that was previosly added via addListener |
58 * | 57 * |
59 * @deprecated use FilterNotifier.off(action, callback) | 58 * @deprecated use FilterNotifier.off(action, callback) |
60 * @param {FilterNotifierOnListener} listener | 59 * @param {FilterNotifierCatchAllListener} listener |
61 */ | 60 */ |
62 removeListener(listener) | 61 removeListener(listener) |
63 { | 62 { |
64 this.off(CATCH_ALL, listener); | 63 this.off(CATCH_ALL, listener); |
65 }, | 64 }, |
66 | 65 |
67 /** | 66 /** |
68 * Notifies listeners about an event | 67 * Notifies listeners about an event |
69 * @param {string} action event code ("load", "save", "elemhideupdate", | 68 * @param {string} action event code ("load", "save", "elemhideupdate", |
70 * "subscription.added", "subscription.removed", | 69 * "subscription.added", "subscription.removed", |
71 * "subscription.disabled", "subscription.title", | 70 * "subscription.disabled", "subscription.title", |
72 * "subscription.lastDownload", "subscription.downloadStatus", | 71 * "subscription.lastDownload", "subscription.downloadStatus", |
73 * "subscription.homepage", "subscription.updated", | 72 * "subscription.homepage", "subscription.updated", |
74 * "filter.added", "filter.removed", "filter.moved", | 73 * "filter.added", "filter.removed", "filter.moved", |
75 * "filter.disabled", "filter.hitCount", "filter.lastHit") | 74 * "filter.disabled", "filter.hitCount", "filter.lastHit") |
76 * @param {Subscription|Filter} item item that the change applies to | 75 * @param {Subscription|Filter} item item that the change applies to |
77 * @param {*} param1 | 76 * @param {*} param1 |
78 * @param {*} param2 | 77 * @param {*} param2 |
79 * @param {*} param3 | 78 * @param {*} param3 |
80 * @deprecated use FilterNotifier.emit(action) | 79 * @deprecated use FilterNotifier.emit(action) |
81 */ | 80 */ |
82 triggerListeners(action, item, param1, param2, param3) | 81 triggerListeners(action, item, param1, param2, param3) |
83 { | 82 { |
84 this.emit(action, item, param1, param2, param3); | 83 this.emit(action, item, param1, param2, param3); |
85 this.emit(CATCH_ALL, action, item, param1, param2, param3); | 84 this.emit(CATCH_ALL, action, item, param1, param2, param3); |
86 } | 85 } |
87 })); | 86 })); |
LEFT | RIGHT |