karma-ios-launcher

karma-ios-launcher
==================

Karma launcher for the Xcode iOS Simulator.


This Karma plugin adds a browser launcher for the Xcode iOS Simulator.

Requirements
------------

This module currently requires the canary version of Karma:

``sh
$ npm install 'karma@canary' --save-dev
`

Note that the Karma configuration file format has changed since v0.8. Use
karma init to generate a fresh config.

You must also have Xcode installed as well as the iOS Simulator.


Installation
------------

Install the plugin from npm:

`sh
$ npm install karma-ios-launcher --save-dev
`

Or from Github:

`sh
$ npm install 'git+https://github.com/xdissent/karma-ios-launcher.git' --save-dev
`

Add iOS to the browsers key in your Karma configuration:

`coffee
module.exports = (karma) ->
karma.configure

# Start these browsers:
browsers = [
'iOS'
]

# ...
`


Usage
-----

Just run your tests!

`sh
$ karma start
INFO [karma]: Karma v0.9.3 server started at http://localhost:9876/
INFO [launcher]: Starting browser iOS
INFO [Mobile Safari 6.0.0 (iOS 6.1)]: Connected on socket id iDIO2uQQP4qe6dFRjn6p
Mobile Safari 6.0.0 (iOS 6.1): Executed 1 of 1 SUCCESS (0.219 secs / 0.063 secs)
TOTAL: 1 SUCCESS
`

If you'd like to see the debug output from iosctrl, set the DEBUG
environment variable to iosctrl:*:

`sh
$ export DEBUG='iosctrl:*' # for bash
`

`sh
$ set -x DEBUG 'iosctrl:*' # for fish
``