com.vaadin.terminal.gwt.client
Class VBrowserDetails

java.lang.Object
  com.vaadin.terminal.gwt.client.VBrowserDetails

All Implemented Interfaces:

Serializable

public class VBrowserDetails
extends Object
implements Serializable

Class that parses the user agent string from the browser and provides information about the browser. Used internally by BrowserInfo and WebBrowser. Should not be used directly.

Since:

6.3

Version:

7.0.0.alpha3

Author:

Vaadin Ltd.

See Also:

Serialized Form

Nested Class Summary

static class

VBrowserDetails.OperatingSystem

Constructor Summary

VBrowserDetails(String userAgent)
Create an instance based on the given user agent.

Method Summary

float	getBrowserEngineVersion() Returns the version of the browser engine.
int	getBrowserMajorVersion() Returns the browser major version e.g., 3 for Firefox 3.5, 4 for Chrome 4, 8 for Internet Explorer 8.
int	getBrowserMinorVersion() Returns the browser minor version e.g., 5 for Firefox 3.5.
int	getOperatingSystemMajorVersion() Returns the major version of the operating system.
int	getOperatingSystemMinorVersion() Returns the minor version of the operating system.
boolean	isAndroid() Tests if the browser is run on Android.
boolean	isChrome() Tests if the browser is Chrome.
boolean	isChromeFrame() Tests if the browser is running ChromeFrame.
boolean	isChromeFrameCapable() Tests if the browser is capable of running ChromeFrame.
boolean	isFirefox() Tests if the browser is Firefox.
boolean	isGecko() Tests if the browser is using the Gecko engine
boolean	isIE() Tests if the browser is Internet Explorer.
boolean	isIOS() Tests if the browser is run in iOS.
boolean	isLinux() Tests if the browser is run on Linux.
boolean	isMacOSX() Tests if the browser is run on Mac OSX.
boolean	isOpera() Tests if the browser is Opera.
boolean	isPresto() Tests if the browser is using the Presto engine
boolean	isSafari() Tests if the browser is Safari.
boolean	isTooOldToFunctionProperly() Checks if the browser is so old that it simply won't work with a Vaadin application.
boolean	isWebKit() Tests if the browser is using the WebKit engine
boolean	isWindows() Tests if the browser is run on Windows.
void	setIEMode(int documentMode) Sets the version for IE based on the documentMode.

Methods inherited from class java.lang.Object

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

Constructor Detail

VBrowserDetails

public VBrowserDetails(String userAgent)

Create an instance based on the given user agent.

Parameters:

userAgent - User agent as provided by the browser.

Method Detail

isFirefox

public boolean isFirefox()

Tests if the browser is Firefox.

Returns:

true if it is Firefox, false otherwise

isGecko

public boolean isGecko()

Tests if the browser is using the Gecko engine

Returns:

true if it is Gecko, false otherwise

isWebKit

public boolean isWebKit()

Tests if the browser is using the WebKit engine

Returns:

true if it is WebKit, false otherwise

isPresto

public boolean isPresto()

Tests if the browser is using the Presto engine

Returns:

true if it is Presto, false otherwise

isSafari

public boolean isSafari()

Tests if the browser is Safari.

Returns:

true if it is Safari, false otherwise

isChrome

public boolean isChrome()

Tests if the browser is Chrome.

Returns:

true if it is Chrome, false otherwise

isChromeFrameCapable

public boolean isChromeFrameCapable()

Tests if the browser is capable of running ChromeFrame.

Returns:

true if it has ChromeFrame, false otherwise

isChromeFrame

public boolean isChromeFrame()

Tests if the browser is running ChromeFrame.

Returns:

true if it is ChromeFrame, false otherwise

isOpera

public boolean isOpera()

Tests if the browser is Opera.

Returns:

true if it is Opera, false otherwise

isIE

public boolean isIE()

Tests if the browser is Internet Explorer.

Returns:

true if it is Internet Explorer, false otherwise

getBrowserEngineVersion

public float getBrowserEngineVersion()

Returns the version of the browser engine. For WebKit this is an integer e.g., 532.0. For gecko it is a float e.g., 1.8 or 1.9.

Returns:

The version of the browser engine

getBrowserMajorVersion

public final int getBrowserMajorVersion()

Returns the browser major version e.g., 3 for Firefox 3.5, 4 for Chrome 4, 8 for Internet Explorer 8.

Note that Internet Explorer 8 and newer will return the document mode so IE8 rendering as IE7 will return 7.

Returns:

The major version of the browser.

getBrowserMinorVersion

public final int getBrowserMinorVersion()

Returns the browser minor version e.g., 5 for Firefox 3.5.

Returns:

The minor version of the browser, or -1 if not known/parsed.

See Also:

getBrowserMajorVersion()

setIEMode

public void setIEMode(int documentMode)

Sets the version for IE based on the documentMode. This is used to return the correct the correct IE version when the version from the user agent string and the value of the documentMode property do not match.

Parameters:

documentMode - The current document mode

isWindows

public boolean isWindows()

Tests if the browser is run on Windows.

Returns:

true if run on Windows, false otherwise

isMacOSX

public boolean isMacOSX()

Tests if the browser is run on Mac OSX.

Returns:

true if run on Mac OSX, false otherwise

isLinux

public boolean isLinux()

Tests if the browser is run on Linux.

Returns:

true if run on Linux, false otherwise

isAndroid

public boolean isAndroid()

Tests if the browser is run on Android.

Returns:

true if run on Android, false otherwise

isIOS

public boolean isIOS()

Tests if the browser is run in iOS.

Returns:

true if run in iOS, false otherwise

getOperatingSystemMajorVersion

public int getOperatingSystemMajorVersion()

Returns the major version of the operating system. Currently only supported for mobile devices (iOS/Android)

Returns:

The major version or -1 if unknown

getOperatingSystemMinorVersion

public int getOperatingSystemMinorVersion()

Returns the minor version of the operating system. Currently only supported for mobile devices (iOS/Android)

Returns:

The minor version or -1 if unknown

isTooOldToFunctionProperly

public boolean isTooOldToFunctionProperly()

Checks if the browser is so old that it simply won't work with a Vaadin application. NOTE that the browser might still be capable of running Crome Frame, so you might still want to check isChromeFrameCapable() if this returns true.

Returns:

true if the browser won't work, false if not the browser is supported or might work