Needful Program Management

    redis-errors
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/redis-errors package

    1.2.0 • Public • Published

    js-standard-style

    redis-errors

    All error classes used in node_redis from v.3.0.0 are in here. They can be required as needed.

    Install

    Install with NPM:

    npm install redis-errors

    Usage

    const { ReplyError, InterruptError } = require('redis-errors');
     
    // Using async await
    try {
      await client.set('foo') // Missing value
    } catch (err) {
      if (err instanceof InterruptError) {
        console.error('Command might have been processed')
      }
      if (err instanceof ReplyError) {
        // ...
      }
      throw err
    }
     
    // Using callbacks
    client.set('foo', (err, res) => {
      if (err) {
        if (err instanceof InterruptError) {
          // ...
        }
      }
    })

    Error classes

    All errors returned by NodeRedis use own Error classes. You can distinguish different errors easily by checking for these classes.

    To know what caused the error they might contain properties to know in more detail what happened.

    Each error contains a message, a name and a stack property. Please be aware that the stack might not be useful due to the async nature and is in those cases therefore limited to two frames.

    There might be more not yet documented properties as well. Please feel free to open a pull request to document those as well.

    RedisError

    Properties:

    Properties depend on the individual error.

    All errors returned by NodeRedis (client) are RedisErrors.
    Subclass of Error

    ReplyError

    Properties:

    • args: The arguments passed to the command.
    • command: The command name.
    • code: The Redis error code. Redis itself uses some internal error codes.

    All errors returned by Redis itself (server) will be a ReplyError.
    Subclass of RedisError

    ParserError

    Properties:

    • buffer: The raw buffer input stringified.
    • offset: The character count where the parsing error occurred.

    Parsing errors are returned as ParserError.
    Subclass of RedisError Note: If you encounter one of these please report that error including the attached offset and buffer properties!

    AbortError

    Properties:

    • args: The arguments passed to the command.
    • command: The command name.

    If a command was not yet executed but rejected, it'll return a AbortError.
    Subclass of RedisError

    InterruptError

    Properties:

    • args: The arguments passed to the command.
    • command: The command name.
    • origin: The original error that caused the interrupt

    All executed commands that could not fulfill (e.g. network drop while executing) return a InterruptError.
    Subclass of AbortError
    Note: Interrupt errors can happen for multiple reasons that are out of the scope of NodeRedis itself. There is nothing that can be done on library side to prevent those.

    License

    MIT

    Install

    npm i redis-errors

    DownloadsWeekly Downloads

    2,871,173

    Version

    1.2.0

    License

    MIT

    Last publish

    Collaborators

    • salakar
    • bridgear