Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[SignalR TS] Fix permanent Disconnecting state #30948

Merged
merged 4 commits into from
Mar 19, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions src/SignalR/clients/ts/signalr/src/HttpConnection.ts
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ export class HttpConnection implements IConnection {
private transport?: ITransport;
private _startInternalPromise?: Promise<void>;
private _stopPromise?: Promise<void>;
private _stopPromiseResolver!: (value?: PromiseLike<void>) => void;
private _stopPromiseResolver: (value?: PromiseLike<void>) => void = () => {};
private _stopError?: Error;
private _accessTokenFactory?: () => string | Promise<string>;
private _sendQueue?: TransportSendQueue;
Expand Down Expand Up @@ -215,7 +215,6 @@ export class HttpConnection implements IConnection {
this.transport = undefined;
} else {
this._logger.log(LogLevel.Debug, "HttpConnection.transport is undefined in HttpConnection.stop() because start() failed.");
this._stopConnection();
}
}

Expand Down Expand Up @@ -295,6 +294,9 @@ export class HttpConnection implements IConnection {
this._logger.log(LogLevel.Error, "Failed to start the connection: " + e);
this._connectionState = ConnectionState.Disconnected;
this.transport = undefined;

// if start fails, any active calls to stop assume that start will complete the stop promise
this._stopPromiseResolver();
return Promise.reject(e);
}
}
Expand Down
6 changes: 5 additions & 1 deletion src/SignalR/clients/ts/signalr/src/HubConnection.ts
Original file line number Diff line number Diff line change
Expand Up @@ -768,7 +768,11 @@ export class HubConnection {
this._logger.log(LogLevel.Information, `Reconnect attempt failed because of error '${e}'.`);

if (this._connectionState !== HubConnectionState.Reconnecting) {
this._logger.log(LogLevel.Debug, "Connection left the reconnecting state during reconnect attempt. Done reconnecting.");
this._logger.log(LogLevel.Debug, `Connection moved to the '${this._connectionState}' from the reconnecting state during reconnect attempt. Done reconnecting.`);
// The TypeScript compiler thinks that connectionState must be Connected here. The TypeScript compiler is wrong.
if (this._connectionState as any === HubConnectionState.Disconnecting) {
this._completeClose();
}
return;
}

Expand Down
19 changes: 13 additions & 6 deletions src/SignalR/clients/ts/signalr/tests/HttpConnection.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -137,23 +137,30 @@ describe("HttpConnection", () => {

it("can stop a starting connection", async () => {
await VerifyLogger.run(async (logger) => {
const stoppingPromise = new PromiseSource();
const startingPromise = new PromiseSource();
const options: IHttpConnectionOptions = {
...commonOptions,
httpClient: new TestHttpClient()
.on("POST", async () => {
await connection.stop();
startingPromise.resolve();
await stoppingPromise;
return "{}";
})
.on("GET", async () => {
await connection.stop();
return "";
}),
logger,
} as IHttpConnectionOptions;

const connection = new HttpConnection("http://tempuri.org", options);

await expect(connection.start(TransferFormat.Text))
const startPromise = connection.start(TransferFormat.Text)

await startingPromise;
const stopPromise = connection.stop();
stoppingPromise.resolve();

await stopPromise;

await expect(startPromise)
.rejects
.toThrow("The connection was stopped during negotiation.");
},
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,18 @@
// Licensed under the Apache License, Version 2.0. See License.txt in the project root for license information.

import { DefaultReconnectPolicy } from "../src/DefaultReconnectPolicy";
import { HttpConnection, INegotiateResponse } from "../src/HttpConnection";
import { HubConnection, HubConnectionState } from "../src/HubConnection";
import { IHttpConnectionOptions } from "../src/IHttpConnectionOptions";
import { MessageType } from "../src/IHubProtocol";
import { RetryContext } from "../src/IRetryPolicy";
import { JsonHubProtocol } from "../src/JsonHubProtocol";

import { VerifyLogger } from "./Common";
import { TestConnection } from "./TestConnection";
import { PromiseSource } from "./Utils";
import { TestHttpClient } from "./TestHttpClient";
import { TestWebSocket, TestEvent, TestMessageEvent } from "./TestWebSocket";

describe("auto reconnect", () => {
it("is not enabled by default", async () => {
Expand Down Expand Up @@ -785,4 +789,93 @@ describe("auto reconnect", () => {
}
});
});

it("can be stopped while restarting the underlying connection and negotiate throws", async () => {
await VerifyLogger.run(async (logger) => {
let onreconnectingCount = 0;
let onreconnectedCount = 0;
let closeCount = 0;

const nextRetryDelayCalledPromise = new PromiseSource();

const defaultConnectionId = "abc123";
const defaultConnectionToken = "123abc";
const defaultNegotiateResponse: INegotiateResponse = {
availableTransports: [
{ transport: "WebSockets", transferFormats: ["Text", "Binary"] },
{ transport: "ServerSentEvents", transferFormats: ["Text"] },
{ transport: "LongPolling", transferFormats: ["Text", "Binary"] },
],
connectionId: defaultConnectionId,
connectionToken: defaultConnectionToken,
negotiateVersion: 1,
};

const startStarted = new PromiseSource();
let negotiateCount = 0;

const options: IHttpConnectionOptions = {
WebSocket: TestWebSocket,
httpClient: new TestHttpClient()
.on("POST", async () => {
++negotiateCount;
if (negotiateCount === 1) {
return defaultNegotiateResponse;
}
startStarted.resolve();
return Promise.reject("Error with negotiate");
})
.on("GET", () => ""),
logger,
} as IHttpConnectionOptions;

const connection = new HttpConnection("http://tempuri.org", options);
const hubConnection = HubConnection.create(connection, logger, new JsonHubProtocol(), {
nextRetryDelayInMilliseconds() {
nextRetryDelayCalledPromise.resolve();
return 0;
},
});

hubConnection.onreconnecting(() => {
onreconnectingCount++;
});

hubConnection.onreconnected(() => {
onreconnectedCount++;
});

hubConnection.onclose(() => {
closeCount++;
});

TestWebSocket.webSocketSet = new PromiseSource();
const startPromise = hubConnection.start();
await TestWebSocket.webSocketSet;
await TestWebSocket.webSocket.openSet;
TestWebSocket.webSocket.onopen(new TestEvent());
TestWebSocket.webSocket.onmessage(new TestMessageEvent("{}\x1e"));

await startPromise;
TestWebSocket.webSocket.close();
TestWebSocket.webSocketSet = new PromiseSource();

await nextRetryDelayCalledPromise;

expect(hubConnection.state).toBe(HubConnectionState.Reconnecting);
expect(onreconnectingCount).toBe(1);
expect(onreconnectedCount).toBe(0);
expect(closeCount).toBe(0);

await startStarted;
await hubConnection.stop();

expect(hubConnection.state).toBe(HubConnectionState.Disconnected);
expect(onreconnectingCount).toBe(1);
expect(onreconnectedCount).toBe(0);
expect(closeCount).toBe(1);
},
"Failed to complete negotiation with the server: Error with negotiate",
"Failed to start the connection: Error with negotiate");
});
});
54 changes: 54 additions & 0 deletions src/SignalR/clients/ts/signalr/tests/TestWebSocket.ts
Original file line number Diff line number Diff line change
Expand Up @@ -231,3 +231,57 @@ export class TestCloseEvent implements Event {
public CAPTURING_PHASE: number = 0;
public NONE: number = 0;
}

export class TestMessageEvent implements MessageEvent {
constructor(data: any) {
this.data = data;
}
public data: any;
public lastEventId: string = "";
public origin: string = "";
public ports: readonly MessagePort[] = [];
public source: MessagePort | Window | ServiceWorker | null = null;
public composed: boolean = false;
public composedPath(): EventTarget[];
public composedPath(): any[] {
throw new Error("Method not implemented.");
}
public code: number = 0;
public reason: string = "";
public wasClean: boolean = false;
public initCloseEvent(typeArg: string, canBubbleArg: boolean, cancelableArg: boolean, wasCleanArg: boolean, codeArg: number, reasonArg: string): void {
throw new Error("Method not implemented.");
}
public bubbles: boolean = false;
public cancelBubble: boolean = false;
public cancelable: boolean = false;
public currentTarget!: EventTarget;
public defaultPrevented: boolean = false;
public eventPhase: number = 0;
public isTrusted: boolean = false;
public returnValue: boolean = false;
public scoped: boolean = false;
public srcElement!: Element | null;
public target!: EventTarget;
public timeStamp: number = 0;
public type: string = "";
public deepPath(): EventTarget[] {
throw new Error("Method not implemented.");
}
public initEvent(type: string, bubbles?: boolean | undefined, cancelable?: boolean | undefined): void {
throw new Error("Method not implemented.");
}
public preventDefault(): void {
throw new Error("Method not implemented.");
}
public stopImmediatePropagation(): void {
throw new Error("Method not implemented.");
}
public stopPropagation(): void {
throw new Error("Method not implemented.");
}
public AT_TARGET: number = 0;
public BUBBLING_PHASE: number = 0;
public CAPTURING_PHASE: number = 0;
public NONE: number = 0;
}