Class JBrowser

Browser class, provides capability information about the current web client.

Browser identification is performed by examining the HTTP_USER_AGENT environment variable provided by the web server.

This class has many influences from the lib/Browser.php code in version 3 of Horde by Chuck Hagenbuch and Jon Parise.

Package: Joomla\Platform\Environment
Copyright: Copyright (C) 2005 - 2017 Open Source Matters, Inc. All rights reserved.
License: General Public License version 2 or later; see LICENSE
Since: 11.1
Located at joomla/environment/browser.php

Methods summary

`public`	# `__construct( string $userAgent = null, string $accept = null )` Create a browser instance (constructor). Create a browser instance (constructor). Parameters `$userAgent` `string` - $userAgent The browser string to parse. `$accept` `string` - $accept The HTTP_ACCEPT settings to use. Since 11.1
`public static JBrowser`	# `getInstance( string $userAgent = null, string $accept = null )` Returns the global Browser object, only creating it if it doesn't already exist. Returns the global Browser object, only creating it if it doesn't already exist. Parameters `$userAgent` `string` - $userAgent The browser string to parse. `$accept` `string` - $accept The HTTP_ACCEPT settings to use. Returns `JBrowser` - The Browser object. Since 11.1
`public`	# `match( string $userAgent = null, string $accept = null )` Parses the user agent string and inititializes the object with all the known features and quirks for the given browser. Parses the user agent string and inititializes the object with all the known features and quirks for the given browser. Parameters `$userAgent` `string` - $userAgent The browser string to parse. `$accept` `string` - $accept The HTTP_ACCEPT settings to use. Since 11.1
`protected`	# `_setPlatform( )` Match the platform of the browser. Match the platform of the browser. This is a pretty simplistic implementation, but it's intended to let us tell what line breaks to send, so it's good enough for its purpose. Since 11.1
`public string`	# `getPlatform( )` Return the currently matched platform. Return the currently matched platform. Returns `string` - The user's platform. Since 11.1
`protected`	# `identifyBrowserVersion( )` Set browser version, not by engine version Fallback to use when no other method identify the engine version Set browser version, not by engine version Fallback to use when no other method identify the engine version Since 11.1
`public`	# `setBrowser( string $browser )` Sets the current browser. Sets the current browser. Parameters `$browser` `string` - $browser The browser to set as current. Since 11.1
`public string`	# `getBrowser( )` Retrieve the current browser. Retrieve the current browser. Returns `string` - The current browser. Since 11.1
`public integer`	# `getMajor( )` Retrieve the current browser's major version. Retrieve the current browser's major version. Returns `integer` - The current browser's major version Since 11.1
`public integer`	# `getMinor( )` Retrieve the current browser's minor version. Retrieve the current browser's minor version. Returns `integer` - The current browser's minor version. Since 11.1
`public string`	# `getVersion( )` Retrieve the current browser's version. Retrieve the current browser's version. Returns `string` - The current browser's version. Since 11.1
`public string`	# `getAgentString( )` Return the full browser agent string. Return the full browser agent string. Returns `string` - The browser agent string Since 11.1
`public string`	# `getHTTPProtocol( )` Returns the server protocol in use on the current server. Returns the server protocol in use on the current server. Returns `string` - The HTTP server protocol version. Since 11.1
`public boolean`	# `isViewable( string $mimetype )` Determines if a browser can display a given MIME type. Determines if a browser can display a given MIME type. Note that image/jpeg and image/pjpeg appear to be the same entity, but Mozilla doesn't seem to want to accept the latter. For our purposes, we will treat them the same. Parameters `$mimetype` `string` - $mimetype The MIME type to check. Returns `boolean` - True if the browser can display the MIME type. Since 11.1
`public boolean`	# `isBrowser( string $browser )` Determine if the given browser is the same as the current. Determine if the given browser is the same as the current. Parameters `$browser` `string` - $browser The browser to check. Returns `boolean` - Is the given browser the same as the current? Since 11.1
`public boolean`	# `isRobot( )` Determines if the browser is a robot or not. Determines if the browser is a robot or not. Returns `boolean` - True if browser is a known robot. Since 11.1
`public boolean`	# `isMobile( )` Determines if the browser is mobile version or not. Determines if the browser is mobile version or not. Returns `boolean` - True if browser is a known mobile version. Since 11.1
`public boolean`	# `isSSLConnection( )` Determine if we are using a secure (SSL) connection. Determine if we are using a secure (SSL) connection. Deprecated 13.3 (Platform) & 4.0 (CMS) - Use the isSSLConnection method on the application object. Returns `boolean` - True if using SSL, false if not. Since 11.1

Magic methods summary

Properties summary

`protected integer`	`$majorVersion`	# Major version number Major version number Since 12.1
`protected integer`	`$minorVersion`	# Minor version number Minor version number Since 12.1
`protected string`	`$browser`	# Browser name. Browser name. Since 12.1
`protected string`	`$agent`	# Full user agent string. Full user agent string. Since 12.1
`protected string`	`$lowerAgent`	# Lower-case user agent string Lower-case user agent string Since 12.1
`protected string`	`$accept`	# HTTP_ACCEPT string. HTTP_ACCEPT string. Since 12.1
`protected array`	`$acceptParsed`	# Parsed HTTP_ACCEPT string Parsed HTTP_ACCEPT string Since 12.1
`protected string`	`$platform`	# Platform the browser is running on Platform the browser is running on Since 12.1
`protected array`	`$robots`	# Known robots. Known robots. Since 12.1
`protected boolean`	`$mobile`	# Is this a mobile browser? Is this a mobile browser? Since 12.1
`protected array`	`$images`	# List of viewable image MIME subtypes. This list of viewable images works for IE and Netscape/Mozilla. List of viewable image MIME subtypes. This list of viewable images works for IE and Netscape/Mozilla. Since 12.1
`protected static array`	`$instances`	# JBrowser instances container. JBrowser instances container. Since 11.3

Namespaces

Classes

Interfaces

Exceptions

Constants

Functions

Class JBrowser

Methods summary

Parameters

Since

Parameters

Returns

Since

Parameters

Since

Since

Returns

Since

Since

Parameters

Since

Returns

Since

Returns

Since

Returns

Since

Returns

Since

Returns

Since

Returns

Since

Parameters

Returns

Since

Parameters

Returns

Since

Returns

Since

Returns

Since

Deprecated

Returns

Since

Magic methods summary

Properties summary

Since

Since

Since

Since

Since

Since

Since

Since

Since

Since

Since

Since