| 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_
|
|
|