public
Fork of nathansobo/screw-unit
Description: A Javascript BDD Framework with nested describes, a convenient assertion syntax, and an intuitive test browser.
Clone URL: git://github.com/nkallen/screw-unit.git
Click here to lend your support to: screw-unit and make a donation at www.pledgie.com !
screw-unit / EXAMPLE.html
100644 68 lines (64 sloc) 2.856 kb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
<html>
  <!--
This file is a fully-functioning example test case. Try opening this file in Firefox, Safari,
or Internet Explorer to see what a running test looks like.
This file demonstrates the components involved in writing a simple test, such as:
* The necessary HTML to run a test (with the required <script> and <link rel="stylesheet"> tags),
* A "custom matcher" (i.e., a custom assertion) to make your tests more readable,
* And, a simple test with the necessary boiler-plate code to get you up and running.
Typically, these components are separated out into multiple files. To see what a more typical suite
of tests look like, look at the larger example in the examples/ directory.
-->
  <head>
    <!-- These are all of the necessary javascript and css files required to run your tests -->
    <script src="lib/jquery-1.2.6.js"></script>
    <script src="lib/jquery.fn.js"></script>
    <script src="lib/jquery.print.js"></script>
    <script src="lib/screw.builder.js"></script>
    <script src="lib/screw.matchers.js"></script>
    <script src="lib/screw.events.js"></script>
    <script src="lib/screw.behaviors.js"></script>
    <link rel="stylesheet" href="lib/screw.css">
    
    <script type="text/javascript">
      // Here is the system under test (SUT)--that is, your application code that you would like
      // to test.
      function foo() {
        return 2;
      }
    </script>
    
    <script type="text/javascript">
      // Here is a Custom Matcher. A custom matcher is a custom assertion,
      // tailored to your application; these help to make your tests more readable.
      Screw.Matchers["be_even"] = {
        match: function(expected, actual) {
          return actual % 2 == 0;
        },
        failure_message: function(expected, actual, not) {
          return 'expected ' + $.print(actual) + (not ? ' not' : '') + ' to be even';
        }
      }
    </script>
    
    <script type="text/javascript">
      // Here is a sample test. Note that all tests are wrapped in
      // "Screw.Unit(function() { ... })".
      Screw.Unit(function() {
        // Tests are organized into 'describes' and 'its', following the style of RSpec.
        describe("foo", function() {
          it("returns 2", function() {
            // 'equal' is one among many matchers provided with the Screw.Unit distribution. It
            // is smart enough to compare arrays, objects, and primitives.
            expect(foo()).to(equal, 2);
          });
        });
        
        describe("numbers", function() {
          // Here is a use of the custom matcher defined above.
          it("either is or is not even", function() {
            expect(2).to(be_even);
            expect(3).to_not(be_even);
          });
        });
      });
    </script>
  </head>
  <body></body>
</html>