Type: Integer
This property is used to set how many milliseconds BrowserHawk's extended property tests that use Flash should wait before timing out. This setting applies only to the OSBitSize and Plugin_FlashBlocked tests because they are the only tests that involve the use of Flash. If Flash does not respond to BrowserHawk within the amount of time indicated by this property, then it times out and BrowserHawk aborts the test.
If the test times out in the case of OSBitSize this results in no OS bit size value being available. Therefore if you are finding that no results are available for OSBitSize for too many of your users you can increase the FlashTimeout property.
If it times out in the case of Plugin_FlashBlocked this results in Flash_PluginBlocked being set to True. This is because no response from Flash is the same as far as BrowserHawk is concerned whether it is because the user has Flash blocked or their machine is not initializing the Flash player quick enough. Therefore if you find you are getting too many false-positives for the Plugin_FlashBlocked property you can increase the FlashTimeout property.
For users with OS X we found that in some cases their machine may take a few seconds to initialize the Flash player and therefore the timeout needs to be higher for OS X users. As a result, BrowserHawk automatically adjusts for this as follows: If you do not set the FlashTimeout property (or you set it to 0) it tells BrowserHawk to automatically adjust the timeout. When using this automatic selection, in the case of all operating systems besides OS X, BrowserHawk will use a value of 2500 ms (2.5 seconds). For OS X users, it uses 3500 ms if you are not performing any Java based tests at the same time, and 7000 ms if you are also performing Java based tests.
Note: If setting this property you must do so prior to calling the GetExtProperties method. This property may be set to 0 ("automatic" mode, which is the default) or in a range between 1500 - 120000. In general we do not recommended setting this property lower than its defaults (as described above).
Note: If you do change this property it will apply to all users on all operating systems, not just OS X. Therefore if your intention is to only change it for OS X users, you should programmatically check to see if the OSName property equals "OS X" and then set the FlashTimeout property accordingly (unless your intention is to change the setting for all users on all operating systems).
Example:
<% set bhObj = Server.CreateObject("cyScape.browserObj")
bhObj.SetExtProperties "OSBitSize"
bhObj.FlashTimeout = 10000
bhObj.GetExtPropertiesEx
%>
<html>OSBitSize is: <% response.write bhObj.OSBitSize %> </html>
See Also: