Added new fillStepPlot option for dygraph
[dygraphs.git] / auto_tests / README
1 These tests are run with js-test-driver
2 (http://code.google.com/p/js-test-driver/).
3
4 Running tests
5 -------------
6
7 With phantomjs:
8
9 - Install phantomjs (http://www.phantomjs.org).
10
11 - Start a terminal window at the dygraphs root directory (one
12   directory up from here.)
13
14 - Run "./test.sh". This will tell you whether the tests passed.
15
16
17 With a real browser:
18
19 - Start a terminal window at the dygraphs root directory (one
20   directory up from here.)
21
22 - From there, you start the test server and capture at least one slave
23   browser:
24
25    Run:
26    $ java -jar ./auto_tests/lib/JsTestDriver-1.3.3c.jar --port 9876
27   
28    Open
29    http://localhost:9876/capture
30    in the browser you want to use for your test.
31
32 - Run the tests with:
33
34   $ java -jar ./auto_tests/lib/JsTestDriver-1.3.3c.jar --tests all
35
36
37 Debugging tests
38 ---------------
39
40 This is a bit of a hack, but you can also run tests manually inside the browser
41 using auto_tests/misc/local.html.
42
43 Once you've opened that page, open up the JavaScript console and run something
44 like:
45
46   new SimpleDrawingTestCase().runTest("testDrawSimpleRangePlusOne")
47
48 to run just one test. This is useful for seeing the dygraph that the test
49 creates, setting breakpoints, etc.
50
51 Please don't rely on it as proof that your tests pass; the command-line is the
52 reference for ensuring Dygraphs automated tests pass.
53
54
55 (This is a specialized version of the instructions found at 
56 http://code.google.com/p/js-test-driver/wiki/GettingStarted.
57 They're listed as a courtesy, but you really should get to understand
58 js-test-driver, which has lots of powerful features.)