window.open

Opens a URL in a new InAppBrowser instance, the current browser instance, or the system browser.

var ref = window.open(url, target, options);
  • ref: reference to the InAppBrowser window ([InAppBrowser](inappbrowser.html))
  • url: the URL to load (String). Call encodeURI() on this if you have Unicode characters in your URL.
  • target: the target to load the URL in (String) (Optional, Default: "_self")

    _self - opens in the Cordova WebView if url is in the white-list, else it opens in the InAppBrowser 
    _blank - always open in the InAppBrowser 
    _system - always open in the system web browser 
    
  • options: options for the InAppBrowser (String) (Optional, Default: "location=yes")

    The options string must not contain any blank space, each feature name and value must be separated by a comma. Only the value below is supported:

        location - set to 'yes' or 'no' to turn the location bar on or off for the InAppBrowser
    

Supported Platforms

  • Android
  • iOS

Quick Example

var ref = window.open('http://apache.org', '_blank', 'location=yes');
var ref2 = window.open(encodeURI('http://ja.m.wikipedia.org/wiki/ハングル'), '_blank', 'location=yes');

Full Example

<!DOCTYPE html>
<html>
  <head>
    <title>window.open Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova-2.3.0.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for Cordova to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // Cordova is ready
    //
    function onDeviceReady() {
        // external url
        var ref = window.open(encodeURI('http://apache.org'), '_blank', 'location=yes');
        // relative document
        ref = window.open('next.html', '_self');
    }

    </script>
  </head>
  <body>
  </body>
</html>