BrowserVersion (HtmlUnit 2.36.0 API)

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

All Implemented Interfaces:

Serializable
```
public final 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.
You can create a different browser setup by using the BrowserVersionFactory.
```
      String applicationName = "APPNAME";
      String applicationVersion = "APPVERSION";
      String userAgent = "USERAGENT";
      int browserVersionNumeric = NUMERIC;

      BrowserVersion browser = new BrowserVersion.BrowserVersionFactory(FF52)
          .setApplicationName(applicationName)
          .setApplicationVersion(applicationVersion)
          .setUserAgent(userAgent)
          .build();
 
```
But keep in mind this now one still behaves like a FF52, only the stuff reported to the outside is changed. This is more or less the same you can do with real browsers installing plugins like UserAgentSwitcher.
Author:

Mike Bowler, Daniel Gredler, Marc Guillemot, Chris Erskine, Ahmed Ashour, Frank Danek, Ronald Brill

See Also:

Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`BrowserVersion.BrowserVersionBuilder` Because BrowserVersion is immutable we need a builder for this complex object setup.

Field Summary

Fields
Modifier and Type	Field and Description
`static BrowserVersion`	`BEST_SUPPORTED` The best supported browser version at the moment.
`static BrowserVersion`	`CHROME` Latest Chrome.
`static BrowserVersion`	`FIREFOX_52` Deprecated. as of version 2.36.0
`static BrowserVersion`	`FIREFOX_60` Firefox 60 ESR.
`static BrowserVersion`	`INTERNET_EXPLORER` Internet Explorer 11.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`getAcceptEncodingHeader()` Returns the value used by the browser for the `Accept_Encoding` header.
`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".
`int`	`getBrowserVersionNumeric()`
`String`	`getBuildId()` Returns the buildId.
`String`	`getCpuClass()` Returns the type of CPU in the machine, for example "x86".
`String`	`getCssAcceptHeader()` Returns the value used by the browser for the `Accept` header if requesting a CSS declaration.
`static BrowserVersion`	`getDefault()` Returns the default browser version that is used whenever a specific version isn't specified.
`int`	`getFontHeight(String fontSize)` Returns the corresponding height of the specified `fontSize`
`String[]`	`getHeaderNamesOrdered()` Gets the headers names, so they are sent in the given order (if included in the request).
`String`	`getHtmlAcceptHeader()` Returns the value used by the browser for the `Accept` header if requesting a page.
`String`	`getImgAcceptHeader()` Returns the value used by the browser for the `Accept` header if requesting an image.
`String`	`getNickname()` Returns the short name of the browser like `FF3`, `IE`, etc.
`int`	`getPixesPerChar()`
`String`	`getPlatform()` Returns the platform on which the application is running, for example "Win32".
`Set<PluginConfiguration>`	`getPlugins()` Returns the available plugins.
`String`	`getProductSub()` Returns the productSub.
`String`	`getScriptAcceptHeader()` Returns the value used by the browser for the `Accept` header if requesting a script.
`String`	`getSystemLanguage()` Returns the system language, for example "en-us".
`TimeZone`	`getSystemTimezone()` Returns the system `TimeZone`.
`String`	`getUploadMimeType(File file)` Determines the content type for the given file.
`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".
`String`	`getVendor()`
`String`	`getXmlHttpRequestAcceptHeader()` Returns the value used by the browser for the `Accept` header if performing an XMLHttpRequest.
`boolean`	`hasFeature(BrowserVersionFeatures property)` Indicates if this instance has the given feature.
`boolean`	`isChrome()` Returns `true` if this `BrowserVersion` instance represents some version of Google Chrome.
`boolean`	`isFirefox()` Returns `true` if this `BrowserVersion` instance represents some version of Firefox.
`boolean`	`isFirefox52()` INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
`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`	`registerUploadMimeType(String fileExtension, String mimeType)` Registers a new mime type for the provided file extension.
`static void`	`setDefault(BrowserVersion newBrowserVersion)` Sets the default browser version that is used whenever a specific version isn't specified.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - FIREFOX_60
```
public static final BrowserVersion FIREFOX_60
```
    Firefox 60 ESR.
    
    Since:
    
    2.32
  - FIREFOX_52
```
@Deprecated
public static final BrowserVersion FIREFOX_52
```
    Deprecated. as of version 2.36.0
    
    Firefox 52 ESR.
    
    Since:
    
    2.26
  - INTERNET_EXPLORER
```
public static final BrowserVersion INTERNET_EXPLORER
```
    Internet Explorer 11.
  - CHROME
```
public static final BrowserVersion CHROME
```
    Latest Chrome.
  - BEST_SUPPORTED
```
public static final BrowserVersion BEST_SUPPORTED
```
    The best supported browser version at the moment.
- Method Detail
  - getDefault
```
public static BrowserVersion getDefault()
```
    Returns the default browser version that is used whenever a specific version isn't specified. Defaults to BEST_SUPPORTED.
    
    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 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
  - isChrome
```
public boolean isChrome()
```
    Returns true if this BrowserVersion instance represents some version of Google Chrome. Note that Google Chrome does not return 'Chrome' in the application name, we have to look in the nickname.
    
    Returns:
    
    whether or not this version is a version of a Chrome browser
  - isFirefox
```
public boolean isFirefox()
```
    Returns true if this BrowserVersion instance represents some version of Firefox.
    
    Returns:
    
    whether or not this version is a version of a Firefox browser
  - isFirefox52
```
public boolean isFirefox52()
```
    INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
    
    Returns:
    
    whether or not this version version 52 of a Firefox browser
  - getNickname
```
public String getNickname()
```
    Returns the short name of the browser like FF3, IE, etc.
    
    Returns:
    
    the short name (if any)
  - getBrowserVersionNumeric
```
public int getBrowserVersionNumeric()
```
    Returns:
    
    the browserVersionNumeric
  - getApplicationCodeName
```
public String getApplicationCodeName()
```
    Returns the application code name, for example "Mozilla". Default value is "Mozilla" 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
  - getVendor
```
public String getVendor()
```
    Returns:
    
    the vendor
  - 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
  - getSystemTimezone
```
public TimeZone getSystemTimezone()
```
    Returns the system TimeZone. Default value is America/New_York if not explicitly configured.
    
    Returns:
    
    the system TimeZone
  - 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
  - getAcceptEncodingHeader
```
public String getAcceptEncodingHeader()
```
    Returns the value used by the browser for the Accept_Encoding header.
    
    Returns:
    
    the accept encoding header string
  - getHtmlAcceptHeader
```
public String getHtmlAcceptHeader()
```
    Returns the value used by the browser for the Accept header if requesting a page.
    
    Returns:
    
    the accept header string
  - getScriptAcceptHeader
```
public String getScriptAcceptHeader()
```
    Returns the value used by the browser for the Accept header if requesting a script.
    
    Returns:
    
    the accept header string
  - getXmlHttpRequestAcceptHeader
```
public String getXmlHttpRequestAcceptHeader()
```
    Returns the value used by the browser for the Accept header if performing an XMLHttpRequest.
    
    Returns:
    
    the accept header string
  - getImgAcceptHeader
```
public String getImgAcceptHeader()
```
    Returns the value used by the browser for the Accept header if requesting an image.
    
    Returns:
    
    the accept header string
  - getCssAcceptHeader
```
public String getCssAcceptHeader()
```
    Returns the value used by the browser for the Accept header if requesting a CSS declaration.
    
    Returns:
    
    the accept header string
  - 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
  - getBuildId
```
public String getBuildId()
```
    Returns the buildId.
    
    Returns:
    
    the buildId
  - getProductSub
```
public String getProductSub()
```
    Returns the productSub.
    
    Returns:
    
    the buildId
  - getHeaderNamesOrdered
```
public String[] getHeaderNamesOrdered()
```
    Gets the headers names, so they are sent in the given order (if included in the request).
    
    Returns:
    
    headerNames the header names in ordered manner
  - registerUploadMimeType
```
public void registerUploadMimeType(String fileExtension,
                                   String mimeType)
