Using observers: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
No edit summary
(content moved to mdc)
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
An extension overlaying the Firefox browser window will have one "instance" for each window, that is completely separate from all other windows - you cannot share variables. There are several ways to implement cross-window communication - probably the most convenient one is using observers.
See [http://developer.mozilla.org/en/docs/nsIObserver nsIObserver] and [http://developer.mozilla.org/en/docs/nsIObserverService nsIObserverService] at [http://developer.mozilla.org MDC].


==Observer class==
[[Category:Redirects]]
Each observer may register for one or more '''topics'''. For each notification, its '''observe''' function is called with the '''subject''' (can be null), the '''topic''' and additional '''data'''. All three parameters can be freely used by the code invoking the notification, see "Notify all observers" below.
 
function myObserver()
{
  this.register();
}
myObserver.prototype = {
  observe: function(subject, topic, data) {
      // Do your stuff here.
  },
  register: function() {
    var observerService = Components.classes["@mozilla.org/observer-service;1"]
                          .getService(Components.interfaces.nsIObserverService);
    observerService.addObserver(this, "myTopicID", false);
  },
  unregister: function() {
    var observerService = Components.classes["@mozilla.org/observer-service;1"]
                            .getService(Components.interfaces.nsIObserverService);
    observerService.removeObserver(this, "myTopicID");
  }
}
 
==Instantiate & Register==
Do the following in your init function (probably an onload handler) for each window:
var observer = new myObserver();
observer.register();
To do things cleanly, you should also unregister your observer when the window is closed.
 
==Notify all observers==
Components.classes["@mozilla.org/observer-service;1"]
          .getService(Components.interfaces.nsIObserverService)
          .notifyObservers(null, "myTopicID", "someAdditionalInformationPassedAs'Data'Parameter");

Latest revision as of 20:29, 23 May 2007