-
Notifications
You must be signed in to change notification settings - Fork 10.1k
Description
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
- Create a socket with
ackTimeoutoption (but don't use.timeout()) - Emit a message with an acknowledgment callback before the 'connected' event
- Observe that the callback receives 2 arguments:
(null, response) - Emit the same message after the 'connected' event
- 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.