CocktailJS is a small library to explore traits, talents, inheritance and annotations concepts in nodejs - Shake your objects and classes with Cocktail!

npm install cocktail
2 downloads in the last day
15 downloads in the last week
158 downloads in the last month

Cocktail JS

Build Status NPM version Code Climate

Cocktail is a small but yet powerful library with very simple principles:

  • Reuse code
  • Keep it simple

Reuse code

Cocktail explores three mechanisms to share/reuse/mix code:

  • Extends: Classical OOP inheritance implemented in Javascript.
  • Traits: Traits are composable behavior units that can be added to a Class.
  • Talents: Same idea as Traits but applied to instances of a Class.

Keep it simple

Cocktail has only one public method cocktail.mix() but it relies on annotations to tag some meta-data that describe the mix.


Annotations are simple meta-data Cocktail uses to perform some tasks over the given mix. They become part of the process but usually they are not kept in the result of a mix.

var cocktail = require('cocktail'),
    MyClass  = function(){};

cocktail.mix(MyClass, {
    '@properties': {
        name: 'default name'

In the example above we created a "Class" named MyClass, and we use the @properties annotation to create the property name and the corresponding setName and getName methods.

As it was mentioned before, annotations are meta-data, which means that they are not part of MyClass or its prototype.

Combine Annotations and single parameter to export your class definition

Since version 0.2.0 you can define a class or trait without passing the constructor as the first parameter, and you can export the result of the mix with one annotation so you don't forget module.exports = MyClass:


var cocktail = require('cocktail'),
    MySuperClass = require('./MySuperClass');

    '@extends': MySuperClass,
    '@exports': module,
    '@properties' : {
        name: 'a default name'

Even easier Single Parameter Class Definition

Version 0.3 introduces a pseudo-annotation @as to help Single Parameter Class Definition. Now you can define a Class using @as passing a value of class:


var cocktail = require('cocktail')

    '@exports' : module,
    '@as'      : 'class',

    '@properties' : {
        name: 'a default name'

Getting Started

  • Install the module with: npm install cocktail or add cocktail to your package.json and then npm install
  • Start playing by just adding a var cocktail = require('cocktail') in your file.


Guides can be found at CocktailJS Guides


The latest documentation is published at CocktailJS Documentation


A Cocktail playground can be found in cocktail recipes repo.


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Running Tests

Add your unit and/or integration tests and execute

$ grunt test

Before Commiting

Run grunt to check lint and execute tests

$ grunt

Check test code coverage with instanbul

Install instanbul from npm globally if you don't have it already installed

$ npm install -g istanbul 


$ istanbul cover _mocha -- -u exports --recursive test

Release History



Copyright (c) 2013 Maximiliano Fierro
Licensed under the MIT license.

npm loves you