SDK
SDK Javascript v7.x
2

lrange #

Returns the list elements between the start and stop positions.

Offsets start at 0, and the range is inclusive.

[Redis documentation]

Arguments #

lrange(key, start, stop, [options]);

ArgumentsTypeDescription
key
string
List key
start
integer
Starting index (inclusive)
stop
integer
Ending index (inclusive)
options
object
Optional query arguments

The start and stop arguments can be negative. In that case, the offset is calculated from the end of the list, going backward. For instance, -3 is the third element from the end of the list.

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 #

Resolves to an array of list elements.

Usage #

try {
  await kuzzle.ms.rpush('listfoo', ['a', 'b', 'c', 'd', 'e', 'f']);
  // Prints: [ 'b', 'c', 'd' ]
  console.log(await kuzzle.ms.lrange('listfoo', 1, 3));
  // Prints: [ d', 'e' ]
  console.log(await kuzzle.ms.lrange('listfoo', 3, -2));
} catch (error) {
  console.error(error.message);
}