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

Singletons

A singleton class is one which can only ever have one instance. The concept is more useful in Java, where you cannot create an object without first creating a class. JavaScript allows objects without classes (indeed, it has no classes, only objects) but using JS.Singleton lets you create custom objects from existing JS.Class classes, allowing you to inherit methods, include modules and use method() et al.

var Camel = new JS.Singleton(Animal, {
    fillHumpsWithWater: function() { ... }
});

// You can call instance methods...
Camel.speak('the desert');    // from Animal
Camel.fillHumpsWithWater();

var s = Camel.method('speak');
s('drinking');

Camel.klass.superclass    // -> Animal

JS.Singleton just creates a class with the arguments you give it, immediately instantiates this new class and returns the instance. You can access the class through Camel.klass as shown above.