Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

component-test

test components locally or with phantom

readme

component-test

Minimal configuration component test runner supporting browser testing, phantomjs, and saucelabs.

Installation

npm install -g component-test

API

Browser

In browser testing

component test browser

browser

Phantom

Test using phantomjs.

component test phantom

phantom

Saucelabs

Test using saucelabs.

component test sauce -b "iphone 6.0 Mac OS 10.8, firefox 5 Windows XP"

saucelabs

Travis

First download the travis gem:

gem install travis

Encrypt your credentials:

travis encrypt SAUCE=username:accessKey -r component/domify

Then add the browsers you want to test. Here's what the component/domify .travis.yml looks like:

language: node_js
node_js:
  - '0.10'
env:
  global:
    - secure: PT7QR0DCGcZ+JjH4kpsaGHPYyjdbKbm44Wj9nsHA/QgIG/FRBCvsAU1OyaWHF8KCP6p0TEfhgeW+vUlZfxlbpDa4eSR8kjqkcNTR1CWKqYfjjQzBFzibrmLE+gKOnIRxFhdwUjzatRc1A2B+jX/03HoIgsUhnG83xiinz21dBJI=
  matrix:
    - BROWSER="iphone 6.1 Mac 10.8"
    - BROWSER="ipad 5.1 Mac 10.8"
    - BROWSER="firefox 6 Mac 10.6"d

And here's the result:

travis

TODO

  • Offer higher-level API over saucelabs in separate repo (like zuul)
  • Use Travis API for encryption (eg. mimic behavior of travis encrypt)
  • Provide API for adding browsers to .travis.yml

License

(The MIT License)

Copyright (c) 2013 Matthew Mueller <mattmuelle@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

changelog

0.1.6 / 2016-05-20

NPM 3 tries to install dependencies in a flat structure and therefore references to those dependencies now need to use a dynamic lookup (e.g. require.resolve()) instead of assuming a particular relative file path. - #37

0.1.5 / 2015-09-16

The changes fix a bug where the tool hangs due to the user having a newer version of phantomjs in their path than what is compatible with the tool. The changes fix the issue by bundling its own version of phantomjs as a dependency instead of relying on the version of phantomjs installed in the developer's path. - #36

0.1.4 / 2014-10-16

  • Release 0.1.4
  • Fix spawn on Windows - #33
  • add mocha-phantomjs hook to write coverage stats to a file
  • update mocha-phantomjs for custom reporter support

0.1.3 / 2014-01-24

  • give an error if no build/ dir present
  • Updated misleading wording in travis/saucelabs docs (@jb55)
  • component-test2 => component-test thanks to @ask11
  • pass arguments through to mocha-phantomjs

0.1.2 / 2013-12-19

  • pin mocha cloud
  • have errors pass through mochaResults

0.1.1 / 2013-12-19

  • remove extra deps

0.1.0 / 2013-12-18

  • add tunnel option to browser
  • add debug statements
  • listen for JS errors
  • prevent IE from going into compatibility mode
  • browser: choose which browser to open
  • phanton: cleanup stream handling
  • use the name property of component.json as the document’s title

0.0.1 / 2010-01-03

  • Initial release