Returns the internal "code" name of the current browser.

Note: Mozilla, Netscape 6, and IE5 all use the internal name "Mozilla."

See also

Retrieves the application's minor version value.

See also

Returns the official name of the browser.

See also

         dump(window.navigator.appName);
         // prints "Navigator" to the console for NS6

Returns the version of the browser.

Note: The window.navigator.userAgent property also contains the version number (example: "Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape 6/6.1"), but you should be aware of how easy it is to change the user agent string and "spoof" other browsers, platforms, or user agents, and also how cavalier the browser vendor themselves are with these properties. The window.navigator.appVersion and window.navigator.userAgent properties are quite often used in "browser sniffing" code: scripts that attempt to find out what kind of browser you are using and adjust pages accordingly.

See also

         if ( navigator.appVersion.charAt(0) == "5" ) { 
             // browser is putatively a v5 browser
         }

Retrieves the current browser language.

Note (IE): This property does not indicate the language or languages set by the user in Language Preferences, located in the Internet Options dialog box.

Note (IE): In Microsoft Internet Explorer 4.0 and earlier, the browserLanguage property reflects the language of the installed browser's user interface. For example, if you install a Japanese version of Windows Internet Explorer on an English operating system, browserLanguage would be ja.

Note (IE): In Internet Explorer 5 and later, however, the browserLanguage property reflects the language of the operating system regardless of the installed language version of Internet Explorer. However, if Microsoft Windows 2000 MultiLanguage version is installed, the browserLanguage property indicates the language set in the operating system's current menus and dialogs, as found in the Regional Options of the Control Panel. For example, if you install a Japanese version of Internet Explorer 5 on an English (United Kingdom) operating system, browserLanguage would be en-gb. If you install Windows 2000 MultiLanguage version and set the language of the menus and dialogs to French, browserLanguage would be fr, even though you have a Japanese version of Internet Explorer.

See also

Returns the build identifier of the browser. The build ID is in form YYYYMMDDHH.

Note: Available in Firefox 2 (Gecko 1.8.1) and later.

See also

         dump(window.navigator.buildID); 
         // prints "2006090803" to the console

Returns a boolean indicating whether cookies are enabled in the browser or not.

Note (IE): CookieEnabled does not check the status of session cookies.

Note (Mozilla): Due to bug 230350, cookieEnabled may return the wrong result in Gecko-based applications.

See also

         if (!navigator.cookieEnabled) { 
             // let the user know that enabling cookies makes the web page much more useful
         }

Retrieves a string denoting the CPU class.

See also

Returns a string representing the language version of the browser. Examples of valid language codes include "en", "en-US", "fr", "es-ES", etc.

Note: This property also shows up as part of the navigator.userAgent string.

See also

         if ( window.navigator.language != "en" ) {       
             doLangSelect(window.navigator.language); 
         }

Returns a MimeTypeArray object, which contains a list of MimeType objects representing the MIME types recognized by the browser.

Note: The zeroth element in mimeTypes (the "Mozilla Default Plug-in" MimeType object) has a type property of instead of a typical MIME format like "image/x-macpaint"

See also

alert(window.navigator.mimeTypes.item(0).description); // alerts "Mozilla Default Plug-in"

Returns a boolean indicating whether the browser is working online.

Note (IE): In Windows Internet Explorer 8 and later, the onLine property returns true if both of the following conditions are true:

• the system is able to communicate with the network
• the system is not in global offline mode (Users can modify the global offline state by choosing Work Offline on the File menu.)

Note (IE): In Microsoft Internet Explorer 4.0 through Internet Explorer 7, the onLine property indicates whether the system is in global offline mode. It does not indicate whether the system can communicate with the network.

See also

alert(navigator.onLine ? "You're online" : "You're offline");

Returns a string that represents the current operating system.

See also

         function osInfo() { 
             alert(window.navigator.oscpu); 
         }
         // returns: Windows NT 6.0

Returns a string representing the platform of the browser.

Note (Mozilla): Unless your code is privileged (chrome or at least has the UniversalBrowserRead privilege), it may get the value of the general.platform.override preference instead of the true platform.

See also

Returns an PluginArray object, listing the plugins installed in the application. IE: Retrieves a collection of all embed objects within the document.

Note (IE): The collection is an alias for the embeds collection on the document.

See also

         <script type="text/javascript">
             var L = navigator.plugins.length;
             document.write(L.toString().bold() + " Plugin(s)".bold());
             document.write("<br>");
             document.write("Name | Filename | description".bold());
             document.write("<br>");
             for(var i=0; i<L; i++) {
                 document.write(navigator.plugins[i].name);
                 document.write(" | ");
                 document.write(navigator.plugins[i].filename);
                 document.write(" | ");
                 document.write(navigator.plugins[i].description);
                 document.write("<br>");
             }
         </script>

