0fe6767d6b* refactor: convert Menu and globalShortcut to gin * refactor: convert api::Cookies to gin * refactor: convert View and WebContentsView to gin * refactor: convert WebContents related classes to gin * refactor: convert powerMonitor to gin * refactor: prepare for header change * refactor: remove last uses of mate::EventEmitter * refactor: remove mate::EventEmitter * refactor: move trackable_object to gin_helper * fix: custom converter should not use Handle * fix: no more need to check if icon is empty It was a bug that the Handle<NativeImage> can be non-empty when the image file does not exist. The bug was caused by the converter code writing out the image even when the convertion fails. The bug was work-arounded by adding an additional check, but since the original bug had been fixed, the additional check is no longer needed. * fix: should always set frameId even when callback is null * fix: do not mix gin/mate handles for NativeImage
102 lines
3.4 KiB
C++
102 lines
3.4 KiB
C++
// Copyright (c) 2019 GitHub, Inc.
|
|
// Use of this source code is governed by the MIT license that can be
|
|
// found in the LICENSE file.
|
|
|
|
#ifndef SHELL_BROWSER_API_ATOM_API_PROTOCOL_H_
|
|
#define SHELL_BROWSER_API_ATOM_API_PROTOCOL_H_
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "content/public/browser/content_browser_client.h"
|
|
#include "gin/handle.h"
|
|
#include "shell/browser/net/atom_url_loader_factory.h"
|
|
#include "shell/common/gin_helper/dictionary.h"
|
|
#include "shell/common/gin_helper/trackable_object.h"
|
|
|
|
namespace electron {
|
|
|
|
class AtomBrowserContext;
|
|
|
|
namespace api {
|
|
|
|
std::vector<std::string> GetStandardSchemes();
|
|
|
|
void RegisterSchemesAsPrivileged(gin_helper::ErrorThrower thrower,
|
|
v8::Local<v8::Value> val);
|
|
|
|
// Possible errors.
|
|
enum class ProtocolError {
|
|
OK, // no error
|
|
REGISTERED,
|
|
NOT_REGISTERED,
|
|
INTERCEPTED,
|
|
NOT_INTERCEPTED,
|
|
};
|
|
|
|
// Protocol implementation based on network services.
|
|
class Protocol : public gin_helper::TrackableObject<Protocol> {
|
|
public:
|
|
static gin::Handle<Protocol> Create(v8::Isolate* isolate,
|
|
AtomBrowserContext* browser_context);
|
|
|
|
static void BuildPrototype(v8::Isolate* isolate,
|
|
v8::Local<v8::FunctionTemplate> prototype);
|
|
|
|
// Used by AtomBrowserClient for creating URLLoaderFactory.
|
|
void RegisterURLLoaderFactories(
|
|
content::ContentBrowserClient::NonNetworkURLLoaderFactoryMap* factories);
|
|
|
|
const HandlersMap& intercept_handlers() const { return intercept_handlers_; }
|
|
|
|
private:
|
|
Protocol(v8::Isolate* isolate, AtomBrowserContext* browser_context);
|
|
~Protocol() override;
|
|
|
|
// Callback types.
|
|
using CompletionCallback =
|
|
base::RepeatingCallback<void(v8::Local<v8::Value>)>;
|
|
|
|
// JS APIs.
|
|
ProtocolError RegisterProtocol(ProtocolType type,
|
|
const std::string& scheme,
|
|
const ProtocolHandler& handler);
|
|
void UnregisterProtocol(const std::string& scheme, gin::Arguments* args);
|
|
bool IsProtocolRegistered(const std::string& scheme);
|
|
|
|
ProtocolError InterceptProtocol(ProtocolType type,
|
|
const std::string& scheme,
|
|
const ProtocolHandler& handler);
|
|
void UninterceptProtocol(const std::string& scheme, gin::Arguments* args);
|
|
bool IsProtocolIntercepted(const std::string& scheme);
|
|
|
|
// Old async version of IsProtocolRegistered.
|
|
v8::Local<v8::Promise> IsProtocolHandled(const std::string& scheme,
|
|
gin::Arguments* args);
|
|
|
|
// Helper for converting old registration APIs to new RegisterProtocol API.
|
|
template <ProtocolType type>
|
|
void RegisterProtocolFor(const std::string& scheme,
|
|
const ProtocolHandler& handler,
|
|
gin::Arguments* args) {
|
|
HandleOptionalCallback(args, RegisterProtocol(type, scheme, handler));
|
|
}
|
|
template <ProtocolType type>
|
|
void InterceptProtocolFor(const std::string& scheme,
|
|
const ProtocolHandler& handler,
|
|
gin::Arguments* args) {
|
|
HandleOptionalCallback(args, InterceptProtocol(type, scheme, handler));
|
|
}
|
|
|
|
// Be compatible with old interface, which accepts optional callback.
|
|
void HandleOptionalCallback(gin::Arguments* args, ProtocolError error);
|
|
|
|
HandlersMap handlers_;
|
|
HandlersMap intercept_handlers_;
|
|
};
|
|
|
|
} // namespace api
|
|
|
|
} // namespace electron
|
|
|
|
#endif // SHELL_BROWSER_API_ATOM_API_PROTOCOL_H_
|