```
    Registers a new mime type for the provided file extension.
    
    Parameters:
    
    fileExtension - the file extension used to determine the mime type
    
    mimeType - the mime type to be used when uploading files with this extension
  - getUploadMimeType
```
public String getUploadMimeType(File file)
```
    Determines the content type for the given file.
    
    Parameters:
    
    file - the file
    
    Returns:
    
    a content type or an empty string if unknown
  - getFontHeight
```
public int getFontHeight(String fontSize)
```
    Returns the corresponding height of the specified fontSize
    
    Parameters:
    
    fontSize - the font size
    
    Returns:
    
    the corresponding height
  - getPixesPerChar
```
public int getPixesPerChar()
```
    Returns:
    
    the pixesPerChar based on the specified fontSize
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class BrowserVersion

Nested Class Summary

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

FIREFOX_60

FIREFOX_52

INTERNET_EXPLORER

CHROME

BEST_SUPPORTED

Method Detail

getDefault

setDefault

isIE

isChrome

isFirefox

isFirefox52

getNickname

getBrowserVersionNumeric

getApplicationCodeName

getApplicationMinorVersion

getApplicationName

getApplicationVersion

getVendor

getBrowserLanguage

getCpuClass

isOnLine

getPlatform

getSystemLanguage

getSystemTimezone

getUserAgent

getUserLanguage

getAcceptEncodingHeader

getHtmlAcceptHeader

getScriptAcceptHeader

getXmlHttpRequestAcceptHeader

getImgAcceptHeader

getCssAcceptHeader

getPlugins

hasFeature

getBuildId

getProductSub

getHeaderNamesOrdered

registerUploadMimeType

getUploadMimeType

getFontHeight

getPixesPerChar

toString