This version of the documentation is outdated! Click here for the latest released version.

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. Feature names are case insensitive. Only the value below is supported on all platforms:
- location - set to 'yes' or 'no' to turn the location bar on or off for the InAppBrowser
iOS only ——--
- enableViewportScale - set to 'yes' or 'no' to prevent viewport scaling through a meta tag (defaults to 'no')
- mediaPlaybackRequiresUserAction - set to 'yes' or 'no' to not allow autoplayed HTML5 video (defaults to 'no')
- allowInlineMediaPlayback - set to 'yes' or 'no' to allow inline HTML5 media playback, also, the video element in the HTML document must also include the webkit-playsinline attribute (defaults to 'no')
- keyboardDisplayRequiresUserAction - set to 'yes' or 'no' to open the keyboard when form elements get focus via the JavaScript focus() call (defaults to 'yes')
- suppressesIncrementalRendering - set to 'yes' or 'no' to wait until all new view content has been received before it is rendered (defaults to 'no')
- presentationstyle - set to 'pagesheet', 'formsheet' or 'fullscreen' to set the presentation style (defaults to 'fullscreen')
- transitionstyle - set to 'fliphorizontal', 'crossdissolve' or 'coververtical' to set the transition style (defaults to 'coververtical')

Supported Platforms

Android
iOS
BlackBerry 10
Windows Phone 7 + 8

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-x.x.x.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>