Skip to content
FrontDepth, Home

AJAX → Server components and islands

1999 – today · 2020 – today

Older era
Newer era
Compare

What changed

Where the state lives

AJAX

On the server: the list is server data; the page keeps the last copy it received, and the filter.

Server components and islands

In the island's useState, started from the props the server serialized next to it. The static parts have no state at all.

How the page is rendered

AJAX

The server sends data (JSON), not HTML; the page builds the list items with document.createElement.

Server components and islands

The server renders the whole page to HTML; only the island's element is hydrated with hydrateRoot(). React never touches the static HTML.

What happens on a change

AJAX

Each change is a background request; its callback replaces the page's copy of the list and redraws only the list, the counter and the filter buttons.

Server components and islands

Inside the island a setter re-renders TodoApp and React updates the DOM that differs; the rest of the page never changes.

How the code is organised

AJAX

A page script with a request helper and handlers attached in window.onload, talking to a server API that answers JSON.

Server components and islands

Server-only components that never reach the browser, around client islands that each have their own root, script and props.

Why it changed

What hurt in each era along the way, and the era that came next.

  1. AJAX→jQuery

    Every browser did it a little differently. Internet Explorer 5 and 6 created the object with new ActiveXObject("Microsoft.XMLHTTP"), Internet Explorer before version 9 attached events with attachEvent instead of addEventListener, and each browser had its own DOM quirks, so scripts grew long and full of browser checks. Libraries like jQuery wrapped XHR, events and the DOM in one short API that worked the same in every browser.

  2. jQuery→MVC in the browser (Backbone)

    When the data lives only in the DOM, every feature reads and writes the page directly: the counter counts <li> elements, the filter checks classes. As apps grew, handlers changing the page from many places became hard to follow ("jQuery spaghetti"), and there was no model of the data to test, save or reuse. Libraries like Backbone moved the data into models and kept the page in views.

  3. MVC in the browser (Backbone)→Two-way binding (AngularJS)

    Backbone left the wiring to you. Every view subscribed to its models by hand, chose what to redraw and read form fields back itself, so much of the code only connected data to the DOM. A view thrown away without remove() stayed subscribed and kept reacting as a "zombie view", and re-rendering a template replaced elements, losing focus and half-typed text. AngularJS answered with two-way data binding: the HTML declares what shows what, and the framework keeps the page and the data in sync.

  4. Two-way binding (AngularJS)→React and the virtual DOM

    Every binding added a watcher, and every digest checked all of them, at least twice whenever something had changed, so pages with many bindings slowed down on each click or keystroke (1.3 added one-time bindings, ::, to cut the count). Two-way bindings and watchers that change other values made it hard to see what changed what, and code outside AngularJS, like a setTimeout callback or a jQuery plugin, had to remember to call $scope.$apply().

    Angular 2 was a new framework rather than the next version: an app could not just upgrade, and the official path was to migrate it piece by piece, with both frameworks running side by side. React answered with one-way data flow: a component renders from its state, and a virtual DOM works out what to change on the page.

  5. React and the virtual DOM→Flux and Redux

    State that several components need has to live in their closest common parent and travel down as props through every component in between, even those that only pass it on, while callbacks travel down the same way to change it. In a large app, setState calls in many components, triggered by clicks, server responses and timers, all changed what the screen showed, so it was hard to follow why it looked the way it did. Flux and Redux moved the shared state out of the components into a store that changes only through actions.

  6. Flux and Redux→Component frameworks (Vue, Angular, Svelte)

    Every small feature needed the same pieces in several files: an action type constant, an action creator, a case in a reducer, and mapStateToProps / mapDispatchToProps to connect a component, plus objects copied by hand so that nothing was mutated. Setting up a store with middleware and the DevTools took more code still. Redux itself later answered with Redux Toolkit; component frameworks like Vue, Angular and Svelte offered reactive state you change directly and HTML templates that update themselves, with much less ceremony.

  7. Component frameworks (Vue, Angular, Svelte)→SSR, SSG and meta-frameworks

    These apps still rendered in the browser. The server sent an almost empty page, and nothing useful appeared until the framework and the app's JavaScript had downloaded and run; crawlers and link previews that do not run JavaScript saw nothing. Routing, server rendering, code splitting and data loading were left to each team to put together. Meta-frameworks such as Next.js and Nuxt bundled those pieces around the component framework and rendered pages on the server or at build time.

  8. SSR, SSG and meta-frameworks→Hooks

    Pages now arrived rendered, but the components were still classes: one feature's logic was spread over componentDidMount, componentDidUpdate and componentWillUnmount, sharing stateful logic needed higher-order components or render props, and every handler had to be bound to this (see the constructor). Hooks (React 16.8, 2019) gave function components state and effects that can be shared as custom hooks.

    Hydration had its own cost: the browser downloads and runs the code of the whole page, even of parts that never change, and the data travels twice, as HTML and as JSON. Islands and server components later went after that.

  9. Hooks→Server components and islands

    Everything still ran in the browser: the page arrived empty, every component's JavaScript had to download, run and render before anything useful appeared, and server rendering hydrated the whole page even where nothing was interactive. Effects with dependency arrays and stale closures became a common source of bugs. Islands and React Server Components moved the non-interactive parts back to the server.

