Українська
З’єднання SignalR
Крок 1. Життєвий цикл з’єднання
Навіщо. Хаб із теми 14 надсилає одинадцять видів подій у групи чатів користувача. Клієнту потрібне рівно одне з’єднання на кожну вкладку браузера з увімкненим входом – не по одному на сторінку, – яке:
- запускається, коли користувач входить, і зупиняється, коли виходить;
- автентифікується поточним токеном доступу, також коли перепідключається за годину;
- сама перепідключається після збоїв мережі й не здається, навіть коли власні спроби SignalR вичерпано;
- повідомляє сховища після перепідключення, що вони могли пропустити події.
@microsoft/signalr (тема 15) – офіційний клієнт. HubConnectionBuilder створює з’єднання, що домовляється про найкращий транспорт – WebSockets, а як запасні варіанти Server-Sent Events і довге опитування, – і викликає обробники, зареєстровані через connection.on(name, handler), коли сервер викликає метод клієнта.
Що зробити. Створіть сервіс:
ts
import { Injectable, effect, inject, signal, untracked } from '@angular/core';
import {
HubConnection,
HubConnectionBuilder,
HubConnectionState,
LogLevel,
} from '@microsoft/signalr';
import { Subject } from 'rxjs';
import { AuthService } from '../auth/auth.service';
import { MessageDto } from '../api/models';
export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
/** Server → client events of the /hubs/chat hub. */
export type HubEvent =
| { type: 'messageCreated'; message: MessageDto }
| { type: 'messageUpdated'; message: MessageDto }
| { type: 'messageDeleted'; chatId: string; messageId: string }
| { type: 'messagesRead'; chatId: string; userId: string; lastReadMessageId: string }
| { type: 'membersAdded'; chatId: string; userIds: string[] }
| { type: 'memberRemoved'; chatId: string; userId: string }
| { type: 'chatUpdated'; chatId: string }
| { type: 'chatDeleted'; chatId: string }
| { type: 'typing'; chatId: string; userId: string }
| { type: 'userOnline'; userId: string }
| { type: 'userOffline'; userId: string; lastSeenAt: string };
const TYPING_THROTTLE_MS = 3_000;
const RETRY_DELAYS_MS = [0, 2_000, 5_000, 10_000, 30_000];
/**
* The SignalR connection. It runs while the user is signed in, reconnects on its own, and after a
* reconnect emits `connected` with `reconnected: true` so stores can fetch what they missed.
*/
@Injectable({ providedIn: 'root' })
export class RealtimeService {
private readonly auth = inject(AuthService);
private connection: HubConnection | null = null;
private retryTimer: ReturnType<typeof setTimeout> | undefined;
private attempt = 0;
private everConnected = false;
private readonly lastTypingSent = new Map<string, number>();
readonly state = signal<ConnectionState>('disconnected');
readonly events = new Subject<HubEvent>();
/** Fires on every (re)connect; `reconnected` is true when there may be a gap to fill. */
readonly connected = new Subject<{ reconnected: boolean }>();
constructor() {
effect(() => {
const signedIn = this.auth.isAuthenticated();
untracked(() => (signedIn ? this.start() : void this.stop()));
});
}
/** Tells the chat's other members that the user is typing, at most once every 3 seconds. */
sendTyping(chatId: string): void {
const now = Date.now();
if (now - (this.lastTypingSent.get(chatId) ?? 0) < TYPING_THROTTLE_MS || !this.isConnected()) {
return;
}
this.lastTypingSent.set(chatId, now);
this.connection!.invoke('Typing', chatId).catch(() => undefined);
}
/** Which of these users are online right now (empty while disconnected). */
async getOnlineUsers(userIds: string[]): Promise<string[]> {
if (!userIds.length || !this.isConnected()) {
return [];
}
try {
return await this.connection!.invoke<string[]>('GetOnlineUsers', userIds);
} catch {
return [];
}
}
private isConnected(): boolean {
return this.connection?.state === HubConnectionState.Connected;
}
private start(): void {
if (this.connection) {
return;
}
const connection = new HubConnectionBuilder()
.withUrl('/hubs/chat', {
accessTokenFactory: async () => (await this.auth.getValidToken()) ?? '',
})
.withAutomaticReconnect([0, 2_000, 5_000, 10_000, 20_000, 30_000])
.configureLogging(LogLevel.Warning)
.build();
const emit = (event: HubEvent) => this.events.next(event);
connection.on('MessageCreated', (message: MessageDto) =>
emit({ type: 'messageCreated', message }),
);
connection.on('MessageUpdated', (message: MessageDto) =>
emit({ type: 'messageUpdated', message }),
);
connection.on('MessageDeleted', (chatId: string, messageId: string) =>
emit({ type: 'messageDeleted', chatId, messageId }),
);
connection.on('MessagesRead', (chatId: string, userId: string, lastReadMessageId: string) =>
emit({ type: 'messagesRead', chatId, userId, lastReadMessageId }),
);
connection.on('MembersAdded', (chatId: string, userIds: string[]) =>
emit({ type: 'membersAdded', chatId, userIds }),
);
connection.on('MemberRemoved', (chatId: string, userId: string) =>
emit({ type: 'memberRemoved', chatId, userId }),
);
connection.on('ChatUpdated', (chatId: string) => emit({ type: 'chatUpdated', chatId }));
connection.on('ChatDeleted', (chatId: string) => emit({ type: 'chatDeleted', chatId }));
connection.on('Typing', (chatId: string, userId: string) =>
emit({ type: 'typing', chatId, userId }),
);
connection.on('UserOnline', (userId: string) => emit({ type: 'userOnline', userId }));
connection.on('UserOffline', (userId: string, lastSeenAt: string) =>
emit({ type: 'userOffline', userId, lastSeenAt }),
);
connection.onreconnecting(() => this.state.set('reconnecting'));
connection.onreconnected(() => {
this.state.set('connected');
this.connected.next({ reconnected: true });
});
connection.onclose(() => {
// Automatic reconnect gave up (or the server is down): keep trying while signed in.
if (this.connection === connection) {
this.state.set('disconnected');
this.scheduleRetry(connection);
}
});
this.connection = connection;
this.attempt = 0;
void this.connect(connection);
}
private async connect(connection: HubConnection): Promise<void> {
if (this.connection !== connection) {
return;
}
this.state.set(this.everConnected ? 'reconnecting' : 'connecting');
try {
await connection.start();
if (this.connection !== connection) {
return;
}
const reconnected = this.everConnected;
this.everConnected = true;
this.attempt = 0;
this.state.set('connected');
this.connected.next({ reconnected });
} catch {
if (this.connection === connection) {
this.state.set('disconnected');
this.scheduleRetry(connection);
}
}
}
private scheduleRetry(connection: HubConnection): void {
clearTimeout(this.retryTimer);
const delay = RETRY_DELAYS_MS[Math.min(++this.attempt, RETRY_DELAYS_MS.length - 1)];
this.retryTimer = setTimeout(() => void this.connect(connection), delay);
}
private async stop(): Promise<void> {
clearTimeout(this.retryTimer);
const connection = this.connection;
this.connection = null;
this.everConnected = false;
this.lastTypingSent.clear();
this.state.set('disconnected');
await connection?.stop().catch(() => undefined);
}
}З’єднання:
effectнаisAuthenticatedзапускає з’єднання після входу й зупиняє після виходу.untrackedтримаєstartіstop– які задають сигналstate– поза залежностями ефекту.accessTokenFactoryвикликає SignalR під кожне (пере)підключення; вона повертаєgetValidToken()з теми 16, що оновлює токен, який ось-ось спливе. Браузери не можуть надсилати заголовки із запитами WebSocket, тож SignalR кладе токен у параметр запитуaccess_token, який API приймає лише на шляхах/hubs(тема 14).withAutomaticReconnect([0, 2_000, 5_000, 10_000, 20_000, 30_000])повторює спробу після втрати з’єднання із цими затримками. Поки це триває,onreconnectingзадає стан'reconnecting';onreconnectedзадає'connected'і випускаєconnectedзreconnected: true.oncloseспрацьовує, коли автоматичні спроби вичерпано (або перше з’єднання так і не встановилося). Тоді сервіс продовжує пробувати за власним розкладомRETRY_DELAYS_MS, доки користувач увійшов. Перевіркаthis.connection === connectionігнорує виклики зі з’єднання, яке вже замінено або зупинено.connectвипускаєconnectedзreconnected: true, якщо сервіс уже колись підключався в цьому сеансі. Перше з’єднання не є прогалиною; кожне наступне – є.configureLogging(LogLevel.Warning)тримає консоль браузера тихою, поки щось не піде не так.
Події:
HubEvent– це розрізнене об’єднання (discriminated union): один тип об’єкта на кожен метод хаба, кожен з літеральнимtypeі власними полями – відображенняIChatClient(тема 14) у TypeScript. Сервіс реєструє обробник для кожного імені методу й перетворює його аргументи на однуHubEvent, що публікується в Subjectevents. Споживачі підписуються один раз і роблятьswitchзаevent.type; у кожномуcaseTypeScript точно знає, які поля існують, а помилка в назві поля – це помилка компіляції.connected– другий Subject для сигналу «(пере)підключено», аstate– сигнал для екрана: оболонка показує банер, поки стан неconnected(розділ 3).
Методи клієнта:
sendTyping(chatId)викликаєTypingхаба щонайбільше раз на три секунди для кожного чату – обмеження частоти, якого вимагаєDocs/Realtime.md, – і лише коли з’єднання є. Помилки (наприклад, після виходу з чату) ігноруються.getOnlineUsers(userIds)викликаєGetOnlineUsersі повертає ідентифікатори тих, хто в мережі, або порожній список, поки з’єднання немає.
Чому Subject, а не сигнал для подій
Сигнал зберігає поточне значення; якщо дві події надходять в одному такті, читач бачить лише останню. Події хаба – це те, що відбувається, і кожну з них треба застосувати. Subject з RxJS доставляє кожне значення кожному підписнику, синхронно й по порядку. Сигнали тоді стають результатом: сховища застосовують події до своїх сигналів стану, а екран слідує за ними.
Рукостискання перед групами
Сервер додає з’єднання до груп чатів в OnConnectedAsync, що виконується після рукостискання (тема 14). Події, надіслані в цьому короткому проміжку, і все, що надсилали, поки клієнт був поза мережею, до цього з’єднання не доходять. Тому клієнт не повинен покладатися лише на події: після кожного перепідключення він через HTTP отримує те, що пропустив (наступний розділ).
Крок 2. Підробка для тестів
Навіщо. Тести сховищ мусять подавати події без сервера. Підробка з тією самою публічною формою – сигнал state, Subject events і connected, імітаційні функції для двох методів – дає змогу тесту викликати realtime.events.next({ type: 'messageCreated', … }) і дивитися, як реагує сховище.
Що зробити. Доповніть спільні підробки (нові рядки зеленим). Файл тепер остаточний:
ts
import { signal } from '@angular/core';
import { Subject } from 'rxjs';
import { MessageDto, MyProfileDto, UserSummaryDto } from '../app/core/api/models';
import { ConnectionState, HubEvent } from '../app/core/realtime/realtime.service';
export const ME: MyProfileDto = {
id: '00000000-0000-7000-8000-00000000000a',
userName: 'alice',
email: '[email protected]',
displayName: 'Alice',
bio: null,
hasAvatar: false,
createdAt: '2026-11-01T10:00:00Z',
};
export const BOB: UserSummaryDto = {
id: '00000000-0000-7000-8000-00000000000b',
userName: 'bob',
displayName: 'Bob',
hasAvatar: false,
};
/** A stand-in for RealtimeService: tests push hub events through `events`. */
export function fakeRealtime() {
return {
state: signal<ConnectionState>('connected'),
events: new Subject<HubEvent>(),
connected: new Subject<{ reconnected: boolean }>(),
sendTyping: vi.fn(),
getOnlineUsers: vi.fn(async () => [] as string[]),
};
}
export function fakeAuth(user: MyProfileDto | null = ME) {
return {
user: signal(user),
sessionEpoch: signal(0),
isAuthenticated: signal(!!user),
};
}
/** Message ids sort like the server's UUIDv7 ids: by the number given. */
export function messageId(n: number): string {
return `00000000-0000-7000-8000-${n.toString().padStart(12, '0')}`;
}
export function message(n: number, overrides: Partial<MessageDto> = {}): MessageDto {
return {
id: messageId(n),
chatId: 'chat-1',
sender: BOB,
body: `message ${n}`,
replyToMessageId: null,
createdAt: new Date(Date.UTC(2026, 10, 10, 12, 0, n)).toISOString(),
editedAt: null,
isDeleted: false,
attachments: [],
...overrides,
};
}
/** Lets pending promise callbacks (firstValueFrom, async/await) run. */
export function settle(): Promise<void> {
return new Promise((resolve) => setTimeout(resolve, 0));
}vi.fn(async () => [] as string[]) – це імітація, виклики якої повертають проміс порожнього списку; приведення типу повідомляє TypeScript тип елемента порожнього масиву.
Перевірка
npm run build і npm test -- --watch=false завершуються успішно з 38 тестами. Поки що ніщо не впроваджує RealtimeService, тож жодне з’єднання не відкривається; наступний розділ це змінить.