method

RedisClient.zrevrangebyscore

key: KeyLike,
max: string | number,
min: string | number
): Promise<string[]>;

Return members in a sorted set with scores within a given range, ordered from high to low

Returns all the elements in the sorted set at key with a score between max and min (note: max comes before min). The elements are considered to be ordered from high to low scores.

Score ranges support:

  • -inf and +inf for negative and positive infinity
  • ( prefix for exclusive bounds (e.g., (5 means less than 5, not including 5)
@param key

The sorted set key

@param max

Maximum score (can be "+inf", a number, or prefixed with "(" for exclusive)

@param min

Minimum score (can be "-inf", a number, or prefixed with "(" for exclusive)

@returns

Promise that resolves with array of members

await redis.send("ZADD", ["myzset", "1", "one", "2", "two", "3", "three"]);
const members = await redis.zrevrangebyscore("myzset", 2, 1);
// Returns: ["two", "one"]
key: KeyLike,
max: string | number,
min: string | number,
withscores: 'WITHSCORES'
): Promise<[string, number][]>;

Return members in a sorted set with scores within a given range, ordered from high to low, with scores

@param key

The sorted set key

@param max

Maximum score

@param min

Minimum score

@param withscores

The "WITHSCORES" keyword to return scores along with members

@returns

Promise that resolves with array of [member, score, member, score, ...]

await redis.send("ZADD", ["myzset", "1", "one", "2", "two", "3", "three"]);
const result = await redis.zrevrangebyscore("myzset", 2, 1, "WITHSCORES");
// Returns: ["two", "2", "one", "1"]
key: KeyLike,
max: string | number,
min: string | number,
limit: 'LIMIT',
offset: number,
count: number
): Promise<string[]>;

Return members in a sorted set with scores within a given range, ordered from high to low, with pagination

@param key

The sorted set key

@param max

Maximum score

@param min

Minimum score

@param limit

The "LIMIT" keyword

@param offset

The number of elements to skip

@param count

The maximum number of elements to return

@returns

Promise that resolves with array of members

key: KeyLike,
max: string | number,
min: string | number,
...options: string | number[]
): Promise<string[]>;

Return members in a sorted set with scores within a given range, ordered from high to low, with options

@param key

The sorted set key

@param max

Maximum score

@param min

Minimum score

@param options

Additional options (WITHSCORES, LIMIT offset count)

@returns

Promise that resolves with array of members (and scores if WITHSCORES is used)

Referenced types

type KeyLike = string | ArrayBufferView | Blob