SDK
SDK Javascript v7.x
2

hsetnx #

Sets a field and its value in a hash, only if the field does not already exist.

[Redis documentation]

Arguments #

hsetnx(key, [options]);

ArgumentsTypeDescription
key
string
Key
options
object
Optional query arguments

options #

The options arguments can contain the following option properties:

PropertyType (default)Description
queuable
boolean (true)
If true, queues the request during downtime, until connected to Kuzzle again
timeout
number

(-1)
Time (in ms) during which a request will still be waited to be resolved. Set it -1 if you want to wait indefinitely
triggerEvents
boolean

(false)
If set to true, will trigger events even if using Embeded SDK. You should always ensure that your events/pipes does not create an infinite loop.
Available since Kuzzle 2.31.0

Resolve #

Usage #

try {
  // Prints: true
  console.log(await kuzzle.ms.hsetnx('hashfoo', 'foo', 'bar'));
  // Prints: false
  console.log(await kuzzle.ms.hsetnx('hashfoo', 'foo', 'qux'));
  // Prints: bar
  console.log(await kuzzle.ms.hget('hashfoo', 'foo'));
} catch (error) {
  console.error(error.message);
}