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
|
// Copyright 2022 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef UI_ACCESSIBILITY_PLATFORM_AUTOMATION_AUTOMATION_V8_ROUTER_H_
#define UI_ACCESSIBILITY_PLATFORM_AUTOMATION_AUTOMATION_V8_ROUTER_H_
#include "base/component_export.h"
#include "base/values.h"
#include "ui/accessibility/ax_enums.mojom-shared.h"
#include "ui/accessibility/ax_event_generator.h"
#include "ui/accessibility/platform/automation/automation_tree_manager_owner.h"
#include "ui/accessibility/platform/automation/v8_handler_function_wrapper.h"
#include "v8/include/v8-function-callback.h"
#include "v8/include/v8-value.h"
namespace ui {
// Pure virtual class that allows Automation to route information in and
// out of V8. This should be implemented by each V8 version of Automation,
// for example in Extensions and in the AccessibilityService.
class COMPONENT_EXPORT(AX_PLATFORM) AutomationV8Router {
public:
virtual ~AutomationV8Router();
// Throws an invalid argument exception in V8.
virtual void ThrowInvalidArgumentsException(bool is_fatal = true) const = 0;
// Gets the V8 isolate.
virtual v8::Isolate* GetIsolate() const = 0;
// Gets the V8 script context.
virtual v8::Local<v8::Context> GetContext() const = 0;
virtual void StartCachingAccessibilityTrees() = 0;
virtual void StopCachingAccessibilityTrees() = 0;
//
// Methods converting to and from strings.
//
// Parses a string representing the tree change observer filter.
virtual TreeChangeObserverFilter ParseTreeChangeObserverFilter(
const std::string& filter) const = 0;
// Converts an ax::mojom::MarkerType into a string.
virtual std::string GetMarkerTypeString(ax::mojom::MarkerType type) const = 0;
virtual std::string GetFocusedStateString() const = 0;
virtual std::string GetOffscreenStateString() const = 0;
virtual std::string GetLocalizedStringForImageAnnotationStatus(
ax::mojom::ImageAnnotationStatus status) const = 0;
virtual std::string GetTreeChangeTypeString(
ax::mojom::Mutation change_type) const = 0;
virtual std::string GetEventTypeString(
const std::tuple<ax::mojom::Event, AXEventGenerator::Event>& event_type)
const = 0;
//
// Methods for routing Javascript methods to C++.
//
virtual void RouteHandlerFunction(
const std::string& name,
scoped_refptr<V8HandlerFunctionWrapper> handler_function_wrapper) = 0;
//
// Methods for passing information from C++ to Javascript.
//
// Dispatches an event with the given name and arguments.
virtual void DispatchEvent(const std::string& event_name,
const base::Value::List& event_args) const = 0;
};
} // namespace ui
#endif // UI_ACCESSIBILITY_PLATFORM_AUTOMATION_AUTOMATION_V8_ROUTER_H_
|
