NOTE: some content in this wiki applies only to 0.12 and earlier versions. For official documentation on 0.13 and later, seehttp://docs.nwjs.io

Since v0.3.1

// Load native UI library
vargui=require('nw.gui');

// Print arguments
console.log(gui.App.argv);

// Quit current app
gui.App.quit();

// Get the name field in manifest
gui.App.manifest.name

Getthe command line arguments when starting the app.

Getall the command line arguments when starting the app. Because node-webkit itself used switches like--no-sandboxand--process-per-tab,it would confuse the app when the switches were meant to be given to node-webkit, soApp.argvjust filtered such switches (arguments' precedence were kept). You can get the switches to be filtered withApp.filteredArgv.

since v0.6.1

Getthe application's data path in user's directory. Windows:%LOCALAPPDATA%/<name>;Linux:~/.config/<name>;OSX:~/Library/Application Support/<name>where<name>is the field in the manifest.

since v0.7.0

Getthe JSON object of the manifest file.

Since v0.6.0

Clear the HTTP cache in memory and the one on disk. This method call is synchronized.

since v0.3.2

Send thecloseevent to all windows of current app, if no window is blocking thecloseevent, then the app will quit after all windows have done shutdown. Use this method to quit an app will give windows a chance to save data.

since v0.8.0

These 2 functions crashes the browser process and the renderer process respectively, to test theCrash dumpfeature.

since v0.6.3
Query the proxy to be used for loadingurlin DOM. The return value is in the same format used inPAC(e.g. "DIRECT", "PROXY localhost:8080" ).

since v0.11.1
Set the proxy config which the web engine will be used to request network resources.
Rule:

// Parses the rules from a string, indicating which proxies to use.
//
// proxy-uri = [<proxy-scheme> "://" ]<proxy-host>[ ":" <proxy-port>]
//
// proxy-uri-list = <proxy-uri>[ "," <proxy-uri-list>]
//
// url-scheme = "http" | "https" | "ftp" | "socks"
//
// scheme-proxies = [<url-scheme> "=" ]<proxy-uri-list>
//
// proxy-rules = scheme-proxies[ ";" <scheme-proxies>]
//
// Thus, the proxy-rules string should be a semicolon-separated list of
// ordered proxies that apply to a particular URL scheme. Unless specified,
// the proxy scheme for proxy-uris is assumed to be http.
//
// Some special cases:
// * If the scheme is omitted from the first proxy list, that list applies
// to all URL schemes and subsequent lists are ignored.
// * If a scheme is omitted from any proxy list after a list where a scheme
// has been provided, the list without a scheme is ignored.
// * If the url-scheme is set to 'socks', that sets a fallback list that
// to all otherwise unspecified url-schemes, however the default proxy-
// scheme for proxy urls in the 'socks' list is understood to be
// socks4:// if unspecified.
//
// For example:
// "http=foopy:80;ftp=foopy2" -- use HTTP proxy "foopy:80" for http://
// URLs, and HTTP proxy "foopy2:80" for
// ftp:// URLs.
// "foopy:80" -- use HTTP proxy "foopy:80" for all URLs.
// "foopy:80,bar,direct://" -- use HTTP proxy "foopy:80" for all URLs,
// failing over to "bar" if "foopy:80" is
// unavailable, and after that using no
// proxy.
// "socks4://foopy" -- use SOCKS v4 proxy "foopy:1080" for all
// URLs.
// "http=foop,socks5://bar -- use HTTP proxy" foopy "for http URLs,
// and fail over to the SOCKS5 proxy
//" bar "if" foop "is unavailable.
//" http=foopy,direct:// -- use HTTP proxy "foopy" for http URLs,
// and use no proxy if "foopy" is
// unavailable.
// "http=foopy;socks=foopy2 -- use HTTP proxy" foopy "for http URLs,
// and use socks4://foopy2 for all other
// URLs.

Quit current app. This method willnotsendcloseevent to windows and app will just quit quietly.

since v0.8.0

Set the directory where the minidump file will be saved on crash. For more information, seeCrash dump

since v0.10.0-rc1
Add an entry to the whitelist used for controlling cross-origin access. Suppose you want to allow HTTP redirecting fromgithubto the page of your app, use something like this with theApp-protocol:

App.addOriginAccessWhitelistEntry('http://github /','app','myapp',true);

UseApp.removeOriginAccessWhitelistEntrywith exactly the same arguments to do the contrary.

since v0.10.0-rc1
Remove an entry from the whitelist used for controlling cross-origin access. SeeaddOriginAccessWhitelistEntryabove.

since v0.10.0

Register a global keyboard shortcut (also known as system-wide hot key) to the system.

For more information, please seeShortcut.

since v0.10.0

Unregisters a global keyboard shortcut.

For more information, please seeShortcut.

Following events can be listened by usingApp.on()function, for more information on how to receive events, you can visitEventEmitter.

Since v0.3.2

Emitted when users opened a file with your app. There is a single parameter of this event callback: Since v0.7.0, it is the full command line of the program; before that it's the argument in the command line and the event is sent multiple times for each of the arguments. For more on this, seeHandling files and arguments.

since v0.7.3

This is a Mac specific feature. This event is sent when the user clicks the dock icon for an already running application.