aboutsummaryrefslogtreecommitdiff
path: root/tools/addon-sdk-1.4/packages/api-utils/docs/namespace.md
blob: 4a308b85bfdcd3315e6e306a76ccb1f31436c651 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
Provides an API for creating namespaces for any given objects, which
effectively may be used for creating fields that are not part of objects
public API.

      let { Namespace } = require('api-utils/namespace');
      let ns = Namespace();

      ns(publicAPI).secret = secret;

One namespace may be used with multiple objects:

      let { Namespace } = require('api-utils/namespace');
      let dom = Namespace();

      function View(element) {
        let view = Object.create(View.prototype);
        dom(view).element = element;
        // ....
      }
      View.prototype.destroy = function destroy() {
        let { element } = dom(this);
        element.parentNode.removeChild(element);
        // ...
      };
      // ...
      exports.View = View;
      // ...

Also, multiple namespaces can be used with one object:

      // ./widget.js

      let { Cu } = require('chrome');
      let { Namespace } = require('api-utils/namespace');
      let { View } = require('./view');

      // Note this is completely independent from View's internal Namespace object.
      let ns = Namespace();

      function Widget(options) {
        let { element, contentScript } = options;
        let widget = Object.create(Widget.prototype);
        View.call(widget, options.element);
        ns(widget).sandbox = Cu.Sandbox(element.ownerDocument.defaultView);
        // ...
      }
      Widget.prototype = Object.create(View.prototype);
      Widget.prototype.postMessage = function postMessage(message) {
        let { sandbox } = ns(this);
        sandbox.postMessage(JSON.stringify(JSON.parse(message)));
        ...
      };
      Widget.prototype.destroy = function destroy() {
        View.prototype.destroy.call(this);
        // ...
        delete ns(this).sandbox;
      };
      exports.Widget = Widget;

In addition access to the namespace can be shared with other code by just
handing them a namespace accessor function.

      let { dom } = require('./view');
      Widget.prototype.setInnerHTML = function setInnerHTML(html) {
        dom(this).element.innerHTML = String(html);
      };