com.gargoylesoftware.htmlunit
Class BrowserVersion

java.lang.Object
  com.gargoylesoftware.htmlunit.BrowserVersion

All Implemented Interfaces:

Serializable

public class BrowserVersion
extends Object
implements Serializable

Objects of this class represent one specific version of a given browser. Predefined constants are provided for common browser versions. If you wish to create a BrowserVersion for a browser that doesn't have a constant defined but aren't sure what values to pass into the constructor then point your browser at http://htmlunit.sourceforge.net/cgi-bin/browserVersion and the code will be generated for you.

Version:

$Revision: 5712 $

Author:

Mike Bowler, Daniel Gredler, Marc Guillemot, Chris Erskine, Ahmed Ashour

See Also:

Serialized Form

Field Summary

static String	APP_CODE_NAME Deprecated. as of 2.8, without replacement
static String	CPU_CLASS_X86 Deprecated. as of 2.8, without replacement
static BrowserVersion	FIREFOX_2 Deprecated. since HtmlUnit-2.7. This means that no effort will be made to improve simulation for this browser version until it is definitely removed.
static BrowserVersion	FIREFOX_3 Firefox 3.
static BrowserVersion	FIREFOX_3_6 Firefox 3.6.
static String	INTERNET_EXPLORER Deprecated. as of 2.8, without replacement
static BrowserVersion	INTERNET_EXPLORER_6 Internet Explorer 6.
static BrowserVersion	INTERNET_EXPLORER_7 Internet Explorer 7.
static BrowserVersion	INTERNET_EXPLORER_8 Internet Explorer 8.
static String	LANGUAGE_ENGLISH_US Deprecated. as of 2.8, without replacement
static String	NETSCAPE Deprecated. as of 2.8, without replacement
static String	PLATFORM_WIN32 Deprecated. as of 2.8, without replacement

Constructor Summary

BrowserVersion(String applicationName, String applicationVersion, String userAgent, float browserVersionNumeric)
Instantiates one.

BrowserVersion(String applicationName, String applicationVersion, String userAgent, float browserVersionNumeric, BrowserVersionFeatures[] features)
Instantiates one.

Method Summary

boolean	equals(Object o)
String	getApplicationCodeName() Returns the application code name, for example "Mozilla".
String	getApplicationMinorVersion() Returns the application minor version, for example "0".
String	getApplicationName() Returns the application name, for example "Microsoft Internet Explorer".
String	getApplicationVersion() Returns the application version, for example "4.0 (compatible; MSIE 6.0b; Windows 98)".
String	getBrowserLanguage() Returns the browser application language, for example "en-us".
float	getBrowserVersionNumeric()
String	getCpuClass() Returns the type of CPU in the machine, for example "x86".
static BrowserVersion	getDefault() Returns the default browser version that is used whenever a specific version isn't specified.
String	getNickname() Returns the short name of the browser like "FF3", "IE7", ...
String	getPlatform() Returns the platform on which the application is running, for example "Win32".
Set<PluginConfiguration>	getPlugins() Returns the available plugins.
String	getSystemLanguage() Returns the system language, for example "en-us".
String	getUserAgent() Returns the user agent string, for example "Mozilla/4.0 (compatible; MSIE 6.0b; Windows 98)".
String	getUserLanguage() Returns the user language, for example "en-us".
boolean	hasFeature(BrowserVersionFeatures property) Indicates if this instance has the given feature.
int	hashCode()
boolean	isFirefox() Returns true if this BrowserVersion instance represents some version of Firefox like FIREFOX_2 or FIREFOX_3.
boolean	isIE() Returns true if this BrowserVersion instance represents some version of Internet Explorer.
boolean	isOnLine() Returns true if the browser is currently online.
void	setApplicationCodeName(String applicationCodeName)
void	setApplicationMinorVersion(String applicationMinorVersion)
void	setApplicationName(String applicationName)
void	setApplicationVersion(String applicationVersion)
void	setBrowserLanguage(String browserLanguage)
void	setBrowserVersion(float browserVersion)
void	setCpuClass(String cpuClass)
static void	setDefault(BrowserVersion newBrowserVersion) Sets the default browser version that is used whenever a specific version isn't specified.
void	setOnLine(boolean onLine)
void	setPlatform(String platform)
void	setSystemLanguage(String systemLanguage)
void	setUserAgent(String userAgent)
void	setUserLanguage(String userLanguage)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

