| LEFT | RIGHT |
| (no file at all) | |
| 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 /** @module messaging */ | 18 /** @module messaging */ |
| 19 | 19 |
| 20 "use strict"; | 20 "use strict"; |
| 21 | 21 |
| 22 let {EventEmitter} = require("events"); | 22 const {EventEmitter} = require("events"); |
| 23 | 23 |
| 24 /** | 24 /** |
| 25 * Communication port wrapping ext.onMessage to receive messages. | 25 * Communication port wrapping ext.onMessage to receive messages. |
| 26 * | 26 * |
| 27 * @constructor | 27 * @constructor |
| 28 */ | 28 */ |
| 29 function Port() | 29 function Port() |
| 30 { | 30 { |
| 31 this._eventEmitter = new EventEmitter(); | 31 this._eventEmitter = new EventEmitter(); |
| 32 this._onMessage = this._onMessage.bind(this); | 32 this._onMessage = this._onMessage.bind(this); |
| 33 ext.onMessage.addListener(this._onMessage); | 33 ext.onMessage.addListener(this._onMessage); |
| 34 }; | 34 }; |
| 35 | 35 |
| 36 Port.prototype = { | 36 Port.prototype = { |
| 37 _onMessage: function(message, sender, sendResponse) | 37 _onMessage(message, sender, sendResponse) |
| 38 { | 38 { |
| 39 let async = false; | 39 let async = false; |
| 40 let callbacks = this._eventEmitter.listeners(message.type); | 40 let callbacks = this._eventEmitter.listeners(message.type); |
| 41 | 41 |
| 42 for (let callback of callbacks) | 42 for (let callback of callbacks) |
| 43 { | 43 { |
| 44 let response = callback(message, sender); | 44 let response = callback(message, sender); |
| 45 | 45 |
| 46 if (response && typeof response.then == "function") | 46 if (response && typeof response.then == "function") |
| 47 { | 47 { |
| (...skipping 26 matching lines...) Expand all Loading... |
| 74 * or a promise (asynchronous response). | 74 * or a promise (asynchronous response). |
| 75 */ | 75 */ |
| 76 | 76 |
| 77 /** | 77 /** |
| 78 * Adds a callback for the specified message. | 78 * Adds a callback for the specified message. |
| 79 * | 79 * |
| 80 * The return value of the callback (if not undefined) is sent as response. | 80 * The return value of the callback (if not undefined) is sent as response. |
| 81 * @param {string} name | 81 * @param {string} name |
| 82 * @param {Port~messageCallback} callback | 82 * @param {Port~messageCallback} callback |
| 83 */ | 83 */ |
| 84 on: function(name, callback) | 84 on(name, callback) |
| 85 { | 85 { |
| 86 this._eventEmitter.on(name, callback); | 86 this._eventEmitter.on(name, callback); |
| 87 }, | 87 }, |
| 88 | 88 |
| 89 /** | 89 /** |
| 90 * Removes a callback for the specified message. | 90 * Removes a callback for the specified message. |
| 91 * | 91 * |
| 92 * @param {string} name | 92 * @param {string} name |
| 93 * @param {Port~messageCallback} callback | 93 * @param {Port~messageCallback} callback |
| 94 */ | 94 */ |
| 95 off: function(name, callback) | 95 off(name, callback) |
| 96 { | 96 { |
| 97 this._eventEmitter.off(name, callback); | 97 this._eventEmitter.off(name, callback); |
| 98 }, | 98 }, |
| 99 | 99 |
| 100 /** | 100 /** |
| 101 * Disables the port and makes it stop listening to incoming messages. | 101 * Disables the port and makes it stop listening to incoming messages. |
| 102 */ | 102 */ |
| 103 disconnect: function() | 103 disconnect() |
| 104 { | 104 { |
| 105 ext.onMessage.removeListener(this._onMessage); | 105 ext.onMessage.removeListener(this._onMessage); |
| 106 } | 106 } |
| 107 }; | 107 }; |
| 108 | 108 |
| 109 /** | 109 /** |
| 110 * The default port to receive messages. | 110 * The default port to receive messages. |
| 111 * | 111 * |
| 112 * @type {Port} | 112 * @type {Port} |
| 113 */ | 113 */ |
| 114 exports.port = new Port(); | 114 exports.port = new Port(); |
| 115 | 115 |
| 116 /** | 116 /** |
| 117 * Creates a new port that is disconnected when the given window is unloaded. | 117 * Creates a new port that is disconnected when the given window is unloaded. |
| 118 * | 118 * |
| 119 * @param {Window} window | 119 * @param {Window} window |
| 120 * @return {Port} | 120 * @return {Port} |
| 121 */ | 121 */ |
| 122 exports.getPort = function(window) | 122 exports.getPort = function(window) |
| 123 { | 123 { |
| 124 let port = new Port(); | 124 let port = new Port(); |
| 125 window.addEventListener("unload", () => | 125 window.addEventListener("unload", () => |
| 126 { | 126 { |
| 127 port.disconnect(); | 127 port.disconnect(); |
| 128 }); | 128 }); |
| 129 return port; | 129 return port; |
| 130 }; | 130 }; |
| 131 | 131 |
| LEFT | RIGHT |