Skip to content

Incorrect acknowledgment callback signature when emitting before connection with ackTimeout option #5446

@rbgmulmb

Description

@rbgmulmb

Description

When emitting a message with an acknowledgment callback before the 'connected' event, and the socket is created with the ackTimeout option (but without explicitly using .timeout()), the callback receives an incorrect number of arguments.

Expected Behavior

When emitting a message with an acknowledgment callback without explicitly using .timeout(), the callback should receive only the server response as a single argument, regardless of whether the message is sent before or after the 'connected' event.

const socket = io(BASE_URL, {
  ackTimeout: 5000  // This should only affect timeout behavior, not callback signature
});

// Emitting before connection
socket.emit("test", (response) => {
  // Should receive: response (1 argument)
  console.log(response);
});

socket.on("connect", () => {
  // Emitting after connection
  socket.emit("test", (response) => {
    // Should receive: response (1 argument)
    console.log(response);
  });
});

Actual Behavior

When emitting before the 'connected' event with ackTimeout option set, the callback receives 2 arguments: (null, response) instead of just (response). This is inconsistent with emitting after the 'connected' event, where the callback correctly receives only 1 argument: (response).

const socket = io(BASE_URL, {
  ackTimeout: 5000
});

// Emitting before connection - INCORRECT BEHAVIOR
socket.emit("test", (err, response) => {
  // Receives: (null, response) - 2 arguments
  // Expected: (response) - 1 argument
  console.log(err);      // null
  console.log(response); // actual response
});

socket.on("connect", () => {
  // Emitting after connection - CORRECT BEHAVIOR
  socket.emit("test", (response) => {
    // Receives: (response) - 1 argument ✓
    console.log(response);
  });
});

Root Cause

The issue occurs in the _registerAckCallback method in lib/socket.ts. When ackTimeout is set (but this.flags.timeout is not explicitly set via .timeout()), the code wraps the callback and sets withError: true. This causes the onack method to prepend null to the response data, resulting in the callback being called with (null, ...responseArgs) instead of (...responseArgs).

The withError flag should only be set when the user explicitly uses .timeout(), not when only the ackTimeout option is configured. The ackTimeout option should only affect timeout behavior (i.e., when to trigger a timeout error), not the callback signature.

Steps to Reproduce

  1. Create a socket with ackTimeout option (but don't use .timeout())
  2. Emit a message with an acknowledgment callback before the 'connected' event
  3. Observe that the callback receives 2 arguments: (null, response)
  4. Emit the same message after the 'connected' event
  5. Observe that the callback receives 1 argument: (response)

Impact

This inconsistency makes it difficult to write code that handles acknowledgments uniformly, as developers must account for different callback signatures depending on when the message is emitted relative to the connection event.

Proposed Fix

Modify _registerAckCallback to only set withError: true when this.flags.timeout is explicitly set (via .timeout()), not when only ackTimeout option is configured. The timeout timer should still be set up for ackTimeout, but the callback signature should remain unchanged.

Metadata

Metadata

Assignees

No one assigned

    Labels

    to triageWaiting to be triaged by a member of the team

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions