cordova-serve

cordova-serve

This module can be used to serve up a Cordova application in the browser. It has no command-line, but rather is intended to be called using the following API:

var serve = require('cordova-serve');
serve.launchServer(opts);
serve.servePlatform(platform, opts);
serve.launchBrowser(ops);

launchServer()

launchServer(opts);

Launches a server with the specified options. Parameters:

• opts: Options, as described below.

servePlatform()

servePlatform(platform, opts);

Launches a server that serves up any Cordova platform (e.g. browser, android etc) from the current project. Parameters:

• opts: Options, as described below. Note that for servePlatform(), the root value should be a Cordova project's root folder, or any folder within it - servePlatform() will replace it with the platform's www_dir folder. If this value is not specified, the cwd will be used.

launchBrowser()

launchBrowser(opts);

Launches a browser window pointing to the specified URL. The single parameter is an options object that supports the following values (both optional):

• url: The URL to open in the browser.
• target: The name of the browser to launch. Can be any of the following: chrome, chromium, firefox, ie, opera, safari. If no browser is specified,

The opts Options Object

The opts object passed to launchServer() and servePlatform() supports the following values (all optional):

• root: The file path on the local file system that is used as the root for the server, for default mapping of URL path to local file system path.
• port: The port for the server. Note that if this port is already in use, it will be incremented until a free port is found.
• router: An ExpressJS router. If provided, this will be attached before default static handling.
• noLogOutput: If true, turns off all log output.
• noServerInfo: If true, cordova-serve won't output Static file server running on... message.
• events: An EventEmitter to use for logging. If provided, logging will be output using events.emit('log', msg). If not provided, console.log() will be used. Note that nothing will be output in either case if noLogOutput is true.