Package org.htmlunit

Class BrowserVersion

  • All Implemented Interfaces:
    java.io.Serializable
    public final class BrowserVersion
extends java.lang.Object
implements java.io.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. 

             final String applicationName = "APPNAME";
         final String applicationVersion = "APPVERSION";
         final String userAgent = "USERAGENT";
 
             final BrowserVersion browser =
                 new BrowserVersion.BrowserVersionBuilder(BrowserVersion.FIREFOX)
                     .setApplicationName(applicationName)
                     .setApplicationVersion(applicationVersion)
                     .setUserAgent(userAgent)
                     .build();

    But keep in mind this new one still behaves like an FF, 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.

    See Also:
    Serialized Form

    • Field Detail

      • NETSCAPE

        private static final java.lang.String NETSCAPE
        Application name the Netscape navigator series of browsers.
        See Also:
        Constant Field Values

      • LANGUAGE_ENGLISH_US

        private static final java.lang.String LANGUAGE_ENGLISH_US
        United States English language identifier.
        See Also:
        Constant Field Values

      • TIMEZONE_NEW_YORK

        private static final java.lang.String TIMEZONE_NEW_YORK
        United States.
        See Also:
        Constant Field Values

      • PLATFORM_WIN32

        private static final java.lang.String PLATFORM_WIN32
        The WIN32 platform.
        See Also:
        Constant Field Values

      • FIREFOX_ESR

        public static final BrowserVersion FIREFOX_ESR
        Firefox ESR.

      • ALL_SUPPORTED_BROWSERS

        public static final BrowserVersion[] ALL_SUPPORTED_BROWSERS
        Array with all supported browsers.

      • BEST_SUPPORTED

        public static final BrowserVersion BEST_SUPPORTED
        The best supported browser version at the moment.

      • DefaultBrowserVersion_

        private static BrowserVersion DefaultBrowserVersion_
        The default browser version.

      • browserVersionNumeric_

        private final int browserVersionNumeric_

      • nickname_

        private final java.lang.String nickname_

      • applicationCodeName_

        private java.lang.String applicationCodeName_

      • applicationMinorVersion_

        private java.lang.String applicationMinorVersion_

      • applicationName_

        private java.lang.String applicationName_

      • applicationVersion_

        private java.lang.String applicationVersion_

      • buildId_

        private java.lang.String buildId_

      • productSub_

        private java.lang.String productSub_

      • vendor_

        private java.lang.String vendor_

      • browserLocale_

        private java.util.Locale browserLocale_

      • onLine_

        private boolean onLine_

      • platform_

        private java.lang.String platform_

      • systemTimezone_

        private java.util.TimeZone systemTimezone_

      • userAgent_

        private java.lang.String userAgent_

      • acceptEncodingHeader_

        private java.lang.String acceptEncodingHeader_

      • acceptLanguageHeader_

        private java.lang.String acceptLanguageHeader_

      • htmlAcceptHeader_

        private java.lang.String htmlAcceptHeader_

      • imgAcceptHeader_

        private java.lang.String imgAcceptHeader_

      • cssAcceptHeader_

        private java.lang.String cssAcceptHeader_

      • scriptAcceptHeader_

        private java.lang.String scriptAcceptHeader_

      • secClientHintUserAgentHeader_

        private java.lang.String secClientHintUserAgentHeader_

      • secClientHintUserAgentPlatformHeader_

        private java.lang.String secClientHintUserAgentPlatformHeader_

      • xmlHttpRequestAcceptHeader_

        private java.lang.String xmlHttpRequestAcceptHeader_

      • headerNamesOrdered_

        private java.lang.String[] headerNamesOrdered_

      • fontHeights_

        private int[] fontHeights_

      • uploadMimeTypes_

        private final java.util.Map<java.lang.String,​java.lang.String> uploadMimeTypes_

    • Constructor Detail

      • BrowserVersion

        BrowserVersion​(int browserVersionNumeric,
               java.lang.String nickname)
        Creates a new browser version instance.
        Parameters:
        browserVersionNumeric - the floating number version of the browser
        nickname - the short name of the browser (like "FF", "CHROME", ...) - has to be unique

    • Method Detail

      • initFeatures

        private void initFeatures()

      • 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

      • 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 this version is a version of a Chrome browser

      • isEdge

        public boolean isEdge()
        Returns true if this BrowserVersion instance represents some version of Microsoft Edge.
        Returns:
        whether 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 this version is a version of a Firefox browser

      • isFirefoxESR

        public boolean isFirefoxESR()
        INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
        Returns:
        whether this is version 78 of a Firefox browser

      • getNickname

        public java.lang.String getNickname()
        Returns the short name of the browser like FF, CHROME, etc.
        Returns:
        the short name (if any)

      • getBrowserVersionNumeric

        public int getBrowserVersionNumeric()
        Returns:
        the browserVersionNumeric

      • getApplicationCodeName

        public java.lang.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 java.lang.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 java.lang.String getApplicationName()
        Returns the application name, for example "Netscape".
        Returns:
        the application name
        See Also:
        MSDN documentation

      • getApplicationVersion

        public java.lang.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 java.lang.String getVendor()
        Returns:
        the vendor

      • getBrowserLocale

        public java.util.Locale getBrowserLocale()
        Returns the browser locale. Default value is LANGUAGE_ENGLISH_US if not explicitly configured.
        Returns:
        the system locale

      • getBrowserLanguage

        public java.lang.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

      • 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 java.lang.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

      • getSystemTimezone

        public java.util.TimeZone getSystemTimezone()
        Returns the system TimeZone. Default value is America/New_York if not explicitly configured.
        Returns:
        the system TimeZone

      • getUserAgent

        public java.lang.String getUserAgent()
        Returns the user agent string, for example "Mozilla/4.0 (compatible; MSIE 6.0b; Windows 98)".
        Returns:
        the user agent string

      • getAcceptEncodingHeader

        public java.lang.String getAcceptEncodingHeader()
        Returns the value used by the browser for the Accept_Encoding header.
        Returns:
        the accept encoding header string

      • getAcceptLanguageHeader

        public java.lang.String getAcceptLanguageHeader()
        Returns the value used by the browser for the Accept_Language header.
        Returns:
        the accept language header string

      • getHtmlAcceptHeader

        public java.lang.String getHtmlAcceptHeader()
        Returns the value used by the browser for the Accept header if requesting a page.
        Returns:
        the accept header string

      • getScriptAcceptHeader

        public java.lang.String getScriptAcceptHeader()
        Returns the value used by the browser for the Accept header if requesting a script.
        Returns:
        the accept header string

      • getXmlHttpRequestAcceptHeader

        public java.lang.String getXmlHttpRequestAcceptHeader()
        Returns the value used by the browser for the Accept header if performing an XMLHttpRequest.
        Returns:
        the accept header string

      • getImgAcceptHeader

        public java.lang.String getImgAcceptHeader()
        Returns the value used by the browser for the Accept header if requesting an image.
        Returns:
        the accept header string

      • getCssAcceptHeader

        public java.lang.String getCssAcceptHeader()
        Returns the value used by the browser for the Accept header if requesting a CSS declaration.
        Returns:
        the accept header string

      • getSecClientHintUserAgentHeader

        public java.lang.String getSecClientHintUserAgentHeader()
        Returns the value used by the browser for the sec-ch-ua header.
        Returns:
        the sec-ch-ua header string

      • getSecClientHintUserAgentPlatformHeader

        public java.lang.String getSecClientHintUserAgentPlatformHeader()
        Returns the value used by the browser for the sec-ch-ua-platform header.
        Returns:
        the sec-ch-ua-platform header string

      • getPlugins

        public java.util.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 java.lang.String getBuildId()
        Returns the buildId.
        Returns:
        the buildId

      • getProductSub

        public java.lang.String getProductSub()
        Returns the productSub.
        Returns:
        the buildId

      • getHeaderNamesOrdered

        public java.lang.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​(java.lang.String fileExtension,
                                   java.lang.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 java.lang.String getUploadMimeType​(java.io.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​(java.lang.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 java.lang.String toString()
        Overrides:
        toString in class java.lang.Object