JS.Class

Introduction

• Getting started
• Supported platforms
• Package manager
• Testing tools
• License & acknowledgements

Community

• Mailing list
• GitHub repository

Core reference

• Creating classes
• Using Modules
• Modifying classes/modules
• Singleton methods
• Class methods
• Keyword methods
• Inheritance
• Method binding
• Metaprogramming hooks
• Reflection
• Debugging support
• The Kernel module
• Equality and hashing
• Interfaces
• Singletons

Standard library

• Benchmark
• Command
• Comparable
• Console
• ConstantScope
• Decorator
• Deferrable
• Enumerable
• Enumerator
• Forwardable
• Hash, OrderedHash
• LinkedList
• MethodChain
• Observable
• Proxy
• Range
• Set, OrderedSet, SortedSet
• StackTrace
• State
• TSort

Context blocks

JS.Test specs are arranged in nested context blocks, much like in RSpec, Jasmine and other frameworks. Contexts are delimited by describe blocks (you can use context instead of describe). Within each block you can have multiple before and after blocks, that describe what to do before and after each test. The tests themselves are added using the it or should function.

Each test is run by performing the following tasks:

• The before blocks from all the enclosing contexts are run from outermost to innermost.
• The test itself is run.
• The after blocks from all the enclosing contexts are run in order, this time from innermost to outermost.

For example, the following test run prints:

outer before
outer test
outer after

outer before
INNER before
INNER test
INNER after
outer after

ThingSpec = JS.Test.describe("thing", function() { with(this) {
    before(function() { this.puts("outer before") });
    after (function() { this.puts("outer after") });

    it("has tests", function() { with(this) {
        puts("outer test");
    }});

    describe("nested", function() { with(this) {
        before(function() { this.puts("INNER before") });
        after (function() { this.puts("INNER after") });

        it("does something", function() { with(this) {
            puts("INNER test");
        }});
    }});
}});

Your before and after blocks are run once for every it block in your tests. before blocks are typically used to create or modify the objects you want to test, and after blocks are used to reset any global state you may have changed during the tests, for example to clear out a database.