Type: Integer
Returns the visitor’s upload connection speed throughput in bits per second. For download speed see the ConnectionSpeed property.
Note: This property requires the Enterprise Edition of BrowserHawk.
Tip: See the uploadspeed.asp sample for a working example of the upload connection speed test.
Example:
<% set bhObj = Server.CreateObject("cyScape.browserObj")
bhObj.SetExtProperties "UploadConnectionSpeed"
bhObj.GetExtPropertiesEx
%>
<html>
Your upload connection speed in bits/sec is: <% = bhObj.UploadConnectionSpeed %>
</html>
Special notes for this property:
The UploadConnectionSpeed test is not included when calling GetExtPropertiesEx with the "all" keyword. Therefore you must explicitly pass "UploadConnectionSpeed" as a parameter to SetExtProperties to check for upload connection speed. If you do not, the UploadConnectionSpeed property returns -2.
In the event the UploadConnectionSpeed test times out (as determined by UploadSpeedCheckMaxWait) or an error occurs during testing, the UploadConnectionSpeed property returns -1.
If the user’s JavaScript is disabled this property will not be available and a return value of -2 is returned
You must call the GetExtPropertiesEx method before checking the value of the UploadConnectionSpeed property. Otherwise this property returns -2.
For proper operation of this test please ensure that your web server is configured to allow POST operations of data up to 2MB in size, or at least as large as the value specified in the UploadSpeedCheckMaxDatasize property, if you changed this from its default value. In some cases this may not be mandatory - the important thing is that the web server does not abort the post operation.
The UploadConnectionSpeed property is only supported with IE 8+ (and not in Compatibility Mode), Firefox 3.5+, Safari 4+, and Chrome 5+ browsers. All other browsers will return -2 for UploadConnectionSpeed.
When testing over a local network (browser and web server residing on a local network) you can expect speed measurements to be very high - even hundreds of Mbps. This is normal. Results for real site visitors connecting over the internet will be as expected.
Detecting upload connection speed is new as of BrowserHawk 12. Although we have done extensive testing with measuring connection speeds and it has proven viable, we do not have sufficient customer feedback at this time to determine the full extent of its accuracy. Therefore this property should be considered as somewhat experimental for now.
Using the UploadConnectionSpeed property may result in increased charges from your hosting provider due to the bandwidth used during testing. See Detecting Upload Speeds for more information and tips on reducing this bandwidth.
Detecting upload speeds will not work with IIS versions 5 and earlier (if using IIS, requires IIS 6+).
See Also:
UploadConnectionLatency Property
UploadSpeedCheckFirstDatasize Property
UploadSpeedCheckMaxDatasize Property
UploadSpeedCheckMaxWait Property
UploadSpeedCheckTargetURL Property
UploadSpeedCheckTestSeconds Property
Detecting Connection Speed and Dialup Users