blob: a8ef86d13e5f5a2576dc2e9c199f5731c7fee68b [file] [log] [blame]
// Copyright 2023 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_EXTENSIONS_RENDERER_API_PROVIDER_H_
#define EXTENSIONS_RENDERER_EXTENSIONS_RENDERER_API_PROVIDER_H_
namespace extensions {
class Dispatcher;
class ModuleSystem;
class NativeExtensionBindingsSystem;
class ScriptContext;
class ResourceBundleSourceMap;
class V8SchemaRegistry;
// An interface class that is owned by extensions::Dispatcher.
// ExtensionsRendererAPIProvider can be used to override and extend the behavior
// of the extensions system's renderer side from outside of extensions
// directories.
// NOTE: This class may be used on multiple threads. As such, ALL METHODS must
// be `const` and implementors must be careful about accessing any global state.
// See also comment in //extensions/renderer/dispatcher.cc.
class ExtensionsRendererAPIProvider {
public:
virtual ~ExtensionsRendererAPIProvider() = default;
// Registers any native handlers to provide additional functionality for
// native bindings. Called each time a new ScriptContext is created, since
// native handlers are per-context.
virtual void RegisterNativeHandlers(
ModuleSystem* module_system,
NativeExtensionBindingsSystem* bindings_system,
V8SchemaRegistry* v8_schema_registry,
ScriptContext* context) const = 0;
// Registers any additional hooks associated with specific APIs to the API
// bindings system. Called once per NativeExtensionBindingsSystem, which is
// one-per-thread and re-used across ScriptContexts.
virtual void AddBindingsSystemHooks(
Dispatcher* dispatcher,
NativeExtensionBindingsSystem* bindings_system) const = 0;
// Includes additional source resources into the resource map.
virtual void PopulateSourceMap(ResourceBundleSourceMap* source_map) const = 0;
// Blink maintains an allowlist for custom element names. This method
// provides the delegate the ability to add more names to that allowlist.
virtual void EnableCustomElementAllowlist() const = 0;
// Requires modules for defining WebView APIs within a ScriptContext's
// ModuleSystem.
virtual void RequireWebViewModules(ScriptContext* context) const = 0;
};
} // namespace extensions
#endif // EXTENSIONS_RENDERER_EXTENSIONS_RENDERER_API_PROVIDER_H_