Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Open source

Client.llen(key)

Returns the length of the list stored at key. If key does not exist, it is interpreted as an empty list and 0 is returned.

Parameters

ParameterTypeDescription
keystringkey holding the list to get the length of.

Returns

TypeResolves withRejected when
Promise<number>On success, the promise resolves with the length of the list at key.If the list does not exist, the promise is rejected with an error.

Example

JavaScript
import redis from 'k6/experimental/redis';

// Get the redis instance(s) address and password from the environment
const redis_addrs = __ENV.REDIS_ADDRS || '';
const redis_password = __ENV.REDIS_PASSWORD || '';

// Instantiate a new redis client
const redisClient = new redis.Client({
  addrs: redis_addrs.split(',') || new Array('localhost:6379'), // in the form of 'host:port', separated by commas
  password: redis_password,
});

export default function () {
  redisClient
    .rpush('mylist', 'first')
    .then((_) => redisClient.rpush('mylist', 'second'))
    .then((_) => redisClient.rpush('mylist', 'third'))
    .then((_) => redisClient.llen('mylist'))
    .then((length) => {
      if (length !== 3) {
        throw new Error('llen operations should have returned 3');
      }
    });
}