Real-Time Streaming Systems (WebRTC + Live Data) · Lesson

Real-time Chat over Data Channels

Implement a real-time chat feature leveraging WebRTC Data Channels for direct, low-latency text communication between peers.

Real-time Chat over Data Channels is a free Real-Time Streaming Systems (WebRTC + Live Data) lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Real-Time Streaming Systems (WebRTC + Live Data) learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Real-time Chat with WebRTC

Imagine adding instant messaging directly into your video calls or collaborative apps! WebRTC Data Channels make this possible, offering a powerful way to send text and other data directly between peers.

In this lesson, you'll learn how to implement a real-time chat feature using these low-latency, secure channels.

Data Channels' Chat Advantage

Why use WebRTC Data Channels for chat instead of a traditional server-based approach?

Low Latency: Messages travel directly between users, minimizing delays.
Enhanced Privacy: Your chat content doesn't pass through an intermediary server.
Flexible Data: Beyond text, you can send binary data, game states, or any custom information.

It creates a true peer-to-peer chat experience.

Creating Your Chat Channel

To start a chat, you first create an RTCDataChannel from an established RTCPeerConnection. You give it a label (like "chat") and can specify options for how it behaves.

For text chat, ordered: true is often desired to ensure messages arrive in the correct sequence.

const peerConnection = new RTCPeerConnection();

const chatChannel = peerConnection.createDataChannel("chat", {
  ordered: true, // Guarantees message order
  maxRetransmits: 0 // Optional: For faster, less reliable delivery
});

// The channel is now 'connecting'

When Is The Channel Ready?

A data channel isn't immediately ready to send messages. It goes through different readyState values: connecting, open, closing, and closed.

You must wait for the open state before you can reliably send chat messages. The onopen event is perfect for this.

chatChannel.onopen = (event) => {
  console.log("Chat channel is OPEN!");
  // Now you can start sending messages
  document.getElementById("chat-input").disabled = false;
};

chatChannel.onclose = (event) => {
  console.log("Chat channel is CLOSED.");
  // Handle channel closure, e.g., disable chat input
  document.getElementById("chat-input").disabled = true;
};

Sending a Text Message

Once your chatChannel is open, sending a message is straightforward using the send() method. For text chat, you'll typically send a JavaScript string.

Always check the readyState before attempting to send!

// Assuming 'chatChannel' is your open data channel
const message = "Hello from CoddyKit!";

if (chatChannel && chatChannel.readyState === "open") {
  chatChannel.send(message);
  console.log("Message sent:", message);
} else {
  console.warn("Chat channel not open yet. Cannot send message.");
}

Handling Incoming Chat

To receive messages from the other peer, you'll attach an onmessage event listener to your chatChannel. When a message arrives, this function is called.

The message content is available in event.data.

chatChannel.onmessage = (event) => {
  const receivedMessage = event.data;
  console.log("Received message:", receivedMessage);
  // Here, you would update your chat display area
  // E.g., add a new <li> element to a <ul>
  // document.getElementById("chat-history").innerHTML += `<p>${receivedMessage}</p>`;
};

Structuring Chat Data (JSON)

For a richer chat experience, you often need more than just raw text. You might want to include the sender's name, a timestamp, or other metadata.

Sending a JSON string allows you to encapsulate structured data. You stringify it before sending and parse it upon receiving.

const messageObject = {
  sender: "Alice",
  text: "Hey, how are you?",
  timestamp: Date.now()
};

const jsonMessage = JSON.stringify(messageObject);

// To send:
// chatChannel.send(jsonMessage);

// To receive and process:
// const parsedMessage = JSON.parse(event.data);
// console.log(`${parsedMessage.sender} said: ${parsedMessage.text}`);

Integrating with Your Chat UI

Once you receive a message (especially a structured JSON message), you'll want to display it neatly in your application's user interface.

Typically, your onmessage handler will take the received data, format it (e.g., "Alice: Hello!"), and append it to a designated chat history element (like a div or ul).

What Happens When Chat Ends?

Data channels can close for various reasons: a peer disconnects, the connection fails, or one side explicitly closes it. The onclose event will fire, and the channel's readyState will become closed.

It's good practice to update your UI (e.g., disable the chat input, show a "disconnected" message) when this happens.

chatChannel.onclose = (event) => {
  console.log("Chat channel closed unexpectedly!");
  // Update UI to reflect disconnected state
  document.getElementById("chat-input").disabled = true;
  document.getElementById("status-message").textContent = "Chat disconnected.";
};

Chat Channel Quick Check

You're building a WebRTC chat application and want to ensure that messages arrive at the recipient in the exact order they were sent. Which RTCDataChannel option should you use?

Chat Over Data Channels - Recap

Congratulations! You've learned how to implement a real-time chat feature using WebRTC Data Channels.

P2P Communication: Data Channels enable direct, low-latency, and private chat.
Channel Lifecycle: Create with createDataChannel(), wait for onopen, then use send() and listen with onmessage.
Structured Data: Use JSON to send richer chat messages with metadata.
Robustness: Handle channel states and closures for a better user experience.

You can now integrate powerful real-time chat into your WebRTC applications!

Frequently asked questions

Is the “Real-time Chat over Data Channels” lesson free?

Yes — the full text of “Real-time Chat over Data Channels” is free to read here on the web, and the Real-Time Streaming Systems (WebRTC + Live Data) course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Real-Time Streaming Systems (WebRTC + Live Data) course, upgrade to CoddyKit PRO.

What will I learn in “Real-time Chat over Data Channels”?

Implement a real-time chat feature leveraging WebRTC Data Channels for direct, low-latency text communication between peers. You practise Real-Time Streaming Systems (WebRTC + Live Data) with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Real-Time Streaming Systems (WebRTC + Live Data)?

No prior experience is required. Real-Time Streaming Systems (WebRTC + Live Data) on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Real-time Chat over Data Channels” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Real-Time Streaming Systems (WebRTC + Live Data) lesson?

Yes. Every Real-Time Streaming Systems (WebRTC + Live Data) lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to Real-Time Streaming Systems (WebRTC + Live Data)