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
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
/**
* This variable structure is here to document the structure that the template
* expects to correctly populate the page.
*/
/**
* Takes the |experimentalFeaturesData| input argument which represents data
* about all the current feature entries and populates the html jstemplate with
* that data. It expects an object structure like the above.
* @param {Object} experimentalFeaturesData Information about all experiments.
* See returnFlagsExperiments() for the structure of this object.
*/
function renderTemplate(experimentalFeaturesData) {
// This is the javascript code that processes the template:
jstProcess(new JsEvalContext(experimentalFeaturesData), $('flagsTemplate'));
// Add handlers to dynamically created HTML elements.
var elements = document.getElementsByClassName('experiment-select');
for (var i = 0; i < elements.length; ++i) {
elements[i].onchange = function() {
handleSelectExperimentalFeatureChoice(this, this.selectedIndex);
return false;
};
}
elements = document.getElementsByClassName('experiment-disable-link');
for (var i = 0; i < elements.length; ++i) {
elements[i].onclick = function() {
handleEnableExperimentalFeature(this, false);
return false;
};
}
elements = document.getElementsByClassName('experiment-enable-link');
for (var i = 0; i < elements.length; ++i) {
elements[i].onclick = function() {
handleEnableExperimentalFeature(this, true);
return false;
};
}
elements = document.getElementsByClassName('experiment-restart-button');
for (var i = 0; i < elements.length; ++i) {
elements[i].onclick = restartBrowser;
}
$('experiment-reset-all').onclick = resetAllFlags;
highlightReferencedFlag();
}
/**
* Highlight an element associated with the page's location's hash. We need to
* fake fragment navigation with '.scrollIntoView()', since the fragment IDs
* don't actually exist until after the template code runs; normal navigation
* therefore doesn't work.
*/
function highlightReferencedFlag() {
if (window.location.hash) {
var el = document.querySelector(window.location.hash);
if (el && !el.classList.contains('referenced')) {
// Unhighlight whatever's highlighted.
if (document.querySelector('.referenced'))
document.querySelector('.referenced').classList.remove('referenced');
// Highlight the referenced element.
el.classList.add('referenced');
el.scrollIntoView();
}
}
}
/**
* Asks the C++ FlagsDOMHandler to get details about the available experimental
* features and return detailed data about the configuration. The
* FlagsDOMHandler should reply to returnFlagsExperiments() (below).
*/
function requestExperimentalFeaturesData() {
chrome.send('requestExperimentalFeatures');
}
/**
* Asks the C++ FlagsDOMHandler to restart the browser (restoring tabs).
*/
function restartBrowser() {
chrome.send('restartBrowser');
}
/**
* Reset all flags to their default values and refresh the UI.
*/
function resetAllFlags() {
// Asks the C++ FlagsDOMHandler to reset all flags to default values.
chrome.send('resetAllFlags');
requestExperimentalFeaturesData();
}
/**
* Called by the WebUI to re-populate the page with data representing the
* current state of all experimental features.
* @param {Object} experimentalFeaturesData Information about all experimental
* features in the following format:
* {
* supportedFeatures: [
* {
* internal_name: 'Feature ID string',
* name: 'Feature name',
* description: 'Description',
* // enabled and default are only set if the feature is single valued.
* // enabled is true if the feature is currently enabled.
* // is_default is true if the feature is in its default state.
* enabled: true,
* is_default: false,
* // choices is only set if the entry has multiple values.
* choices: [
* {
* internal_name: 'Experimental feature ID string',
* description: 'description',
* selected: true
* }
* ],
* supported_platforms: [
* 'Mac',
* 'Linux'
* ],
* }
* ],
* unsupportedFeatures: [
* // Mirrors the format of |supportedFeatures| above.
* ],
* needsRestart: false,
* showBetaChannelPromotion: false,
* showDevChannelPromotion: false,
* showOwnerWarning: false
* }
*/
function returnExperimentalFeatures(experimentalFeaturesData) {
var bodyContainer = $('body-container');
renderTemplate(experimentalFeaturesData);
if (experimentalFeaturesData.showBetaChannelPromotion)
$('channel-promo-beta').hidden = false;
else if (experimentalFeaturesData.showDevChannelPromotion)
$('channel-promo-dev').hidden = false;
bodyContainer.style.visibility = 'visible';
var ownerWarningDiv = $('owner-warning');
if (ownerWarningDiv)
ownerWarningDiv.hidden = !experimentalFeaturesData.showOwnerWarning;
}
/**
* Handles a 'enable' or 'disable' button getting clicked.
* @param {HTMLElement} node The node for the experiment being changed.
* @param {boolean} enable Whether to enable or disable the experiment.
*/
function handleEnableExperimentalFeature(node, enable) {
// Tell the C++ FlagsDOMHandler to enable/disable the experiment.
chrome.send('enableExperimentalFeature', [String(node.internal_name),
String(enable)]);
requestExperimentalFeaturesData();
}
/**
* Invoked when the selection of a multi-value choice is changed to the
* specified index.
* @param {HTMLElement} node The node for the experiment being changed.
* @param {number} index The index of the option that was selected.
*/
function handleSelectExperimentalFeatureChoice(node, index) {
// Tell the C++ FlagsDOMHandler to enable the selected choice.
chrome.send('enableExperimentalFeature',
[String(node.internal_name) + '@' + index, 'true']);
requestExperimentalFeaturesData();
}
// Get data and have it displayed upon loading.
document.addEventListener('DOMContentLoaded', requestExperimentalFeaturesData);
// Update the highlighted flag when the hash changes.
window.addEventListener('hashchange', highlightReferencedFlag);
|
