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
|
// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef EXTENSIONS_RENDERER_BINDINGS_TEST_JS_RUNNER_H_
#define EXTENSIONS_RENDERER_BINDINGS_TEST_JS_RUNNER_H_
#include "base/containers/span.h"
#include "base/functional/callback.h"
#include "base/memory/raw_ptr.h"
#include "extensions/renderer/bindings/js_runner.h"
namespace extensions {
// A JSRunner implementation designed for use in unit tests. Does not handle
// any kind of script suspension. By default, all functions are expected to
// succeed and not throw any exceptions. If running a function is expected to
// result in errors, use a TestJSRunner::AllowErrors object in as narrow a
// scope as possible.
class TestJSRunner : public JSRunner {
public:
// A scoped object that handles setting and resetting the instance for the
// current thread. Note: multiple scopes can be nested, but they must follow
// a LIFO destruction order. That is, the following is safe:
// <begin> // JSRunner::Get() returns the default JSRunner (or none).
// Scope a(); // JSRunner::Get() returns a's JSRunner.
// Scope b(); // JSRunner::Get() returns b's JSRunner.
// ~Scope b(); // JSRunner::Get() returns a's JSRunner.
// ~Scope a(); // JSRunner::Get() returns the default JSRunner (or none).
// But the following will DCHECK:
// Scope a();
// Scope b();
// ~Scope a(); // DCHECKs.
// ~Scope b();
class Scope {
public:
Scope(std::unique_ptr<JSRunner> runner);
Scope(const Scope&) = delete;
Scope& operator=(const Scope&) = delete;
~Scope();
private:
std::unique_ptr<JSRunner> runner_;
raw_ptr<JSRunner> old_runner_;
};
// A scoped object that allows errors to be thrown from running JS functions.
// Note: *not* allowed to be nested; only one can be active at a time.
// Constructing multiple instances at the same time will DCHECK.
class AllowErrors {
public:
AllowErrors();
AllowErrors(const AllowErrors&) = delete;
AllowErrors& operator=(const AllowErrors&) = delete;
~AllowErrors();
};
// A scoped object that suspends script execution through the JSRunner. While
// in scope, function calls to JSRunner will be queued up, and finally run
// upon Suspension destruction.
// Note: *not* allowed to be nested; only one can be active at a time.
// Constructing multiple instances at the same time will DCHECK.
class Suspension {
public:
Suspension();
Suspension(const Suspension&) = delete;
Suspension& operator=(const Suspension&) = delete;
~Suspension();
};
TestJSRunner();
// Provides a callback to be called just before JS will be executed.
explicit TestJSRunner(const base::RepeatingClosure& will_call_js);
TestJSRunner(const TestJSRunner&) = delete;
TestJSRunner& operator=(const TestJSRunner&) = delete;
~TestJSRunner() override;
// JSRunner:
void RunJSFunction(v8::Local<v8::Function> function,
v8::Local<v8::Context> context,
base::span<v8::Local<v8::Value>> args,
ResultCallback callback) override;
v8::MaybeLocal<v8::Value> RunJSFunctionSync(
v8::Local<v8::Function> function,
v8::Local<v8::Context> context,
base::span<v8::Local<v8::Value>> args) override;
private:
friend class Suspension;
struct PendingCall {
PendingCall();
~PendingCall();
PendingCall(PendingCall&& other);
raw_ptr<v8::Isolate> isolate;
v8::Global<v8::Function> function;
v8::Global<v8::Context> context;
std::vector<v8::Global<v8::Value>> arguments;
ResultCallback callback;
};
// Runs all pending calls.
void Flush();
base::RepeatingClosure will_call_js_;
std::vector<PendingCall> pending_calls_;
};
} // namespace extensions
#endif // EXTENSIONS_RENDERER_BINDINGS_TEST_JS_RUNNER_H_
|
