Support API aliases

extensions/renderer/script_context.h

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef EXTENSIONS_RENDERER_SCRIPT_CONTEXT_H_
 #define EXTENSIONS_RENDERER_SCRIPT_CONTEXT_H_
 
 #include <memory>
 #include <string>
 #include <utility>
@@ skipping 15 matching lines @@
 namespace blink {
 class WebFrame;
 class WebLocalFrame;
 }
 
 namespace content {
 class RenderFrame;
 }
 
 namespace extensions {
+enum class CheckAliasStatus;
 class Extension;
 
 // Extensions wrapper for a v8::Context.
 //
 // v8::Contexts can be constructed on any thread, and must only be accessed or
 // destroyed that thread.
 //
 // Note that ScriptContexts bound to worker threads will not have the full
 // functionality as those bound to the main RenderThread.
 class ScriptContext : public RequestSender::Source {
@@ skipping 73 matching lines @@
   // USE THIS METHOD RATHER THAN v8::Function::Call WHEREVER POSSIBLE.
   // TODO(devlin): Remove the above variants in favor of this.
   void SafeCallFunction(const v8::Local<v8::Function>& function,
                         int argc,
                         v8::Local<v8::Value> argv[]);
 
   void DispatchEvent(const char* event_name, v8::Local<v8::Array> args) const;
 
   // Returns the availability of the API |api_name|.
   Feature::Availability GetAvailability(const std::string& api_name);
+  // Returns the availability of the API |api_name|.
+  // |check_alias| Whether API that has an alias that is available should be
+  // considered available (even if the API itself is not available).
+  Feature::Availability GetAvailability(const std::string& api_name,
+                                        CheckAliasStatus check_alias);
 
   // Returns a string description of the type of context this is.
   std::string GetContextTypeDescription() const;
 
   // Returns a string description of the effective type of context this is.
   std::string GetEffectiveContextTypeDescription() const;
 
   v8::Isolate* isolate() const { return isolate_; }
 
   // Get the URL of this context's web frame.
   //
   // TODO(kalman): Remove this and replace with a GetOrigin() call which reads
   // of WebDocument::getSecurityOrigin():
   //  - The URL can change (e.g. pushState) but the origin cannot. Luckily it
   //    appears as though callers don't make security decisions based on the
   //    result of url() so it's not a problem... yet.
   //  - Origin is the correct check to be making.
   //  - It might let us remove the about:blank resolving?
   const GURL& url() const { return url_; }
 
   // Sets the URL of this ScriptContext. Usually this will automatically be set
   // on construction, unless this isn't constructed with enough information to
   // determine the URL (e.g. frame was null).
   // TODO(kalman): Make this a constructor parameter (as an origin).
   void set_url(const GURL& url) { url_ = url; }
 
-  // Returns whether the API |api| or any part of the API could be
-  // available in this context without taking into account the context's
-  // extension.
-  bool IsAnyFeatureAvailableToContext(const extensions::Feature& api);
+  // Returns whether the API |api| or any part of the API could be available in
+  // this context without taking into account the context's extension.
+  // |check_alias| Whether the API should be considered available if it has an
+  // alias that is available.
+  bool IsAnyFeatureAvailableToContext(const extensions::Feature& api,
+                                      CheckAliasStatus check_alias);
 
   // Utility to get the URL we will match against for a frame. If the frame has
   // committed, this is the commited URL. Otherwise it is the provisional URL.
   // The returned URL may be invalid.
   static GURL GetDataSourceURLForFrame(const blink::WebFrame* frame);
 
   // Similar to GetDataSourceURLForFrame, but only returns the data source URL
   // if the frame's document url is empty and the frame has a security origin
   // that allows access to the data source url.
   // TODO(asargent/devlin) - there may be places that should switch to using
@@ skipping 93 matching lines @@
   std::unique_ptr<Runner> runner_;
 
   base::ThreadChecker thread_checker_;
 
   DISALLOW_COPY_AND_ASSIGN(ScriptContext);
 };
 
 }  // namespace extensions
 
 #endif  // EXTENSIONS_RENDERER_SCRIPT_CONTEXT_H_