1// Copyright 2016 the V8 project authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef V8_INSPECTOR_WASMTRANSLATION_H_
6#define V8_INSPECTOR_WASMTRANSLATION_H_
7
8#include <unordered_map>
9
10#include "include/v8.h"
11#include "src/base/macros.h"
12#include "src/debug/debug-interface.h"
13#include "src/inspector/string-16.h"
14
15namespace v8_inspector {
16
17// Forward declarations.
18class V8DebuggerAgentImpl;
19
20class WasmTranslation {
21 public:
22  enum Mode { Raw, Disassemble };
23
24  explicit WasmTranslation(v8::Isolate* isolate);
25  ~WasmTranslation();
26
27  // Set translation mode.
28  void SetMode(Mode mode) { mode_ = mode; }
29
30  // Make a wasm script known to the translation. This will trigger a number of
31  // didParseScript calls to the given debugger agent.
32  // Only locations referencing a registered script will be translated by the
33  // Translate functions below.
34  void AddScript(v8::Local<v8::debug::WasmScript> script,
35                 V8DebuggerAgentImpl* agent);
36
37  // Clear all registered scripts.
38  void Clear();
39
40  // Translate a location as generated by V8 to a location that should be sent
41  // over protocol.
42  // Does nothing for locations referencing a script which was not registered
43  // before via AddScript.
44  // Line and column are 0-based.
45  // Returns true if the location was translated, false otherwise.
46  bool TranslateWasmScriptLocationToProtocolLocation(String16* script_id,
47                                                     int* line_number,
48                                                     int* column_number);
49
50  // Translate back from protocol locations (potentially referencing artificial
51  // scripts for individual wasm functions) to locations that make sense to V8.
52  // Does nothing if the location was not generated by the translate method
53  // above.
54  // Returns true if the location was translated, false otherwise.
55  bool TranslateProtocolLocationToWasmScriptLocation(String16* script_id,
56                                                     int* line_number,
57                                                     int* column_number);
58
59 private:
60  class TranslatorImpl;
61  friend class TranslatorImpl;
62
63  void AddFakeScript(const String16& scriptId, TranslatorImpl* translator);
64
65  v8::Isolate* isolate_;
66  std::unordered_map<int, std::unique_ptr<TranslatorImpl>> wasm_translators_;
67  std::unordered_map<String16, TranslatorImpl*> fake_scripts_;
68  Mode mode_;
69
70  DISALLOW_COPY_AND_ASSIGN(WasmTranslation);
71};
72
73}  // namespace v8_inspector
74
75#endif  // V8_INSPECTOR_WASMTRANSLATION_H_
76