Index: ppapi/cpp/network_proxy.h |
diff --git a/ppapi/cpp/network_proxy.h b/ppapi/cpp/network_proxy.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..1169334ed90eca36e78f5935ce84a17fd42b7703 |
--- /dev/null |
+++ b/ppapi/cpp/network_proxy.h |
@@ -0,0 +1,49 @@ |
+// Copyright (c) 2013 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 PPAPI_CPP_NETWORK_PROXY_H_ |
+#define PPAPI_CPP_NETWORK_PROXY_H_ |
+ |
+#include <string> |
+ |
+#include "ppapi/cpp/completion_callback.h" |
+#include "ppapi/cpp/instance_handle.h" |
+ |
+namespace pp { |
+ |
+/// This class provides a way to determine the appropriate proxy settings for |
+/// for a given URL. |
+/// |
+/// Permissions: Apps permission <code>socket</code> with subrule |
+/// <code>resolve-proxy</code> is required for using this API. |
+/// For more details about network communication permissions, please see: |
+/// http://developer.chrome.com/apps/app_network.html |
+class NetworkProxy { |
+ public: |
+ /// Returns true if the browser supports this API, false otherwise. |
+ static bool IsAvailable(); |
+ |
+ /// Retrieves the proxy that will be used for the given URL. The result will |
+ /// be a string in PAC format. For more details about PAC format, please see |
+ /// http://en.wikipedia.org/wiki/Proxy_auto-config |
+ /// |
+ /// @param[in] instance An <code>InstanceHandle</code> identifying one |
+ /// instance of a module. |
+ /// |
+ /// @param[in] url A string <code>Var</code> containing a URL. |
+ /// |
+ /// @param[in] callback A <code>CompletionCallbackWithOutput</code> to be |
+ /// called upon completion. It will be passed a string <code>Var</code> |
+ /// containing the appropriate PAC string for <code>url</code>. |
+ /// |
+ /// @return An int32_t containing an error code from <code>pp_errors.h</code>. |
+ static int32_t GetProxyForURL( |
+ const InstanceHandle& instance, |
+ const Var& url, |
+ const pp::CompletionCallbackWithOutput<Var>& callback); |
+}; |
+ |
+} // namespace pp |
+ |
+#endif // PPAPI_CPP_NETWORK_PROXY_H_ |