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 #ifndef V8_INSPECTOR_JAVASCRIPTCALLFRAME_H_
32 #define V8_INSPECTOR_JAVASCRIPTCALLFRAME_H_
33 
34 #include <vector>
35 
36 #include "src/base/macros.h"
37 #include "src/inspector/protocol-platform.h"
38 
39 #include "include/v8.h"
40 
41 namespace v8_inspector {
42 
43 class JavaScriptCallFrame {
44  public:
create(v8::Local<v8::Context> debuggerContext,v8::Local<v8::Object> callFrame)45   static std::unique_ptr<JavaScriptCallFrame> create(
46       v8::Local<v8::Context> debuggerContext, v8::Local<v8::Object> callFrame) {
47     return wrapUnique(new JavaScriptCallFrame(debuggerContext, callFrame));
48   }
49   ~JavaScriptCallFrame();
50 
51   int sourceID() const;
52   int line() const;
53   int column() const;
54   int contextId() const;
55 
56   bool isAtReturn() const;
57   v8::Local<v8::Object> details() const;
58 
59   v8::MaybeLocal<v8::Value> evaluate(v8::Local<v8::Value> expression);
60   v8::MaybeLocal<v8::Value> restart();
61   v8::MaybeLocal<v8::Value> setVariableValue(int scopeNumber,
62                                              v8::Local<v8::Value> variableName,
63                                              v8::Local<v8::Value> newValue);
64 
65  private:
66   JavaScriptCallFrame(v8::Local<v8::Context> debuggerContext,
67                       v8::Local<v8::Object> callFrame);
68 
69   int callV8FunctionReturnInt(const char* name) const;
70 
71   v8::Isolate* m_isolate;
72   v8::Global<v8::Context> m_debuggerContext;
73   v8::Global<v8::Object> m_callFrame;
74 
75   DISALLOW_COPY_AND_ASSIGN(JavaScriptCallFrame);
76 };
77 
78 using JavaScriptCallFrames = std::vector<std::unique_ptr<JavaScriptCallFrame>>;
79 
80 }  // namespace v8_inspector
81 
82 #endif  // V8_INSPECTOR_JAVASCRIPTCALLFRAME_H_
83