SDK
SDK Javascript v5.x
1

You are currently looking at the documentation of a previous version of Kuzzle. We strongly recommend that you use the latest version. You can also use the version selector in the top menu.

setnx #

Sets a value on a key, only if it does not already exist.

[Redis documentation]


setnx(key, value, [options], [callback]) #

ArgumentsTypeDescription
keystringKey identifier
valuestringValue to store
optionsJSON ObjectOptional parameters
callbackfunctionCallback

Options #

OptionTypeDescriptionDefault
queuablebooleanMake this request queuable or nottrue

Return Value #

Returns the MemoryStorage object to allow chaining.


Callback Response #

Returns a boolean specifying if the operation was successful or not.

Usage #

// Using callbacks (NodeJS or Web Browser)
kuzzle.memoryStorage.setnx('key', 'value', function (err, status) {
  // callback called once the action has completed
});
// Using promises (NodeJS only)
kuzzle.memoryStorage.setnxPromise('key', 'value')
  .then(status => {
    // resolved once the action has completed
  });

Callback response:

true