JavaScript SDK: 실시간 참조
실시간 서비스 및 채널의 모든 방법에 고유한 서명이 포함됩니다.
6분 읽기·레벨 참조·2026. 10. 12.에 개정됨
이 영어 텍스트는 프랑스어 원본에서 자동으로 생성되었으며 아직 검토되지 않았습니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
#
수업
실시간서비스
| 재산 | 설명 |
|---|---|
get connectionState(): ConnectionState | 현재 연결 상태. |
get isConnected(): boolean | WebSocket이 현재 연결되어 있는지 여부입니다. |
| 방법 | 설명 |
|---|---|
onStateChange(callback: (state: ConnectionState) => void): () => void | 연결 상태 변경을 수신합니다. |
onError(callback: (err: RealtimeConnectionError) => void): () => void | 실시간 연결 전송 오류를 수신합니다. |
connect(): void | WebSocket 연결이 열려 있는지 확인하세요. |
refreshToken(token: string): void | 기존 연결에서 JWT 토큰을 새로 고칩니다(연결 끊김 없음). |
setAuth(token?: string): void | 개인 및 브로드캐스트 채널 인증에 사용되는 토큰을 명시적으로 정의/새로 고칩니다(패리티 @supabase/realtime-js setAuth). |
httpBroadcast(channel: string, event: string, payload?: Record<string, unknown>, options?: HttpBroadcastOptions): Promise<AuraResponse<null>> | 열린 WebSocket 연결(패리티 @supabase/realtime-js) 없이 HTTP(REST)를 통해 브로드캐스트를 보냅니다. |
setAutoReconnect(enabled: boolean, maxAttempts?: number): void | 자동 재연결을 활성화/비활성화합니다(기본적으로 활성화되어 있음). |
disconnect(): void | WebSocket의 연결을 끊고 모든 채널을 정리합니다. |
channel(name: string, options?: ChannelConfig): AuraChannel | 이름으로 채널을 생성하거나 검색합니다. |
removeChannel(channel: string | AuraChannel): void | 이름 또는 AuraChannel 인스턴스별로 채널을 제거합니다. |
getChannels(): AuraChannel[] | 활성 채널을 나열합니다. |
removeAllChannels(): void | 모든 채널과 구독을 삭제하세요. |
#
수업
아우라채널
Supabase호환 가능한 체인 가능 API를 갖춘 실시간 채널입니다.
| 재산 | 설명 |
|---|---|
readonly name: string | realtime.channel(name)에 전달된 채널 이름입니다. |
get fullName(): string | 프로젝트 접두사가 포함된 전체 채널 이름(서버 프로토콜용) |
get isSubscribed(): boolean | 이 채널의 구독 여부입니다. |
| 방법 | 설명 |
|---|---|
on<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & { event: 'INSERT'; }, callback: (payload: RealtimePostgresInsertPayload<TRow>) => void): AuraChannelSubscriptionon<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & { event: 'UPDATE'; }, callback: (payload: RealtimePostgresUpdatePayload<TRow>) => void): AuraChannelSubscriptionon<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter & { event: 'DELETE'; }, callback: (payload: RealtimePostgresDeletePayload<TRow>) => void): AuraChannelSubscriptionon<TRow = Record<string, unknown>>(type: 'postgres_changes', filter: PostgresChangesFilter, callback: (payload: RealtimePostgresChangesPayload<TRow>) => void): AuraChannelSubscriptionon<TPayload = Record<string, unknown>>(type: 'broadcast', filter: BroadcastFilter, callback: (payload: RealtimeBroadcastEvent<TPayload>) => void): AuraChannelSubscriptionon(type: 'presence', filter: PresenceFilter, callback: (payload: PresenceState | RealtimeEvent | Record<string, unknown>) => void): AuraChannelSubscription | INSERT 필터링을 사용하여 PostgreSQL(CDC) 이벤트에 대한 리스너를 등록합니다. |
off(type?: RealtimeListenType, filter?: PostgresChangesFilter | BroadcastFilter | PresenceFilter, callback?: (payload: unknown) => void): this | 채널을 닫거나 WebSocket을 자르지 않고 채널에서 하나 이상의 수신기를 제거합니다. |
subscribe(callback?: SubscribeCallback, timeoutMs?: number): this | 채널을 구독하세요. |
unsubscribe(): void | 채널 구독을 취소하세요. |
send(message: BroadcastPayload): Promise<BroadcastSendStatus> | 채널에 브로드캐스트 메시지를 보냅니다. |
track(state: Record<string, unknown>): Promise<'ok' | 'error'> | 이 클라이언트의 현재 상태를 추적합니다. |
untrack(): Promise<'ok' | 'error'> | 현재 상태 추적을 중지합니다. |
presenceState(): PresenceState | 이 채널의 현재 상태를 가져옵니다. |
생성된 페이지
이 페이지는 SDK의 유형 선언 및 주석에서 생성되므로 게시된 코드에서 표류할 수 없습니다. 실제 사례를 보려면 가이드를 읽어보세요.
마지막 업데이트 · 2026. 10. 12.