extensions/renderer/bindings/binding_access_checker.h

// 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_BINDING_ACCESS_CHECKER_H_
#define EXTENSIONS_RENDERER_BINDINGS_BINDING_ACCESS_CHECKER_H_

#include <string>

#include "base/functional/callback.h"
#include "v8/include/v8.h"

namespace extensions {

// A helper class to handle access-checking API features.
class BindingAccessChecker {
 public:
  // The callback for determining if a given API feature (specified by `name`)
  // is available in the given context.
  using APIAvailabilityCallback =
      base::RepeatingCallback<bool(v8::Local<v8::Context>,
                                   const std::string& name)>;

  // The callback for determining if a given context is allowed to use promises
  // with API calls.
  using PromiseAvailabilityCallback =
      base::RepeatingCallback<bool(v8::Local<v8::Context>)>;

  BindingAccessChecker(APIAvailabilityCallback api_available,
                       PromiseAvailabilityCallback promises_available);

  BindingAccessChecker(const BindingAccessChecker&) = delete;
  BindingAccessChecker& operator=(const BindingAccessChecker&) = delete;

  ~BindingAccessChecker();

  // Returns true if the feature specified by `full_name` is available to the
  // given `context`.
  bool HasAccess(v8::Local<v8::Context> context,
                 const std::string& full_name) const;

  // Same as HasAccess(), but throws an exception in the `context` if it doesn't
  // have access.
  bool HasAccessOrThrowError(v8::Local<v8::Context> context,
                             const std::string& full_name) const;

  // Returns true if the given `context` is allowed to use promise-based APIs.
  bool HasPromiseAccess(v8::Local<v8::Context> context) const;

 private:
  APIAvailabilityCallback api_available_;
  PromiseAvailabilityCallback promises_available_;
};

}  // namespace extensions

#endif  // EXTENSIONS_RENDERER_BINDINGS_BINDING_ACCESS_CHECKER_H_