Long polling as fallback in Node.js

Introduction

Long polling helps keep a connection open to get updates when real-time methods like WebSockets are not available.

When you want to update a web page with new data but the browser or network does not support WebSockets.

When you need a simple way to get server updates without constantly asking the server again and again.

When building chat apps or notifications but want a fallback for older browsers.

When you want to reduce server load by waiting for new data before responding.

When you want to keep users informed in near real-time without complex setups.

Syntax

Node.js

app.get('/updates', (req, res) => {
  if (newDataAvailable) {
    res.json(newData);
  } else {
    // wait and respond later
  }
});

The server holds the request open until new data is ready or a timeout happens.

The client sends a new request after each response to keep listening.

Examples

This example waits 10 seconds before responding if no data is ready.

Node.js

app.get('/poll', (req, res) => {
  if (dataReady) {
    res.send('Here is your data');
  } else {
    setTimeout(() => res.send('No new data'), 10000);
  }
});

This example checks every second for new data and responds immediately when available.

Node.js

app.get('/poll', (req, res) => {
  const checkData = () => {
    if (dataReady) {
      res.json({ data: 'new data' });
    } else {
      setTimeout(checkData, 1000);
    }
  };
  checkData();
});

Sample Program

This Node.js Express server uses long polling to send data when ready or after 15 seconds if no data arrives. It simulates new data arriving after 5 seconds.

Node.js

import express from 'express';
const app = express();
let dataReady = false;
let newData = { message: 'Hello from server!' };

app.get('/long-poll', (req, res) => {
  if (dataReady) {
    res.json(newData);
    dataReady = false; // reset
  } else {
    const timer = setTimeout(() => {
      if (!res.writableEnded) {
        res.json({ message: 'No new data' });
      }
    }, 15000); // 15 seconds timeout

    // Simulate data arrival after 5 seconds
    setTimeout(() => {
      if (!res.writableEnded) {
        clearTimeout(timer);
        dataReady = true;
        res.json(newData);
        dataReady = false;
      }
    }, 5000);
  }
});

app.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

Important Notes

Long polling keeps the connection open but can use more server resources than WebSockets.

Always set a timeout to avoid hanging requests forever.

The client must send a new request after each response to continue receiving updates.

Summary

Long polling is a way to get updates by holding a request open until data is ready.

It works well as a fallback when real-time connections are not possible.

Remember to handle timeouts and client re-requests for smooth updates.

Practice

1. What is the main purpose of using long polling in Node.js applications?

easy

A. To keep a client request open until new data is available

B. To immediately close the connection after sending data

C. To send multiple responses to a single request

D. To replace WebSocket connections entirely

Solution

1. Step 1: Understand long polling behavior

   Long polling keeps the client request open until the server has new data to send.

2. Step 2: Compare options to this behavior

   Only To keep a client request open until new data is available describes this behavior correctly; others describe different or incorrect behaviors.

3. Final Answer:

   To keep a client request open until new data is available -> Option A

4. Quick Check:

   Long polling = open request until data ready [OK]

Hint: Long polling holds request open until data arrives [OK]

Common Mistakes:

• Thinking long polling sends multiple responses per request
• Confusing long polling with WebSocket persistent connection
• Assuming long polling closes connection immediately

2. Which of the following is the correct way to implement a long polling endpoint in Node.js using Express?

easy

A. res.write('data'); // keep connection open without res.end()

B. res.send('data'); res.end();

C. res.json('data'); res.end();

D. res.send('data'); // then wait before closing connection

Solution

1. Step 1: Identify how to keep connection open

   In long polling, the server holds the connection open, so it should not call res.end() immediately.

2. Step 2: Check which option keeps connection open

   res.write('data'); // keep connection open without res.end() uses res.write() without res.end(), which keeps the connection open for long polling.

3. Final Answer:

   res.write('data'); // keep connection open without res.end() -> Option A

4. Quick Check:

   Keep connection open = no res.end() [OK]

Hint: Use res.write() without res.end() to keep connection open [OK]

Common Mistakes:

• Calling res.end() immediately closes connection
• Using res.send() closes connection right away
• Not sending any response causes timeout

3. Consider this Node.js long polling code snippet:

app.get('/poll', (req, res) => {
  setTimeout(() => {
    res.json({ message: 'Update available' });
  }, 5000);
});

What will the client experience when calling this endpoint?

medium

A. The client never receives a response

B. The client receives the update immediately

C. The client waits 5 seconds, then receives the update

D. The client receives multiple updates every 5 seconds

Solution

1. Step 1: Analyze the setTimeout delay

   The server waits 5 seconds before sending the JSON response.

2. Step 2: Understand client wait behavior

   The client request stays open during the 5 seconds, then receives the update once sent.

3. Final Answer:

   The client waits 5 seconds, then receives the update -> Option C

4. Quick Check:

   setTimeout delay = delayed response [OK]

Hint: setTimeout delays response, client waits that time [OK]

Common Mistakes:

• Assuming immediate response despite delay
• Expecting multiple responses from one request
• Thinking client never gets response

4. Given this long polling code snippet, what is the main issue?

app.get('/poll', (req, res) => {
  res.json({ message: 'Update' });
  setTimeout(() => {
    res.json({ message: 'Another update' });
  }, 3000);
});

medium

A. The first res.json() never sends data

B. Calling res.json() twice causes an error

C. setTimeout is not asynchronous

D. The server never responds to the client

Solution

1. Step 1: Understand res.json() behavior

   res.json() sends a response and closes the connection immediately.

2. Step 2: Analyze calling res.json() twice

   Calling res.json() a second time after the connection is closed causes an error.

3. Final Answer:

   Calling res.json() twice causes an error -> Option B

4. Quick Check:

   Multiple res.json() calls = error [OK]

Hint: Only one res.json() per request allowed [OK]

Common Mistakes:

• Thinking setTimeout blocks code
• Assuming multiple res.json() calls send multiple responses
• Ignoring connection close after first response

5. You want to implement long polling as a fallback in a Node.js app that first tries WebSocket. Which approach correctly handles fallback and client reconnection?

hard

A. Use WebSocket and long polling simultaneously, sending duplicate data to client

B. Use WebSocket only; if unavailable, do nothing and drop updates

C. Use long polling only; never try WebSocket to simplify code

D. Use WebSocket; if unavailable, client repeatedly sends GET requests that wait on server until data or timeout, then reconnect

Solution

1. Step 1: Understand fallback strategy

   WebSocket is preferred for real-time, but fallback uses long polling with repeated client requests.

2. Step 2: Identify correct client reconnection method

   The client must send repeated GET requests that wait on server until data or timeout, then reconnect to keep updates flowing.

3. Final Answer:

   Use WebSocket; if unavailable, client repeatedly sends GET requests that wait on server until data or timeout, then reconnect -> Option D

4. Quick Check:

   Fallback = repeated long polling requests [OK]

Hint: Fallback means repeated long polling requests after WebSocket fails [OK]

Common Mistakes:

• Ignoring fallback and dropping updates
• Sending duplicate data by using both methods simultaneously
• Not reconnecting client after long polling timeout