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
|
// 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 EXTENSIONS_BROWSER_API_OFFSCREEN_OFFSCREEN_API_H_
#define EXTENSIONS_BROWSER_API_OFFSCREEN_OFFSCREEN_API_H_
#include "base/scoped_observation.h"
#include "extensions/browser/extension_function.h"
#include "extensions/browser/extension_function_histogram_value.h"
#include "extensions/browser/extension_host.h"
#include "extensions/browser/extension_host_observer.h"
#include "extensions/buildflags/buildflags.h"
static_assert(BUILDFLAG(ENABLE_EXTENSIONS_CORE));
namespace extensions {
class OffscreenCreateDocumentFunction : public ExtensionFunction,
public ExtensionHostObserver {
public:
DECLARE_EXTENSION_FUNCTION("offscreen.createDocument",
OFFSCREEN_CREATEDOCUMENT)
OffscreenCreateDocumentFunction();
OffscreenCreateDocumentFunction(const OffscreenCreateDocumentFunction&) =
delete;
OffscreenCreateDocumentFunction& operator=(
const OffscreenCreateDocumentFunction&) = delete;
// ExtensionFunction:
ResponseAction Run() override;
private:
~OffscreenCreateDocumentFunction() override;
// ExtensionFunction:
void OnBrowserContextShutdown() override;
// ExtensionHostObserver:
void OnExtensionHostDestroyed(ExtensionHost* host) override;
void OnExtensionHostDidStopFirstLoad(const ExtensionHost* host) override;
// Called (asynchronously) if the page fails to load.
void NotifyPageFailedToLoad();
// Sends a reply asynchronously to the extension.
void SendResponseToExtension(ResponseValue response_value);
// Observes the newly-created document to wait for it to be ready.
base::ScopedObservation<ExtensionHost, ExtensionHostObserver> host_observer_{
this};
};
class OffscreenCloseDocumentFunction : public ExtensionFunction,
public ExtensionHostObserver {
public:
DECLARE_EXTENSION_FUNCTION("offscreen.closeDocument", OFFSCREEN_CLOSEDOCUMENT)
OffscreenCloseDocumentFunction();
OffscreenCloseDocumentFunction(const OffscreenCloseDocumentFunction&) =
delete;
OffscreenCloseDocumentFunction& operator=(
const OffscreenCloseDocumentFunction&) = delete;
// ExtensionFunction:
ResponseAction Run() override;
private:
~OffscreenCloseDocumentFunction() override;
// ExtensionFunction:
void OnBrowserContextShutdown() override;
// ExtensionHostObserver:
void OnExtensionHostDestroyed(ExtensionHost* host) override;
// Sends a reply asynchronously to the extension.
void SendResponseToExtension(ResponseValue response_value);
// Observes the newly-created document to wait for it to be ready.
base::ScopedObservation<ExtensionHost, ExtensionHostObserver> host_observer_{
this};
};
class OffscreenHasDocumentFunction : public ExtensionFunction,
public ExtensionHostObserver {
public:
// Note: We use `UNKNOWN` as the histogram value here because we are unlikely
// to ship this API to stable.
DECLARE_EXTENSION_FUNCTION("offscreen.hasDocument", UNKNOWN)
OffscreenHasDocumentFunction();
OffscreenHasDocumentFunction(const OffscreenHasDocumentFunction&) = delete;
OffscreenHasDocumentFunction& operator=(const OffscreenHasDocumentFunction&) =
delete;
// ExtensionFunction:
ResponseAction Run() override;
private:
~OffscreenHasDocumentFunction() override;
};
} // namespace extensions
#endif // EXTENSIONS_BROWSER_API_OFFSCREEN_OFFSCREEN_API_H_
|
