node-memcached-client

Client library of Memcached for nodejs using ES6 promisified methods

Features

• Implemented ES6 features
• Any store and get operation returns Promise
• Auto reconnection if memcahed server is down unexpectedly
• Connection pooling per host, scaling

Installation

$ npm install node-memcached-client

Usage

Callback style connect:

const Memcached = require('node-memcached-client');
const client = new Memcached({
  host: 'localhost',
  port: 11211
});

client.on('connect', () => {
  client.set('foo', 'bar', false, 100)
  .then(() => {
      return client.get('foo');
  })
  .then(foo => {
    console.log(foo); // bar
    client.close();
  });
});
client.connect();

Promise style connect:

const Memcached = require('node-memcached-client');
const client = new Memcached({
  host: 'localhost',
  port: 11211
});

client.connect()
.then(c => {
  c.set('foo', 'bar', false, 100)
  .then(() => c.get('foo'))
  .then(foo => {
    console.log(foo); // bar
    c.close();
  });
});

Client Options

| name | type | default value | description | |:--------------------:|:-------:|:-------------:|:----------------------------------------:| | host | string | 'localhost' | Memcached server to connect | | port | Number | 11211 | Memcached port to connect | | autoreconnect | Boolean | false | Client tries to reconnect | | commandTimeout | Number | 2000 | Duration times of command timeout (msec) | | reconnectDuration | Number | 2000 | Duration times of reconnect (msec) | | maxRetryConnectCount | Numer | 10 | Retry times to reconnect |

Connection Pooling Settings

Pooling configuration enable to change by environment variables:

| name | type | default value | description | |:-------------------------------------:|:------:|:-------------:|:-----------------------------------------------:| | MEMCACHED_CLIENT_MAX_POOL_SIZE | Number | 1 | Connection pooling size per host:port signature | | MEMCACHED_CLIENT_SCALE_THRESHOLD_SIZE | Number | 100 | Threshold to increase client connection |