• Public
  • Public/Protected
  • All


Table of Contents

Hazelcast Node.js Client

NOTE: This project is currently in active development.

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

This document explains Node.js client for Hazelcast which uses Hazelcast's Open Client Protocol 1.0. This client works with 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 a feature-rich, enterprise-ready and developer-friendly in-memory data grid solution.


Hazelcast Node.js client supports the following data structures and features:

  • Map (including entry processors and PartitionAware keys) and MultiMap
  • Queue, Set, and List
  • Lock
  • Smart Client
  • Hazelcast Native Serialization
  • Distributed Object Listener
  • Lifecycle Service

Installing the Client

Following command installs Hazelcast Node.js client:

npm install hazelcast-client --save

Using the Client

Following script illustrates a basic example in which a map is created in Hazelcast Node.js client and an entry is added to that map:

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) {

Please see Hazelcast Node.js code samples for more examples.

You can also refer to Hazelcast Node.js API Documentation.


Building And Installing from Sources

Follow the below steps to build and install Hazelcast Node.js client from its source:

Using Locally Installed Package

  • Change directory to the project directory.
  • Use a locally linked module: npm link hazelcast-client.
  • Tryout the example shown in Using the Client section.


Testing Prerequisites

  • Java 6+
  • Maven

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

Running the Tests

Following command starts the tests:

npm test

Release Notes

You can see the release notes for each release on the Releases page.

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 information.

Generated using TypeDoc