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.

sscan #

Identical to scan, except that sscan iterates the members held by a set of unique values.

[Redis documentation]


sscan(key, cursor, [options], callback) #

ArgumentsTypeDescription
keystringKey identifier
cursorintPage number (iteration starts with a cursor value of 0, and ends when the next cursor position is 0)
optionsJSON ObjectOptional parameters
callbackfunctionCallback

Options #

OptionTypeDescriptionDefault
countintReturn the approximate count number of items per result page10
matchstringSearch only for member values matching the provided pattern*
queuablebooleanMake this request queuable or nottrue

Callback Response #

Returns a JSON array containing 2 entries:

  • the cursor position for the next page of results (a next position of 0 indicates the end of the scan)
  • an array of members

Usage #

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

Callback response:

{
  "cursor": 18,
  "values": ["member1", "member2", "..."]
}