Redis ZREVRANGEBYSCORE with Node.js (Detailed Guide w/ Code Examples)

Use Case(s)

The ZREVRANGEBYSCORE command in Redis is used to retrieve a range of members from a sorted set stored in Redis, where the members are returned in descending order by their scores. Common use cases include:

  • Leaderboards: Retrieving top user scores or rankings.
  • Time-series data analysis: Fetching recent entries first based on timestamp-sorted sets.
  • Priority Queueing Systems: Processing higher priority tasks or messages before others.

Code Examples

Example 1: Basic Usage

This example demonstrates how to retrieve members with the highest scores from a sorted set named 'game_scores'.

const redis = require('redis'); const client = redis.createClient(); client.zrevrangebyscore('game_scores', '+inf', '-inf', 'WITHSCORES', (err, members) => { if (err) throw err; console.log(members); // Outputs members and their scores, highest score first }); client.quit();

In this code, '+inf' and '-inf' denote the maximum and minimum possible scores, respectively, fetching all elements from the set in descending order.

Example 2: Range Query with Limit

To fetch only the top 3 players from the leaderboard:

const redis = require('redis'); const client = redis.createClient(); client.zrevrangebyscore('game_scores', '+inf', 0, 'WITHSCORES', 'LIMIT', 0, 3, (err, members) => { if (err) throw err; console.log(members); // Outputs top 3 scores }); client.quit();

Here, 'LIMIT', 0, 3 is used to limit the response to the top three results.

Best Practices

  • Handling Large Data Sets: For large sorted sets, it's efficient to paginate results using the LIMIT clause to avoid high memory usage on both the server and client-side.
  • Connection Management: Always properly manage Redis connections—use pooling if applicable and ensure connections are closed after use.

Common Mistakes

  • Ignoring Score Boundaries: When using ZREVRANGEBYSCORE without specifying boundaries or using incorrect ones, it might result in unexpected responses or performance issues.
  • Misunderstanding Order of Scores: Since ZREVRANGEBYSCORE returns values in descending order, ensure that your application logic correctly handles the order of items.


Q: Can ZREVRANGEBYSCORE handle negative scores? A: Yes, ZREVRANGEBYSCORE can handle any floating-point number as a score, including negatives.

Q: What does 'WITHSCORES' do in ZREVRANGEBYSCORE? A: The 'WITHSCORES' option makes the command return both the members and their corresponding scores instead of just the members.

Was this content helpful?

Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.