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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
'use strict';
const { Trait } = require("../deprecated/traits");
const { EventEmitter } = require("../deprecated/events");
const { defer } = require("../lang/functional");
const { EVENTS } = require("./events");
const { getThumbnailURIForWindow } = require("../content/thumbnail");
const { getFaviconURIForLocation } = require("../io/data");
const { activateTab, getOwnerWindow, getBrowserForTab, getTabTitle, setTabTitle,
getTabURL, setTabURL, getTabContentType } = require('./utils');
// Array of the inner instances of all the wrapped tabs.
const TABS = [];
/**
* Trait used to create tab wrappers.
*/
const TabTrait = Trait.compose(EventEmitter, {
on: Trait.required,
_emit: Trait.required,
/**
* Tab DOM element that is being wrapped.
*/
_tab: null,
/**
* Window wrapper whose tab this object represents.
*/
window: null,
constructor: function Tab(options) {
this._onReady = this._onReady.bind(this);
this._tab = options.tab;
let window = this.window = options.window || getOwnerWindow(this._tab);
// Setting event listener if was passed.
for each (let type in EVENTS) {
let listener = options[type.listener];
if (listener)
this.on(type.name, options[type.listener]);
if ('ready' != type.name) // window spreads this event.
window.tabs.on(type.name, this._onEvent.bind(this, type.name));
}
this.on(EVENTS.close.name, this.destroy.bind(this));
this._browser.addEventListener(EVENTS.ready.dom, this._onReady, true);
if (options.isPinned)
this.pin();
// Since we will have to identify tabs by a DOM elements facade function
// is used as constructor that collects all the instances and makes sure
// that they more then one wrapper is not created per tab.
return this;
},
destroy: function destroy() {
this._removeAllListeners();
this._browser.removeEventListener(EVENTS.ready.dom, this._onReady, true);
},
/**
* Internal listener that emits public event 'ready' when the page of this
* tab is loaded.
*/
_onReady: function _onReady(event) {
// IFrames events will bubble so we need to ignore those.
if (event.target == this._contentDocument)
this._emit(EVENTS.ready.name, this._public);
},
/**
* Internal tab event router. Window will emit tab related events for all it's
* tabs, this listener will propagate all the events for this tab to it's
* listeners.
*/
_onEvent: function _onEvent(type, tab) {
if (tab == this._public)
this._emit(type, tab);
},
/**
* Browser DOM element where page of this tab is currently loaded.
*/
get _browser() getBrowserForTab(this._tab),
/**
* Window DOM element containing this tab.
*/
get _window() getOwnerWindow(this._tab),
/**
* Document object of the page that is currently loaded in this tab.
*/
get _contentDocument() this._browser.contentDocument,
/**
* Window object of the page that is currently loaded in this tab.
*/
get _contentWindow() this._browser.contentWindow,
/**
* The title of the page currently loaded in the tab.
* Changing this property changes an actual title.
* @type {String}
*/
get title() getTabTitle(this._tab),
set title(title) setTabTitle(this._tab, title),
/**
* Returns the MIME type that the document loaded in the tab is being
* rendered as.
* @type {String}
*/
get contentType() getTabContentType(this._tab),
/**
* Location of the page currently loaded in this tab.
* Changing this property will loads page under under the specified location.
* @type {String}
*/
get url() getTabURL(this._tab),
set url(url) setTabURL(this._tab, url),
/**
* URI of the favicon for the page currently loaded in this tab.
* @type {String}
*/
get favicon() getFaviconURIForLocation(this.url),
/**
* The CSS style for the tab
*/
get style() null, // TODO
/**
* The index of the tab relative to other tabs in the application window.
* Changing this property will change order of the actual position of the tab.
* @type {Number}
*/
get index()
this._window.gBrowser.getBrowserIndexForDocument(this._contentDocument),
set index(value) this._window.gBrowser.moveTabTo(this._tab, value),
/**
* Thumbnail data URI of the page currently loaded in this tab.
* @type {String}
*/
getThumbnail: function getThumbnail()
getThumbnailURIForWindow(this._contentWindow),
/**
* Whether or not tab is pinned (Is an app-tab).
* @type {Boolean}
*/
get isPinned() this._tab.pinned,
pin: function pin() {
this._window.gBrowser.pinTab(this._tab);
},
unpin: function unpin() {
this._window.gBrowser.unpinTab(this._tab);
},
/**
* Create a worker for this tab, first argument is options given to Worker.
* @type {Worker}
*/
attach: function attach(options) {
// BUG 792946 https://bugzilla.mozilla.org/show_bug.cgi?id=792946
// TODO: fix this circular dependency
let { Worker } = require('./worker');
return Worker(options, this._contentWindow);
},
/**
* Make this tab active.
* Please note: That this function is called asynchronous since in E10S that
* will be the case. Besides this function is called from a constructor where
* we would like to return instance before firing a 'TabActivated' event.
*/
activate: defer(function activate() {
activateTab(this._tab);
}),
/**
* Close the tab
*/
close: function close(callback) {
if (callback)
this.once(EVENTS.close.name, callback);
this._window.gBrowser.removeTab(this._tab);
},
/**
* Reload the tab
*/
reload: function reload() {
this._window.gBrowser.reloadTab(this._tab);
}
});
function Tab(options) {
let chromeTab = options.tab;
for each (let tab in TABS) {
if (chromeTab == tab._tab)
return tab._public;
}
let tab = TabTrait(options);
TABS.push(tab);
return tab._public;
}
Tab.prototype = TabTrait.prototype;
exports.Tab = Tab;
|
