Home
About
Blog
Products
Forum
Support
Contact
Sunbelt Computer Software
PL/B Language Development and Support
Home
About
Blog
Products
Forum
Support
Contact
cefpython/src/include/cef_extension_handler.h at master · pythonthings/cefpython · GitHub
Skip to content
Navigation Menu
Sign in
Appearance settings
Platform
AI CODE CREATION
GitHub Copilot
Write better code with AI
GitHub Copilot app
Direct agents from issue to merge
MCP Registry
Integrate external tools
DEVELOPER WORKFLOWS
Actions
Automate any workflow
Codespaces
Instant dev environments
Issues
Plan and track work
Code Review
Manage code changes
Code Quality
Enforce quality at merge
APPLICATION SECURITY
GitHub Advanced Security
Find and fix vulnerabilities
Code security
Secure your code as you build
Secret protection
Stop leaks before they start
EXPLORE
Why GitHub
Documentation
Blog
Changelog
Marketplace
View all features
Solutions
BY COMPANY SIZE
Enterprises
Small and medium teams
Startups
Nonprofits
BY USE CASE
App Modernization
DevSecOps
DevOps
CI/CD
View all use cases
BY INDUSTRY
Healthcare
Financial services
Manufacturing
Government
View all industries
View all solutions
Resources
EXPLORE BY TOPIC
AI
Software Development
DevOps
Security
View all topics
EXPLORE BY TYPE
Customer stories
Events & webinars
Ebooks & reports
Business insights
GitHub Skills
SUPPORT & SERVICES
Documentation
Customer support
Community forum
Trust center
Partners
View all resources
Open Source
COMMUNITY
GitHub Sponsors
Fund open source developers
PROGRAMS
Security Lab
Maintainer Community
GitHub Stars
Archive Program
REPOSITORIES
Topics
Trending
Collections
Enterprise
ENTERPRISE SOLUTIONS
Enterprise platform
AI-powered developer platform
AVAILABLE ADD-ONS
GitHub Advanced Security
Enterprise-grade security features
Copilot for Business
Enterprise-grade AI features
Premium Support
Enterprise-grade 24/7 support
Pricing
Search
/
Sign in
Sign up
Appearance settings
You signed in with another tab or window.
Reload
to refresh your session.
You signed out in another tab or window.
Reload
to refresh your session.
You switched accounts on another tab or window.
Reload
to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading.
Please reload this page
.
pythonthings
/
cefpython
Public
forked from
cztomczak/cefpython
Notifications
You must be signed in to change notification settings
Fork
0
Star
0
Code
Pull requests
0
Actions
Projects
Security and quality
0
Insights
Additional navigation options
Code
Pull requests
Actions
Projects
Security and quality
Insights
Files
Expand file tree
master
Breadcrumbs
cefpython
/
src
/
include
/
cef_extension_handler.h
Copy path
Blame
More file actions
Blame
More file actions
Latest commit
History
History
History
199 lines (185 loc) · 8.5 KB
master
Breadcrumbs
cefpython
/
src
/
include
/
cef_extension_handler.h
Copy path
Top
File metadata and controls
Code
Blame
199 lines (185 loc) · 8.5 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
//
Copyright (c) 2017 Marshall A. Greenblatt. All rights reserved.
//
//
Redistribution and use in source and binary forms, with or without
//
modification, are permitted provided that the following conditions are
//
met:
//
//
* Redistributions of source code must retain the above copyright
//
notice, this list of conditions and the following disclaimer.
//
* Redistributions in binary form must reproduce the above
//
copyright notice, this list of conditions and the following disclaimer
//
in the documentation and/or other materials provided with the
//
distribution.
//
* Neither the name of Google Inc. nor the name Chromium Embedded
//
Framework nor the names of its contributors may be used to endorse
//
or promote products derived from this software without specific prior
//
written permission.
//
//
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
//
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
//
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
//
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
//
OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
//
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
//
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
//
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
//
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
//
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
//
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
//
---------------------------------------------------------------------------
//
//
The contents of this file must follow a specific format in order to
//
support the CEF translator tool. See the translator.README.txt file in the
//
tools directory for more information.
//
#
ifndef
CEF_INCLUDE_CEF_EXTENSION_HANDLER_H_
#
define
CEF_INCLUDE_CEF_EXTENSION_HANDLER_H_
#
pragma
once
#
include
"
include/cef_base.h
"
#
include
"
include/cef_browser.h
"
#
include
"
include/cef_extension.h
"
#
include
"
include/cef_stream.h
"
class
CefClient
;
//
/
//
Callback interface used for asynchronous continuation of
//
CefExtensionHandler::GetExtensionResource.
//
/
/*
--cef(source=library)--
*/
class
CefGetExtensionResourceCallback
:
public
CefBaseRefCounted
{
public:
//
/
//
Continue the request. Read the resource contents from |stream|.
//
/
/*
--cef(capi_name=cont,optional_param=stream)--
*/
virtual
void
Continue
(CefRefPtr<CefStreamReader> stream) = 0;
//
/
//
Cancel the request.
//
/
/*
--cef()--
*/
virtual
void
Cancel
() = 0;
};
//
/
//
Implement this interface to handle events related to browser extensions.
//
The methods of this class will be called on the UI thread. See
//
CefRequestContext::LoadExtension for information about extension loading.
//
/
/*
--cef(source=client)--
*/
class
CefExtensionHandler
:
public
virtual
CefBaseRefCounted {
public:
//
/
//
Called if the CefRequestContext::LoadExtension request fails. |result| will
//
be the error code.
//
/
/*
--cef()--
*/
virtual
void
OnExtensionLoadFailed
(
cef_errorcode_t
result) {}
//
/
//
Called if the CefRequestContext::LoadExtension request succeeds.
//
|extension| is the loaded extension.
//
/
/*
--cef()--
*/
virtual
void
OnExtensionLoaded
(CefRefPtr<CefExtension> extension) {}
//
/
//
Called after the CefExtension::Unload request has completed.
//
/
/*
--cef()--
*/
virtual
void
OnExtensionUnloaded
(CefRefPtr<CefExtension> extension) {}
//
/
//
Called when an extension needs a browser to host a background script
//
specified via the "background" manifest key. The browser will have no
//
visible window and cannot be displayed. |extension| is the extension that
//
is loading the background script. |url| is an internally generated
//
reference to an HTML page that will be used to load the background script
//
via a <script> src attribute. To allow creation of the browser optionally
//
modify |client| and |settings| and return false. To cancel creation of the
//
browser (and consequently cancel load of the background script) return
//
true. Successful creation will be indicated by a call to
//
CefLifeSpanHandler::OnAfterCreated, and CefBrowserHost::IsBackgroundHost
//
will return true for the resulting browser. See
//
https://developer.chrome.com/extensions/event_pages for more information
//
about extension background script usage.
//
/
/*
--cef()--
*/
virtual
bool
OnBeforeBackgroundBrowser
(CefRefPtr<CefExtension> extension,
const
CefString& url,
CefRefPtr<CefClient>& client,
CefBrowserSettings& settings) {
return
false
;
}
//
/
//
Called when an extension API (e.g. chrome.tabs.create) requests creation of
//
a new browser. |extension| and |browser| are the source of the API call.
//
|active_browser| may optionally be specified via the windowId property or
//
returned via the GetActiveBrowser() callback and provides the default
//
|client| and |settings| values for the new browser. |index| is the position
//
value optionally specified via the index property. |url| is the URL that
//
will be loaded in the browser. |active| is true if the new browser should
//
be active when opened. To allow creation of the browser optionally modify
//
|windowInfo|, |client| and |settings| and return false. To cancel creation
//
of the browser return true. Successful creation will be indicated by a call
//
to CefLifeSpanHandler::OnAfterCreated. Any modifications to |windowInfo|
//
will be ignored if |active_browser| is wrapped in a CefBrowserView.
//
/
/*
--cef()--
*/
virtual
bool
OnBeforeBrowser
(CefRefPtr<CefExtension> extension,
CefRefPtr<CefBrowser> browser,
CefRefPtr<CefBrowser> active_browser,
int
index,
const
CefString& url,
bool
active,
CefWindowInfo& windowInfo,
CefRefPtr<CefClient>& client,
CefBrowserSettings& settings) {
return
false
;
}
//
/
//
Called when no tabId is specified to an extension API call that accepts a
//
tabId parameter (e.g. chrome.tabs.*). |extension| and |browser| are the
//
source of the API call. Return the browser that will be acted on by the API
//
call or return NULL to act on |browser|. The returned browser must share
//
the same CefRequestContext as |browser|. Incognito browsers should not be
//
considered unless the source extension has incognito access enabled, in
//
which case |include_incognito| will be true.
//
/
/*
--cef()--
*/
virtual
CefRefPtr<CefBrowser>
GetActiveBrowser
(
CefRefPtr<CefExtension> extension,
CefRefPtr<CefBrowser> browser,
bool
include_incognito) {
return
NULL
;
}
//
/
//
Called when the tabId associated with |target_browser| is specified to an
//
extension API call that accepts a tabId parameter (e.g. chrome.tabs.*).
//
|extension| and |browser| are the source of the API call. Return true
//
to allow access of false to deny access. Access to incognito browsers
//
should not be allowed unless the source extension has incognito access
//
enabled, in which case |include_incognito| will be true.
//
/
/*
--cef()--
*/
virtual
bool
CanAccessBrowser
(CefRefPtr<CefExtension> extension,
CefRefPtr<CefBrowser> browser,
bool
include_incognito,
CefRefPtr<CefBrowser> target_browser) {
return
true
;
}
//
/
//
Called to retrieve an extension resource that would normally be loaded from
//
disk (e.g. if a file parameter is specified to chrome.tabs.executeScript).
//
|extension| and |browser| are the source of the resource request. |file| is
//
the requested relative file path. To handle the resource request return
//
true and execute |callback| either synchronously or asynchronously. For the
//
default behavior which reads the resource from the extension directory on
//
disk return false. Localization substitutions will not be applied to
//
resources handled via this method.
//
/
/*
--cef()--
*/
virtual
bool
GetExtensionResource
(
CefRefPtr<CefExtension> extension,
CefRefPtr<CefBrowser> browser,
const
CefString& file,
CefRefPtr<CefGetExtensionResourceCallback> callback) {
return
false
;
}
};
#
endif
//
CEF_INCLUDE_CEF_EXTENSION_HANDLER_H_
You can’t perform that action at this time.