OLD | NEW |
| (Empty) |
1 /* | |
2 * Copyright (C) 2010 Google Inc. All rights reserved. | |
3 * | |
4 * Redistribution and use in source and binary forms, with or without | |
5 * modification, are permitted provided that the following conditions are | |
6 * met: | |
7 * | |
8 * * Redistributions of source code must retain the above copyright | |
9 * notice, this list of conditions and the following disclaimer. | |
10 * * Redistributions in binary form must reproduce the above | |
11 * copyright notice, this list of conditions and the following disclaimer | |
12 * in the documentation and/or other materials provided with the | |
13 * distribution. | |
14 * * Neither the name of Google Inc. nor the names of its | |
15 * contributors may be used to endorse or promote products derived from | |
16 * this software without specific prior written permission. | |
17 * | |
18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | |
21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |
23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |
24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |
25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | |
26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
29 */ | |
30 | |
31 (function () { | |
32 | |
33 var DebuggerScript = {}; | |
34 | |
35 DebuggerScript.PauseOnExceptionsState = { | |
36 DontPauseOnExceptions: 0, | |
37 PauseOnAllExceptions: 1, | |
38 PauseOnUncaughtExceptions: 2 | |
39 }; | |
40 | |
41 DebuggerScript.ScopeInfoDetails = { | |
42 AllScopes: 0, | |
43 FastAsyncScopes: 1, | |
44 NoScopes: 2 | |
45 }; | |
46 | |
47 DebuggerScript._pauseOnExceptionsState = DebuggerScript.PauseOnExceptionsState.D
ontPauseOnExceptions; | |
48 Debug.clearBreakOnException(); | |
49 Debug.clearBreakOnUncaughtException(); | |
50 | |
51 DebuggerScript.getAfterCompileScript = function(eventData) | |
52 { | |
53 return DebuggerScript._formatScript(eventData.script_.script_); | |
54 } | |
55 | |
56 DebuggerScript.getWorkerScripts = function() | |
57 { | |
58 var result = []; | |
59 var scripts = Debug.scripts(); | |
60 for (var i = 0; i < scripts.length; ++i) { | |
61 var script = scripts[i]; | |
62 // Workers don't share same V8 heap now so there is no need to complicat
e stuff with | |
63 // the context id like we do to discriminate between scripts from differ
ent pages. | |
64 // However we need to filter out v8 native scripts. | |
65 if (script.context_data && script.context_data === "worker") | |
66 result.push(DebuggerScript._formatScript(script)); | |
67 } | |
68 return result; | |
69 } | |
70 | |
71 DebuggerScript.getFunctionScopes = function(fun) | |
72 { | |
73 var mirror = MakeMirror(fun); | |
74 var count = mirror.scopeCount(); | |
75 if (count == 0) | |
76 return null; | |
77 var result = []; | |
78 for (var i = 0; i < count; i++) { | |
79 var scopeDetails = mirror.scope(i).details(); | |
80 result[i] = { | |
81 type: scopeDetails.type(), | |
82 object: DebuggerScript._buildScopeObject(scopeDetails.type(), scopeD
etails.object()) | |
83 }; | |
84 } | |
85 return result; | |
86 } | |
87 | |
88 DebuggerScript.getInternalProperties = function(value) | |
89 { | |
90 var properties = ObjectMirror.GetInternalProperties(value); | |
91 var result = []; | |
92 for (var i = 0; i < properties.length; i++) { | |
93 var mirror = properties[i]; | |
94 result.push({ | |
95 name: mirror.name(), | |
96 value: mirror.value().value() | |
97 }); | |
98 } | |
99 return result; | |
100 } | |
101 | |
102 DebuggerScript.setFunctionVariableValue = function(functionValue, scopeIndex, va
riableName, newValue) | |
103 { | |
104 var mirror = MakeMirror(functionValue); | |
105 if (!mirror.isFunction()) | |
106 throw new Error("Function value has incorrect type"); | |
107 return DebuggerScript._setScopeVariableValue(mirror, scopeIndex, variableNam
e, newValue); | |
108 } | |
109 | |
110 DebuggerScript._setScopeVariableValue = function(scopeHolder, scopeIndex, variab
leName, newValue) | |
111 { | |
112 var scopeMirror = scopeHolder.scope(scopeIndex); | |
113 if (!scopeMirror) | |
114 throw new Error("Incorrect scope index"); | |
115 scopeMirror.setVariableValue(variableName, newValue); | |
116 return undefined; | |
117 } | |
118 | |
119 DebuggerScript.getScripts = function(contextData) | |
120 { | |
121 var result = []; | |
122 | |
123 if (!contextData) | |
124 return result; | |
125 var comma = contextData.indexOf(","); | |
126 if (comma === -1) | |
127 return result; | |
128 // Context data is a string in the following format: | |
129 // ("page"|"injected")","<page id> | |
130 var idSuffix = contextData.substring(comma); // including the comma | |
131 | |
132 var scripts = Debug.scripts(); | |
133 for (var i = 0; i < scripts.length; ++i) { | |
134 var script = scripts[i]; | |
135 if (script.context_data && script.context_data.lastIndexOf(idSuffix) !=
-1) | |
136 result.push(DebuggerScript._formatScript(script)); | |
137 } | |
138 return result; | |
139 } | |
140 | |
141 DebuggerScript._formatScript = function(script) | |
142 { | |
143 var lineEnds = script.line_ends; | |
144 var lineCount = lineEnds.length; | |
145 var endLine = script.line_offset + lineCount - 1; | |
146 var endColumn; | |
147 // V8 will not count last line if script source ends with \n. | |
148 if (script.source[script.source.length - 1] === '\n') { | |
149 endLine += 1; | |
150 endColumn = 0; | |
151 } else { | |
152 if (lineCount === 1) | |
153 endColumn = script.source.length + script.column_offset; | |
154 else | |
155 endColumn = script.source.length - (lineEnds[lineCount - 2] + 1); | |
156 } | |
157 | |
158 return { | |
159 id: script.id, | |
160 name: script.nameOrSourceURL(), | |
161 source: script.source, | |
162 startLine: script.line_offset, | |
163 startColumn: script.column_offset, | |
164 endLine: endLine, | |
165 endColumn: endColumn, | |
166 isContentScript: !!script.context_data && script.context_data.indexOf("i
njected") == 0 | |
167 }; | |
168 } | |
169 | |
170 DebuggerScript.setBreakpoint = function(execState, info) | |
171 { | |
172 var positionAlignment = info.interstatementLocation ? Debug.BreakPositionAli
gnment.BreakPosition : Debug.BreakPositionAlignment.Statement; | |
173 var breakId = Debug.setScriptBreakPointById(info.sourceID, info.lineNumber,
info.columnNumber, info.condition, undefined, positionAlignment); | |
174 | |
175 var locations = Debug.findBreakPointActualLocations(breakId); | |
176 if (!locations.length) | |
177 return undefined; | |
178 info.lineNumber = locations[0].line; | |
179 info.columnNumber = locations[0].column; | |
180 return breakId.toString(); | |
181 } | |
182 | |
183 DebuggerScript.removeBreakpoint = function(execState, info) | |
184 { | |
185 Debug.findBreakPoint(info.breakpointId, true); | |
186 } | |
187 | |
188 DebuggerScript.pauseOnExceptionsState = function() | |
189 { | |
190 return DebuggerScript._pauseOnExceptionsState; | |
191 } | |
192 | |
193 DebuggerScript.setPauseOnExceptionsState = function(newState) | |
194 { | |
195 DebuggerScript._pauseOnExceptionsState = newState; | |
196 | |
197 if (DebuggerScript.PauseOnExceptionsState.PauseOnAllExceptions === newState) | |
198 Debug.setBreakOnException(); | |
199 else | |
200 Debug.clearBreakOnException(); | |
201 | |
202 if (DebuggerScript.PauseOnExceptionsState.PauseOnUncaughtExceptions === newS
tate) | |
203 Debug.setBreakOnUncaughtException(); | |
204 else | |
205 Debug.clearBreakOnUncaughtException(); | |
206 } | |
207 | |
208 DebuggerScript.frameCount = function(execState) | |
209 { | |
210 return execState.frameCount(); | |
211 } | |
212 | |
213 DebuggerScript.currentCallFrame = function(execState, data) | |
214 { | |
215 var maximumLimit = data >> 2; | |
216 var scopeDetailsLevel = data & 3; | |
217 | |
218 var frameCount = execState.frameCount(); | |
219 if (maximumLimit && maximumLimit < frameCount) | |
220 frameCount = maximumLimit; | |
221 var topFrame = undefined; | |
222 for (var i = frameCount - 1; i >= 0; i--) { | |
223 var frameMirror = execState.frame(i); | |
224 topFrame = DebuggerScript._frameMirrorToJSCallFrame(frameMirror, topFram
e, scopeDetailsLevel); | |
225 } | |
226 return topFrame; | |
227 } | |
228 | |
229 DebuggerScript.stepIntoStatement = function(execState) | |
230 { | |
231 execState.prepareStep(Debug.StepAction.StepIn, 1); | |
232 } | |
233 | |
234 DebuggerScript.stepOverStatement = function(execState, callFrame) | |
235 { | |
236 execState.prepareStep(Debug.StepAction.StepNext, 1); | |
237 } | |
238 | |
239 DebuggerScript.stepOutOfFunction = function(execState, callFrame) | |
240 { | |
241 execState.prepareStep(Debug.StepAction.StepOut, 1); | |
242 } | |
243 | |
244 // Returns array in form: | |
245 // [ 0, <v8_result_report> ] in case of success | |
246 // or [ 1, <general_error_message>, <compiler_message>, <line_number>, <column
_number> ] in case of compile error, numbers are 1-based. | |
247 // or throws exception with message. | |
248 DebuggerScript.liveEditScriptSource = function(scriptId, newSource, preview) | |
249 { | |
250 var scripts = Debug.scripts(); | |
251 var scriptToEdit = null; | |
252 for (var i = 0; i < scripts.length; i++) { | |
253 if (scripts[i].id == scriptId) { | |
254 scriptToEdit = scripts[i]; | |
255 break; | |
256 } | |
257 } | |
258 if (!scriptToEdit) | |
259 throw("Script not found"); | |
260 | |
261 var changeLog = []; | |
262 try { | |
263 var result = Debug.LiveEdit.SetScriptSource(scriptToEdit, newSource, pre
view, changeLog); | |
264 return [0, result]; | |
265 } catch (e) { | |
266 if (e instanceof Debug.LiveEdit.Failure && "details" in e) { | |
267 var details = e.details; | |
268 if (details.type === "liveedit_compile_error") { | |
269 var startPosition = details.position.start; | |
270 return [1, String(e), String(details.syntaxErrorMessage), Number
(startPosition.line), Number(startPosition.column)]; | |
271 } | |
272 } | |
273 throw e; | |
274 } | |
275 } | |
276 | |
277 DebuggerScript.clearBreakpoints = function(execState, info) | |
278 { | |
279 Debug.clearAllBreakPoints(); | |
280 } | |
281 | |
282 DebuggerScript.setBreakpointsActivated = function(execState, info) | |
283 { | |
284 Debug.debuggerFlags().breakPointsActive.setValue(info.enabled); | |
285 } | |
286 | |
287 DebuggerScript.getScriptSource = function(eventData) | |
288 { | |
289 return eventData.script().source(); | |
290 } | |
291 | |
292 DebuggerScript.setScriptSource = function(eventData, source) | |
293 { | |
294 if (eventData.script().data() === "injected-script") | |
295 return; | |
296 eventData.script().setSource(source); | |
297 } | |
298 | |
299 DebuggerScript.getScriptName = function(eventData) | |
300 { | |
301 return eventData.script().script_.nameOrSourceURL(); | |
302 } | |
303 | |
304 DebuggerScript.getBreakpointNumbers = function(eventData) | |
305 { | |
306 var breakpoints = eventData.breakPointsHit(); | |
307 var numbers = []; | |
308 if (!breakpoints) | |
309 return numbers; | |
310 | |
311 for (var i = 0; i < breakpoints.length; i++) { | |
312 var breakpoint = breakpoints[i]; | |
313 var scriptBreakPoint = breakpoint.script_break_point(); | |
314 numbers.push(scriptBreakPoint ? scriptBreakPoint.number() : breakpoint.n
umber()); | |
315 } | |
316 return numbers; | |
317 } | |
318 | |
319 DebuggerScript.isEvalCompilation = function(eventData) | |
320 { | |
321 var script = eventData.script(); | |
322 return (script.compilationType() === Debug.ScriptCompilationType.Eval); | |
323 } | |
324 | |
325 // NOTE: This function is performance critical, as it can be run on every | |
326 // statement that generates an async event (like addEventListener) to support | |
327 // asynchronous call stacks. Thus, when possible, initialize the data lazily. | |
328 DebuggerScript._frameMirrorToJSCallFrame = function(frameMirror, callerFrame, sc
opeDetailsLevel) | |
329 { | |
330 // Stuff that can not be initialized lazily (i.e. valid while paused with a
valid break_id). | |
331 // The frameMirror and scopeMirror can be accessed only while paused on the
debugger. | |
332 var frameDetails = frameMirror.details(); | |
333 | |
334 var funcObject = frameDetails.func(); | |
335 var sourcePosition = frameDetails.sourcePosition(); | |
336 var thisObject = frameDetails.receiver(); | |
337 | |
338 var isAtReturn = !!frameDetails.isAtReturn(); | |
339 var returnValue = isAtReturn ? frameDetails.returnValue() : undefined; | |
340 | |
341 var scopeMirrors = (scopeDetailsLevel === DebuggerScript.ScopeInfoDetails.No
Scopes ? [] : frameMirror.allScopes(scopeDetailsLevel === DebuggerScript.ScopeIn
foDetails.FastAsyncScopes)); | |
342 var scopeTypes = new Array(scopeMirrors.length); | |
343 var scopeObjects = new Array(scopeMirrors.length); | |
344 for (var i = 0; i < scopeMirrors.length; ++i) { | |
345 var scopeDetails = scopeMirrors[i].details(); | |
346 scopeTypes[i] = scopeDetails.type(); | |
347 scopeObjects[i] = scopeDetails.object(); | |
348 } | |
349 | |
350 // Calculated lazily. | |
351 var scopeChain; | |
352 var funcMirror; | |
353 var location; | |
354 | |
355 function lazyScopeChain() | |
356 { | |
357 if (!scopeChain) { | |
358 scopeChain = []; | |
359 for (var i = 0; i < scopeObjects.length; ++i) | |
360 scopeChain.push(DebuggerScript._buildScopeObject(scopeTypes[i],
scopeObjects[i])); | |
361 scopeObjects = null; // Free for GC. | |
362 } | |
363 return scopeChain; | |
364 } | |
365 | |
366 function ensureFuncMirror() | |
367 { | |
368 if (!funcMirror) { | |
369 funcMirror = MakeMirror(funcObject); | |
370 if (!funcMirror.isFunction()) | |
371 funcMirror = new UnresolvedFunctionMirror(funcObject); | |
372 } | |
373 return funcMirror; | |
374 } | |
375 | |
376 function ensureLocation() | |
377 { | |
378 if (!location) { | |
379 var script = ensureFuncMirror().script(); | |
380 if (script) | |
381 location = script.locationFromPosition(sourcePosition, true); | |
382 if (!location) | |
383 location = { line: 0, column: 0 }; | |
384 } | |
385 return location; | |
386 } | |
387 | |
388 function line() | |
389 { | |
390 return ensureLocation().line; | |
391 } | |
392 | |
393 function column() | |
394 { | |
395 return ensureLocation().column; | |
396 } | |
397 | |
398 function sourceID() | |
399 { | |
400 var script = ensureFuncMirror().script(); | |
401 return script && script.id(); | |
402 } | |
403 | |
404 function functionName() | |
405 { | |
406 var func = ensureFuncMirror(); | |
407 if (!func.resolved()) | |
408 return undefined; | |
409 var displayName; | |
410 var valueMirror = func.property("displayName").value(); | |
411 if (valueMirror && valueMirror.isString()) | |
412 displayName = valueMirror.value(); | |
413 return displayName || func.name() || func.inferredName(); | |
414 } | |
415 | |
416 function evaluate(expression) | |
417 { | |
418 return frameMirror.evaluate(expression, false).value(); | |
419 } | |
420 | |
421 function restart() | |
422 { | |
423 return Debug.LiveEdit.RestartFrame(frameMirror); | |
424 } | |
425 | |
426 function setVariableValue(scopeNumber, variableName, newValue) | |
427 { | |
428 return DebuggerScript._setScopeVariableValue(frameMirror, scopeNumber, v
ariableName, newValue); | |
429 } | |
430 | |
431 function stepInPositions() | |
432 { | |
433 var stepInPositionsV8 = frameMirror.stepInPositions(); | |
434 var stepInPositionsProtocol; | |
435 if (stepInPositionsV8) { | |
436 stepInPositionsProtocol = []; | |
437 var script = ensureFuncMirror().script(); | |
438 if (script) { | |
439 var scriptId = String(script.id()); | |
440 for (var i = 0; i < stepInPositionsV8.length; i++) { | |
441 var item = { | |
442 scriptId: scriptId, | |
443 lineNumber: stepInPositionsV8[i].position.line, | |
444 columnNumber: stepInPositionsV8[i].position.column | |
445 }; | |
446 stepInPositionsProtocol.push(item); | |
447 } | |
448 } | |
449 } | |
450 return JSON.stringify(stepInPositionsProtocol); | |
451 } | |
452 | |
453 return { | |
454 "sourceID": sourceID, | |
455 "line": line, | |
456 "column": column, | |
457 "functionName": functionName, | |
458 "thisObject": thisObject, | |
459 "scopeChain": lazyScopeChain, | |
460 "scopeType": scopeTypes, | |
461 "evaluate": evaluate, | |
462 "caller": callerFrame, | |
463 "restart": restart, | |
464 "setVariableValue": setVariableValue, | |
465 "stepInPositions": stepInPositions, | |
466 "isAtReturn": isAtReturn, | |
467 "returnValue": returnValue | |
468 }; | |
469 } | |
470 | |
471 DebuggerScript._buildScopeObject = function(scopeType, scopeObject) | |
472 { | |
473 var result; | |
474 switch (scopeType) { | |
475 case ScopeType.Local: | |
476 case ScopeType.Closure: | |
477 case ScopeType.Catch: | |
478 // For transient objects we create a "persistent" copy that contains | |
479 // the same properties. | |
480 // Reset scope object prototype to null so that the proto properties | |
481 // don't appear in the local scope section. | |
482 result = { __proto__: null }; | |
483 var properties = MakeMirror(scopeObject, true /* transient */).propertie
s(); | |
484 for (var j = 0; j < properties.length; j++) { | |
485 var name = properties[j].name(); | |
486 if (name.charAt(0) === ".") | |
487 continue; // Skip internal variables like ".arguments" | |
488 result[name] = properties[j].value_; | |
489 } | |
490 break; | |
491 case ScopeType.Global: | |
492 case ScopeType.With: | |
493 result = scopeObject; | |
494 break; | |
495 case ScopeType.Block: | |
496 // Unsupported yet. Mustn't be reachable. | |
497 break; | |
498 } | |
499 return result; | |
500 } | |
501 | |
502 // We never resolve Mirror by its handle so to avoid memory leaks caused by Mirr
ors in the cache we disable it. | |
503 ToggleMirrorCache(false); | |
504 | |
505 return DebuggerScript; | |
506 })(); | |
OLD | NEW |