PPAPI: Add an API for setting a custom user agent for URL requests.

ppapi/cpp/url_request_info.h

 // Copyright (c) 2011 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_URL_REQUEST_INFO_H_
 #define PPAPI_CPP_URL_REQUEST_INFO_H_
 
 #include "ppapi/c/ppb_url_request_info.h"
 #include "ppapi/cpp/resource.h"
 #include "ppapi/cpp/var.h"
@@ skipping 227 matching lines @@
   /// and cookies are ignored in the response. If the request is not
   /// cross-origin, this property is ignored.
   ///
   /// @param[in] enable A <code>bool</code> containing the property value.
   ///
   /// @return true if successful, false if the parameter is invalid.
   bool SetAllowCredentials(bool enable) {
     return SetProperty(PP_URLREQUESTPROPERTY_ALLOWCREDENTIALS, enable);
   }
 
-
   /// SetCustomContentTransferEncoding() sets the
   /// <code>PP_URLREQUESTPROPERTY_CUSTOMCONTENTTRANSFERENCODING</code>
   /// (corresponding to a string of type <code>PP_VARTYPE_STRING</code> or
   /// might be set to undefined as <code>PP_VARTYPE_UNDEFINED</code>). Set it
   /// to a string to set a custom content-transfer-encoding header (if empty,
   /// that header will be omitted), or to undefined to use the default (if
   /// any). Only loaders with universal access (only available on trusted
   /// implementations) will accept <code>URLRequestInfo</code> objects that try
   /// to set a custom content transfer encoding; if given to a loader without
   /// universal access, <code>PP_ERROR_BADARGUMENT</code> will result.
@@ skipping 43 matching lines @@
   /// <code>PP_URLREQUESTPROPERTY_PREFETCHBUFFERUPPERTHRESHOLD</code> must also
   /// be set. Behavior is undefined if the former is >= the latter.
   ///
   /// @param[in] size An int32_t containing the property value.
   ///
   /// @return true if successful, false if the parameter is invalid.
   bool SetPrefetchBufferLowerThreshold(int32_t size) {
     return SetProperty(PP_URLREQUESTPROPERTY_PREFETCHBUFFERLOWERTHRESHOLD,
                        size);
   }
+
+  /// SetCustomUserAgent() sets the
+  /// <code>PP_URLREQUESTPROPERTY_CUSTOMUSERAGENT</code> (corresponding to a
+  /// string of type <code>PP_VARTYPE_STRING</code> or might be set to undefined
+  /// as <code>PP_VARTYPE_UNDEFINED</code>). Set it to a string to set a custom
+  /// user-agent header (if empty, that header will be omitted), or to undefined
+  /// to use the default. Only loaders with universal access (only available on
+  /// trusted implementations) will accept <code>URLRequestInfo</code> objects
+  /// that try to set a custom user agent; if given to a loader without
+  /// universal access, <code>PP_ERROR_BADARGUMENT</code> will result.
+  ///
+  /// @param[in] user_agent A <code>Var</code> containing the property value. To
+  /// use the default user agent, set <code>user_agent</code> to an undefined
+  /// <code>Var</code>.
+  ///
+  /// @return true if successful, false if the parameter is invalid.
+  bool SetCustomUserAgent(const Var& user_agent) {
+    return SetProperty(PP_URLREQUESTPROPERTY_CUSTOMUSERAGENT, user_agent);
+  }
 };
 
 }  // namespace pp
 
 #endif  // PPAPI_CPP_URL_REQUEST_INFO_H_