APP_CODE_NAME

@Deprecated
public static final String APP_CODE_NAME

Deprecated. as of 2.8, without replacement

Application code name for both Internet Explorer and Netscape series.

See Also:

Constant Field Values

INTERNET_EXPLORER

@Deprecated
public static final String INTERNET_EXPLORER

Deprecated. as of 2.8, without replacement

Application name for the Internet Explorer series of browsers.

See Also:

Constant Field Values

NETSCAPE

@Deprecated
public static final String NETSCAPE

Deprecated. as of 2.8, without replacement

Application name the Netscape navigator series of browsers.

See Also:

Constant Field Values

LANGUAGE_ENGLISH_US

@Deprecated
public static final String LANGUAGE_ENGLISH_US

Deprecated. as of 2.8, without replacement

United States English language identifier.

See Also:

Constant Field Values

CPU_CLASS_X86

@Deprecated
public static final String CPU_CLASS_X86

Deprecated. as of 2.8, without replacement

The X86 CPU class.

See Also:

Constant Field Values

PLATFORM_WIN32

@Deprecated
public static final String PLATFORM_WIN32

Deprecated. as of 2.8, without replacement

The WIN32 platform.

See Also:

Constant Field Values

FIREFOX_2

@Deprecated
public static final BrowserVersion FIREFOX_2

Deprecated. since HtmlUnit-2.7. This means that no effort will be made to improve simulation for this browser version until it is definitely removed.

Firefox 2.

FIREFOX_3

public static final BrowserVersion FIREFOX_3

Firefox 3.

FIREFOX_3_6

public static final BrowserVersion FIREFOX_3_6

Firefox 3.6.

INTERNET_EXPLORER_6

public static final BrowserVersion INTERNET_EXPLORER_6

Internet Explorer 6.

INTERNET_EXPLORER_7

public static final BrowserVersion INTERNET_EXPLORER_7

Internet Explorer 7.

INTERNET_EXPLORER_8

public static final BrowserVersion INTERNET_EXPLORER_8

Internet Explorer 8.

Constructor Detail

BrowserVersion

public BrowserVersion(String applicationName,
                      String applicationVersion,
                      String userAgent,
                      float browserVersionNumeric)

Instantiates one.

Parameters:

applicationName - the name of the application

applicationVersion - the version string of the application

userAgent - the user agent string that will be sent to the server

browserVersionNumeric - the floating number version of the browser

BrowserVersion

public BrowserVersion(String applicationName,
                      String applicationVersion,
                      String userAgent,
                      float browserVersionNumeric,
                      BrowserVersionFeatures[] features)

Instantiates one.

Parameters:

applicationName - the name of the application

applicationVersion - the version string of the application

userAgent - the user agent string that will be sent to the server

browserVersionNumeric - the floating number version of the browser

features - the browser features

Method Detail

getDefault

public static BrowserVersion getDefault()

Returns the default browser version that is used whenever a specific version isn't specified. Defaults to INTERNET_EXPLORER_7.

Returns:

the default browser version

setDefault

public static void setDefault(BrowserVersion newBrowserVersion)

Sets the default browser version that is used whenever a specific version isn't specified.

Parameters:

newBrowserVersion - the new default browser version

isIE

public final boolean isIE()

Returns true if this BrowserVersion instance represents some version of Internet Explorer.

Returns:

whether or not this version is a version of IE

isFirefox

public final boolean isFirefox()

Returns true if this BrowserVersion instance represents some version of Firefox like FIREFOX_2 or FIREFOX_3.

Returns:

whether or not this version is a version of a Firefox browser

getApplicationCodeName

public String getApplicationCodeName()

Returns the application code name, for example "Mozilla". Default value is APP_CODE_NAME if not explicitly configured.

Returns:

the application code name

See Also:

MSDN documentation

getApplicationMinorVersion

public String getApplicationMinorVersion()

