• Public
  • Public/Protected
  • All


Hazelcast Node.js Client

Node.js Client for Hazelcast, using Hazelcast Open Client Protocol 1.0 for Hazelcast 3.6 and higher

Hazelcast is a clustering and highly scalable data distribution platform.

With its various distributed data structures, distributed caching capabilities, elastic nature and more importantly with so many happy users, Hazelcast is feature-rich, enterprise-ready and developer-friendly in-memory data grid solution.

NOTE: This project is currently in active development.

Join the chat at https://gitter.im/hazelcast-incubator/hazelcast-nodejs-client

Implemented Features

  • Map (except EntryProcessors)
  • Set
  • Queue
  • List
  • Lock
  • MultiMap
  • Hazelcast Native Serialization
  • Distributed Object Listener
  • Lifecycle Service
  • Smart Client


npm install hazelcast-client --save


var HazelcastClient = require('hazelcast-client').Client;
var person = {
    firstName: "Joe",
    lastName: "Doe",
    age: 42
var map;
HazelcastClient.newHazelcastClient().then(function (hazelcastClient) {
    map = hazelcastClient.getMap("personMap");
    map.put(1, person).then(function (val) {
        // prints previous value for key `1`
    map.get(1).then(function (value) {

Take a look at code samples for further information.

Or see API Docs

What's New in 0.4

  • Performance improvements
  • Predicates for Map
  • Lock
  • MultiMap
  • Bugfixes in Hazelcast Serialization


Build And Install hazelcast-client From Sources

Use Locally Installed Package

  • cd to project directory
  • use a locally linked module npm link hazelcast-client
  • follow usage example


Test Prerequisites

  • Java 6+
  • Maven

      Maven automatically downloads hazelcast-remote-controller and hazelcast from maven repository.

Running the tests

npm test

Mail Group

Please join the mail group if you are interested in using or developing Hazelcast.



Hazelcast is available under the Apache 2 License. Please see the Licensing appendix for more information.

Copyright (c) 2008-2016, Hazelcast, Inc. All Rights Reserved.

Visit www.hazelcast.com for more info.

Generated using TypeDoc