Returns the product name of the current browser.

See also

         <script>
         function prod() { 
             dt = document.getElementById("d"); 
             dt.innerHTML = window.navigator.product; 
         }
         </script> 
         <button onclick="prod();">product</button> 
         <div id="d"> </div> 
         // returns "Gecko"

Returns the build number of the current browser.

Note: On IE, this property returns undefined.

Note: On Apple Safari this property always returns 20030107.

See also

         <script> 
         function prodsub() {
             dt = document.getElementById("d").childNodes[0];
             dt.data = window.navigator.productSub;
         } 
         </script> 
         <button onclick="prodsub();">productSub</button>
         // returns: 20010725

Returns an empty string. In Netscape 4.7x, returns "US & CA domestic policy" or "Export policy".

See also

Retrieves the default language used by the operating system.

See also

Returns the user agent string for the current browser.

Note: Browser identification based on detecting the user agent string is unreliable and is not recommended, as the user agent string is user configurable.

• Mozilla Suite and Firefox can use the preference "general.useragent.override" in about:config. Some Firefox extensions or multi-bar do that.
• Opera 6+ allows users to set the browser identification string via a menu
• Microsoft Internet Explorer uses the Windows registry
• Safari and iCab allow users to change the browser user agent string to predefined Internet Explorer or Netscape strings via a menu.

See also

         alert(window.navigator.userAgent);
         // alerts "Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1"

Retrieves the operating system's natural language setting.

Note (IE): This property reflects the setting in the "Your locale (location)" box in the Regional Options of Control Panel—for example, "English (United States).

See also

Provides methods that allow a script to request read access to and perform read actions on a user's profile information.

Note (IE): As of Windows Internet Explorer 7, this object is obsolete and should not be used.

See also

         // Queue a request for read access to multiple profile attributes.
         navigator.userProfile.addReadRequest("vcard.displayname");
         navigator.userProfile.addReadRequest("vcard.gender");
         
         // Request access to the information.
         navigator.userProfile.doReadRequest(usage-code, "Acme Corporation");
         
         // Now perform read operations to access the information.
         name = navigator.userProfile.getAttribute("vcard.displayname");
         gender = navigator.userProfile.getAttribute("vcard.gender");
         
         // The script can now use the 'name' and 'gender' variables
         // to personalize content or to send information back to the server.
         
         // Clear the request queue to prepare for later information requests.
         navigator.userProfile.clearRequest();

Returns the vendor name of the current browser.

See also

         window.navigator.vendor 
         // returns "Netscape6"

Returns the vendor version number.

See also

         window.navigator.vendorSub 
         // returns "6.1" where the vendor part of userAgent is 
         // Netscape6/6.1

The getStorageUpdates() method, when invoked, must, if the storage mutex is owned by the event loop of the task that resulted in the method being called, release the storage mutex so that it is once again free. Otherwise, it must do nothing.

See also

Indicates whether the host browser is Java-enabled or not.

See also

         if (window.navigator.javaEnabled()) {
             // browser has java
         }

Allows code to determine whether or not a given resource is available.

Note: Security exceptions can occur if the requested URI is not from the same origin.

Parameters

         var available = navigator.mozIsLocallyAvailable("my-image-file.png", true);
         if (available) {
             /* the offline resource is present */
         } else {
             alert("Certain needed resources are not available until you connect to the network.");
         }

Sets a user preference. This method is only available to privileged code, and you should use XPCOM Preferences API instead.

See also

Allows web sites to register themselves as possible handlers for content of a particular MIME type.

Note: For Firefox 2, only the application/vnd.mozilla.maybe.feed, application/atom+xml, and application/rss+xml MIME types are supported. All values have the same effect, and the registered handler will receive feeds in all Atom and RSS versions.

Note: Web sites may only register content handlers for themselves. For security reasons, it's not possible for an extension or web site to register content handlers targeting other sites.

Parameters

See also

         navigator.registerContentHandler("application/vnd.mozilla.maybe.feed",
                                 "http://www.example.tld/?foo=%s",
                                 "My Feed Reader");

Allows web sites to register themselves as possible handlers for particular protocols.

Parameters

See also

navigator.registerProtocolHandler("mailto", "http://www.example.com/?uri=%s", "Example Mail");

Returns whether data tainting is enabled. JavaScript taint/untaint functions removed in JavaScript 1.2[1].

Note (IE): Microsoft Internet Explorer 5 and earlier does not support data tainting and therefore always returns false.

See also