Returns the application minor version, for example "0". Default value is "0" if not explicitly configured.

Returns:

the application minor version

See Also:

MSDN documentation

getApplicationName

public String getApplicationName()

Returns the application name, for example "Microsoft Internet Explorer".

Returns:

the application name

See Also:

MSDN documentation

getApplicationVersion

public String getApplicationVersion()

Returns the application version, for example "4.0 (compatible; MSIE 6.0b; Windows 98)".

Returns:

the application version

See Also:

MSDN documentation

getBrowserLanguage

public String getBrowserLanguage()

Returns the browser application language, for example "en-us". Default value is LANGUAGE_ENGLISH_US if not explicitly configured.

Returns:

the browser application language

See Also:

MSDN documentation

getCpuClass

public String getCpuClass()

Returns the type of CPU in the machine, for example "x86". Default value is CPU_CLASS_X86 if not explicitly configured.

Returns:

the type of CPU in the machine

See Also:

MSDN documentation

isOnLine

public boolean isOnLine()

Returns true if the browser is currently online. Default value is true if not explicitly configured.

Returns:

true if the browser is currently online

See Also:

MSDN documentation

getPlatform

public String getPlatform()

Returns the platform on which the application is running, for example "Win32". Default value is PLATFORM_WIN32 if not explicitly configured.

Returns:

the platform on which the application is running

See Also:

MSDN documentation

getSystemLanguage

public String getSystemLanguage()

Returns the system language, for example "en-us". Default value is LANGUAGE_ENGLISH_US if not explicitly configured.

Returns:

the system language

See Also:

MSDN documentation

getUserAgent

public String getUserAgent()

Returns the user agent string, for example "Mozilla/4.0 (compatible; MSIE 6.0b; Windows 98)".

Returns:

the user agent string

getUserLanguage

public String getUserLanguage()

Returns the user language, for example "en-us". Default value is LANGUAGE_ENGLISH_US if not explicitly configured.

Returns:

the user language

See Also:

MSDN documentation

setApplicationCodeName

public void setApplicationCodeName(String applicationCodeName)

Parameters:

applicationCodeName - the applicationCodeName to set

setApplicationMinorVersion

public void setApplicationMinorVersion(String applicationMinorVersion)

Parameters:

applicationMinorVersion - the applicationMinorVersion to set

setApplicationName

public void setApplicationName(String applicationName)

Parameters:

applicationName - the applicationName to set

setApplicationVersion

public void setApplicationVersion(String applicationVersion)

Parameters:

applicationVersion - the applicationVersion to set

setBrowserLanguage

public void setBrowserLanguage(String browserLanguage)

Parameters:

browserLanguage - the browserLanguage to set

setCpuClass

public void setCpuClass(String cpuClass)

Parameters:

cpuClass - the cpuClass to set

setOnLine

public void setOnLine(boolean onLine)

Parameters:

onLine - the onLine to set

setPlatform

public void setPlatform(String platform)

Parameters:

platform - the platform to set

setSystemLanguage

public void setSystemLanguage(String systemLanguage)

Parameters:

systemLanguage - the systemLanguage to set

setUserAgent

public void setUserAgent(String userAgent)

Parameters:

userAgent - the userAgent to set

setUserLanguage

public void setUserLanguage(String userLanguage)

Parameters:

userLanguage - the userLanguage to set

setBrowserVersion

public void setBrowserVersion(float browserVersion)

Parameters:

browserVersion - the browserVersion to set

getBrowserVersionNumeric

public float getBrowserVersionNumeric()

Returns:

the browserVersionNumeric

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getPlugins

public Set<PluginConfiguration> getPlugins()

Returns the available plugins. This makes only sense for Firefox as only this browser makes this kind of information available via JavaScript.

Returns:

the available plugins

hasFeature

public boolean hasFeature(BrowserVersionFeatures property)

Indicates if this instance has the given feature. Used for HtmlUnit internal processing.

Parameters:

property - the property name

Returns:

false if this browser doesn't have this feature

getNickname

public String getNickname()

Returns the short name of the browser like "FF3", "IE7", ... This is used in different tests to reference the browser to which it applies.

Returns:

the short name (if any)