The same app, side by side

The main file of each version. Both apps pass the same test: same markup, same behaviour, different ideas.

The apps run in sandboxes in your browser.

AJAX
Server components and islands

AJAX

plain browser APIs, no library

/src/main.js · 97 lines

JavaScript
// AJAX era: the page talks to the server in the background with XMLHttpRequest and
// redraws only the list. The page itself is never loaded again.

// The list belongs to the server; the page keeps the last copy it received.
var todos = [];
var filter = "all";

// Every request goes the same way: open, send, then wait until readyState is 4 (done).
function request(method, url, body, callback) {
  var xhr = new XMLHttpRequest();
  // true = asynchronous: the page stays usable while the request travels.
  xhr.open(method, url, true);
  if (body) xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
  xhr.onreadystatechange = function () {
    if (xhr.readyState === 4 && xhr.status === 200) {
      callback(JSON.parse(xhr.responseText));
    }
  };
  xhr.send(body);
}

// Every answer is the whole list as JSON: keep it and redraw.
function show(list) {
  todos = list;
  render();
}

// One call per todo gives each handler its own todo. A handler created inside render()'s
// for loop would close over the loop's single var and see its value from the end of the loop.
function makeItem(todo) {
  var li = document.createElement("li");
  var label = document.createElement("label");
  var box = document.createElement("input");
  var title = document.createElement("span");
  box.type = "checkbox";
  box.checked = todo.done;
  box.setAttribute("data-toggle", "");
  box.onclick = function () {
    request("POST", "/todos/" + todo.id + "/toggle", null, show);
  };
  // A text node: what the user typed never becomes HTML.
  title.className = "title";
  title.appendChild(document.createTextNode(todo.title));
  label.appendChild(box);
  label.appendChild(document.createTextNode(" "));
  label.appendChild(title);
  li.appendChild(label);
  if (todo.done) li.className = "done";
  return li;
}

// Only the list, the counter and the filter buttons change; the rest of the page stays.
function render() {
  var list = document.getElementById("todo-list");
  var buttons = document.getElementById("filters").getElementsByTagName("button");
  var left = 0;
  var i;
  list.innerHTML = "";
  for (i = 0; i < todos.length; i++) {
    if (!todos[i].done) left++;
    if (filter === "all" || (filter === "done") === todos[i].done) {
      list.appendChild(makeItem(todos[i]));
    }
  }
  document.getElementById("todo-count").innerHTML = left + " left";
  for (i = 0; i < buttons.length; i++) {
    buttons[i].className = buttons[i].getAttribute("data-filter") === filter ? "selected" : "";
  }
}

// Handlers are attached from the script when the page has loaded, not written into the HTML.
window.onload = function () {
  var field = document.getElementById("new-todo");
  var buttons = document.getElementById("filters").getElementsByTagName("button");
  var i;

  document.getElementById("todo-form").onsubmit = function () {
    var title = field.value.replace(/^\s+|\s+$/g, "");
    if (title !== "") {
      request("POST", "/todos", "title=" + encodeURIComponent(title), show);
      field.value = "";
    }
    // false cancels the normal submission: no new page, the request runs in the background.
    return false;
  };

  for (i = 0; i < buttons.length; i++) {
    // Inside the handler, this is the button that was clicked.
    buttons[i].onclick = function () {
      filter = this.getAttribute("data-filter");
      render();
    };
  }

  // The page arrives without the list; the first request fetches it.
  request("GET", "/todos", null, show);
};

Server components and islands

React 19.3.0, React DOM 19.3.0

/server.jsx · 48 lines

JSX
// Islands era: the server renders the whole page to HTML, and only the islands get JavaScript.
// An islands framework such as Astro does this for you: you only mark what is interactive.
import { renderToStaticMarkup, renderToString } from "react-dom/server";
import TodoApp from "./islands/TodoApp.jsx";

// The "database" lives on the server.
const todos = [
  { id: 1, title: "Read the docs", done: true },
  { id: 2, title: "Write the app", done: false },
];

// A server-only component: it runs here and leaves plain HTML behind. It ships NO JavaScript:
// this file is never sent to the browser, and nothing hydrates its HTML.
function Intro() {
  return (
    <>
      <h1>Todos</h1>
      <p>This heading and note are plain HTML with no JavaScript. Everything below them is an island.</p>
    </>
  );
}

// "<" is escaped so that a todo titled "</script>" cannot end the script element early.
function serialize(props) {
  return JSON.stringify(props).replace(/</g, "\\u003c");
}

export async function handle({ method, path }) {
  if (method !== "GET" || path !== "/") return { status: 404, body: "<h1>Not found</h1>" };
  const props = { initialTodos: todos };

  // Static part: HTML only, without the markers hydration needs. No JavaScript.
  const intro = renderToStaticMarkup(<Intro />);

  // The island: HTML that hydrateRoot can attach to, with its props as JSON right next to it.
  const island = renderToString(<TodoApp {...props} />);

  return {
    status: 200,
    body: `
    <main class="todo-app">
      ${intro}
      <div id="todo-island">${island}</div>
      <script id="todo-island-props" type="application/json">${serialize(props)}</script>
    </main>
    <script src="/client.jsx"></script>`,
  };
}