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
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
|
// 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 code is used in conjunction with the Google Translate Element script.
// It is injected in a page to translate it from one language to another.
// It should be included in the page before the Translate Element script.
var cr = {};
cr.googleTranslate = (function(key) {
/**
* The Translate Element library's instance.
* @type {object}
*/
var lib;
/**
* A flag representing if the Translate Element library is initialized.
* @type {boolean}
*/
var libReady = false;
/**
* A flag representing if the Translate Element library returns error while
* performing translation. Also it is set to true when the Translate Element
* library is not initialized in 600 msec from the library is loaded.
* @type {boolean}
*/
var error = false;
/**
* A flag representing if the Translate Element has finished a translation.
* @type {boolean}
*/
var finished = false;
/**
* Counts how many times the checkLibReady function is called. The function
* is called in every 100 msec and counted up to 6.
* @type {number}
*/
var checkReadyCount = 0;
/**
* Time in msec when this script is injected.
* @type {number}
*/
var injectedTime = performance.now();
/**
* Time in msec when the Translate Element library is loaded completely.
* @type {number}
*/
var loadedTime = 0.0;
/**
* Time in msec when the Translate Element library is initialized and ready
* for performing translation.
* @type {number}
*/
var readyTime = 0.0;
/**
* Time in msec when the Translate Element library starts a translation.
* @type {number}
*/
var startTime = 0.0;
/**
* Time in msec when the Translate Element library ends a translation.
* @type {number}
*/
var endTime = 0.0;
function checkLibReady() {
if (lib.isAvailable()) {
readyTime = performance.now();
libReady = true;
return;
}
if (checkReadyCount++ > 5) {
error = true;
return;
}
setTimeout(checkLibReady, 100);
}
function onTranslateProgress(progress, opt_finished, opt_error) {
finished = opt_finished;
// opt_error can be 'undefined'.
if (typeof opt_error == 'boolean' && opt_error) {
error = true;
// We failed to translate, restore so the page is in a consistent state.
lib.restore();
}
if (finished)
endTime = performance.now();
}
// Public API.
return {
/**
* Whether the library is ready.
* The translate function should only be called when |libReady| is true.
* @type {boolean}
*/
get libReady() {
return libReady;
},
/**
* Whether the current translate has finished successfully.
* @type {boolean}
*/
get finished() {
return finished;
},
/**
* Whether an error occured initializing the library of translating the
* page.
* @type {boolean}
*/
get error() {
return error;
},
/**
* The language the page translated was in. Is valid only after the page
* has been successfully translated and the original language specified to
* the translate function was 'auto'. Is empty otherwise.
* Some versions of Element library don't provide |getDetectedLanguage|
* function. In that case, this function returns 'und'.
* @type {boolean}
*/
get sourceLang() {
if (!libReady || !finished || error)
return '';
if (!lib.getDetectedLanguage)
return 'und'; // defined as chrome::kUnknownLanguageCode in C++ world.
return lib.getDetectedLanguage();
},
/**
* Time in msec from this script being injected to all server side scripts
* being loaded.
* @type {number}
*/
get loadTime() {
if (loadedTime == 0)
return 0;
return loadedTime - injectedTime;
},
/**
* Time in msec from this script being injected to the Translate Element
* library being ready.
* @type {number}
*/
get readyTime() {
if (!libReady)
return 0;
return readyTime - injectedTime;
},
/**
* Time in msec to perform translation.
* @type {number}
*/
get translationTime() {
if (!finished)
return 0;
return endTime - startTime;
},
/**
* Translate the page contents. Note that the translation is asynchronous.
* You need to regularly check the state of |finished| and |error| to know
* if the translation finished or if there was an error.
* @param {string} originalLang The language the page is in.
* @param {string} targetLang The language the page should be translated to.
* @return {boolean} False if the translate library was not ready, in which
* case the translation is not started. True otherwise.
*/
translate: function(originalLang, targetLang) {
finished = false;
error = false;
if (!libReady)
return false;
startTime = performance.now();
lib.translatePage(originalLang, targetLang, onTranslateProgress);
return true;
},
/**
* Reverts the page contents to its original value, effectively reverting
* any performed translation. Does nothing if the page was not translated.
*/
revert: function() {
lib.restore();
},
/**
* Entry point called by the Translate Element once it has been injected in
* the page.
*/
onTranslateElementLoad: function() {
loadedTime = performance.now();
try {
lib = google.translate.TranslateService({
'key': key,
'useSecureConnection': true
});
} catch (err) {
error = true;
return;
}
// The TranslateService is not available immediately as it needs to start
// Flash. Let's wait until it is ready.
checkLibReady();
}
};
})/* Calling code '(|key|);' will be appended by TranslateHelper in C++ here. */
|
