aplicación de una sola página

Qué es

Una aplicación de una sola página, también llamada app de una sola
página y normalmente abreviada como SPA, es una aplicación web que
carga un documento HTML y después lo modifica con JavaScript en
lugar de pedir una página nueva al servidor. Al pulsar un enlace
interno, no se descarta el documento abierto. Un script intercepta
el clic, obtiene los datos que necesita la siguiente vista,
reescribe parte del DOM y actualiza la barra de direcciones, de modo
que la URL sigue indicando dónde se encuentra quien la consulta.

Ninguna norma define el término, y quienes crean las herramientas lo
reconocen. Next.js empieza su guía sobre el tema con «La definición
de una SPA varía» y establece una para su propio uso, que denomina
SPA estricta. Tiene dos rasgos. Un solo archivo HTML sirve a toda la
aplicación, y JavaScript en el navegador se encarga de cada ruta,
cada transición entre páginas y cada solicitud de datos. Además, la
página nunca se recarga por completo: cuando cambia la ruta, los
scripts del cliente reescriben el DOM de la página que ya está
abierta y cargan los datos cuando hacen falta, en lugar de pedir un
documento nuevo al servidor. Este artículo utiliza esa definición
porque es la más directa disponible e identifica la propiedad de la
que depende todo lo demás: un documento que nunca se sustituye.

Los componentes del navegador sí están normalizados. La interfaz
History del estándar HTML proporciona a una página
`history.pushState()`, que añade una entrada al historial de la
sesión y establece la URL sin cargar nada, y
`history.replaceState()`, que reescribe la entrada actual. Cuando se
retrocede o avanza entre esas entradas, el navegador envía un evento
`popstate` a la ventana y deja que la página se encargue de
redibujarse. La API Navigation, más reciente y presentada por el
estándar como sucesora de las API clásicas de ubicación e historial,
actúa desde el otro extremo: se emite un evento `navigate` cuando
empieza una navegación, y su método `intercept()` la convierte en
una navegación dentro del mismo documento que la propia página
gestiona.

Lo opuesto es el sitio web convencional de varias páginas, donde
cada enlace pide un documento nuevo al servidor y el navegador
descarta el anterior. Que el HTML de una página se genere una vez
mediante un generador de sitios estáticos o en cada solicitud
mediante renderizado en el servidor es una cuestión distinta: trata
de cómo se produce el HTML, no de lo que sucede después de
recibirlo. Next.js difumina esa frontera deliberadamente: su
exportación estática escribe un archivo HTML para cada ruta, pero la
navegación entre ellas sigue ocurriendo en el cliente.

Por qué importa

Como el documento nunca se sustituye, todo lo que contiene sobrevive
a un clic: un formulario a medio rellenar, un vídeo en reproducción,
la posición de desplazamiento de un panel lateral o datos ya
obtenidos. Solo tienen que cruzar la red los datos que necesita la
siguiente vista, no una página completamente nueva con su cabecera,
estilos y scripts. Un cambio de vista puede consistir únicamente en
reescribir una región de la página.

Next.js expone los costes junto con la definición. Una SPA estricta
a menudo tiene que cargar una gran cantidad de JavaScript antes de
que la página sea interactiva, y las cascadas de solicitudes de
datos en el cliente, donde una solicitud solo puede empezar cuando
otra ha terminado, son difíciles de gestionar. También hay un coste
para cualquier sistema que lea la página sin ejecutar scripts. Si
todas las rutas utilizan un solo archivo HTML, un rastreador que no
ejecute JavaScript recibe el mismo documento casi vacío sea cual sea
la URL que solicite. Next.js señala lo mismo sobre sus componentes
que solo se ejecutan en el navegador: cualquier sistema que indexe
la página sin ejecutar scripts recibe el contenido alternativo, no
el componente.

Su respuesta consiste en mantener la navegación en el cliente y
trasladar el resto. Next.js divide automáticamente los paquetes de
JavaScript y genera múltiples puntos de entrada HTML a distintas
rutas, para que quien visite el sitio no cargue código que una ruta
no necesita. Su componente `next/link` precarga rutas, lo que hace
que los cambios de ruta parezcan tan inmediatos como en una SPA
renderizada por completo en el cliente, mientras mantiene el estado
del enrutamiento de la aplicación en la URL, que se puede enlazar y
compartir. Una exportación estática va más allá y escribe una página
completamente renderizada para cada ruta, de modo que las visitas
reciben contenido sin esperar al paquete del cliente, mientras que
las transiciones entre páginas en el cliente siguen siendo tan
rápidas como en una SPA estricta.

Tampoco es una decisión definitiva. Next.js describe un proyecto que
empieza como sitio estático, o incluso como SPA estricta renderizada
íntegramente en el cliente, y añade funciones de servidor a medida
que crece. También indica que una SPA existente puede migrar sin
reescribirse desde cero.

Cómo se aplica en la práctica

El enrutador siguiente, escrito para este artículo, es la versión
funcional más pequeña de la idea. Supone que la página tiene un
elemento `<main>` y que el servidor responde a todas las rutas de la
aplicación con el mismo documento HTML. Las dos vistas representan
lo que la aplicación muestre en realidad.

```js
// router.js
const views = {
  "/": { title: "Orders", text: "Your recent orders." },
  "/settings": { title: "Settings", text: "Delivery preferences." },
};
const main = document.querySelector("main");

function show(path, moveFocus) {
  const view = views[path] ?? views["/"];
  const heading = document.createElement("h1");
  const body = document.createElement("p");
  heading.textContent = view.title;
  heading.tabIndex = -1;
  body.textContent = view.text;
  main.replaceChildren(heading, body);
  document.title = view.title;
  if (moveFocus) heading.focus();
}

document.addEventListener("click", (event) => {
  const link = event.target.closest("a[href]");
  const modified = event.metaKey || event.ctrlKey || event.shiftKey;
  if (!link || link.origin !== location.origin) return;
  if (modified || event.button !== 0) return;
  event.preventDefault();
  history.pushState(null, "", link.href);
  show(location.pathname, true);
});

window.addEventListener("popstate", () => show(location.pathname, true));
show(location.pathname, false);
```

El manejador de clics toma el control de los clics normales con el
botón izquierdo sobre enlaces al mismo origen y deja pasar los clics
modificados, por lo que sigue siendo posible abrir un enlace en otra
pestaña. `preventDefault()` detiene la navegación propia del
navegador, y `pushState()` registra una nueva entrada en el
historial de la sesión con la URL del enlace; su argumento central
solo existe por razones históricas, de ahí que sea una cadena vacía.
`show()` sustituye la vista, establece el título del documento y
mueve el foco al nuevo encabezado, al que un `tabIndex` de `-1`
permite recibir el foco desde un script sin incluirlo en el orden de
tabulación. El escuchador de `popstate` redibuja la vista
correspondiente al retroceder o avanzar, y la última línea dibuja la
vista de la URL con la que se abrió la página. Esto solo funciona si
el servidor envía el mismo documento para `/settings` que para `/`.
Una aplicación real también mostraría su propia vista de página no
encontrada en lugar de volver en silencio a la página inicial, y
dejaría intactos los enlaces a archivos y a otras partes del sitio.

En el trabajo actual de la fundadora en NextMariner, el frontend de
Next.js 16 muestra estos costes en un producto real. Su ficha en el
portafolio describe un panel con autenticación que debía resultar
rápido y mantener una interactividad real, y señala qué ocurre
cuando todos los datos se obtienen en el cliente: la primera carga
se vuelve lenta y aparece el patrón N+1, en el que cada componente
se activa y envía su propia solicitud hasta que una sola página se
convierte en una cascada de intercambios de ida y vuelta. Es un caso
práctico de la cascada de solicitudes de datos en el cliente de la
que advierte la guía de Next.js. La solución mantuvo la
interactividad en el cliente donde importaba y trasladó la primera
obtención de datos al servidor. En el panel y en los grandes
listados del directorio, una factoría llamada
`createPrefetchedServerPage` entrega cada página al cliente con los
datos ya preparados. La ficha es clara sobre lo que queda: las demás
páginas con autenticación aún se renderizan en el cliente y esperan
su turno. Describe, pues, una migración que funciona y cuya
siguiente página por migrar está clara, pero que todavía no ha
terminado.

Dónde surgen los problemas

El botón Atrás sale de la aplicación. Si un script cambia las vistas
sin llamar a `pushState()`, el historial de la sesión no tiene
entradas para ellas. Atrás se salta todas las vistas que se han
mostrado y sale por completo de la aplicación, y una recarga vuelve
a la URL con la que se abrió inicialmente. Añada una entrada para
cada vista que se consideraría una página, utilice `replaceState()`
para los cambios que no deban convertirse en pasos propios, como un
filtro mientras se escribe, y gestione `popstate`. Next.js defiende
mantener el estado del enrutamiento en la URL por la misma razón:
permite compartir una vista y enlazarla.

Un enlace profundo encuentra un servidor que solo conoce un archivo.
En una SPA estricta, un archivo HTML sirve a todas las rutas, pero
la barra de direcciones muestra `/settings`, y eso es lo que pide el
navegador al recargar o al abrir un enlace compartido. Un servidor
que solo tiene `index.html` responde con un 404. Configure el
servidor para responder a cada ruta de la aplicación con ese
documento, o genere un archivo por ruta. La exportación estática de
Next.js hace lo segundo: su carpeta `out` contiene archivos como
`index.html`, `404.html` y `blog/post-1.html`, y su guía muestra una
regla de nginx, `try_files $uri $uri.html $uri/ =404;`, que asocia
una URL limpia con el archivo correspondiente.

El foco permanece donde estaba la vista anterior. `pushState()`
cambia el historial de la sesión y la URL, y nada más. Después de
que un script sustituya la vista, el foco del teclado permanece en
el enlace pulsado, o se pierde si se ha eliminado el elemento que lo
tenía, y nada avisa a la tecnología de apoyo de que ha llegado una
vista nueva si no lo hace la propia página. Establezca el título y
mueva el foco al encabezado de la nueva vista, como hace el ejemplo.
La API Navigation asume una parte mayor de esta tarea. Una
navegación gestionada con `intercept()` restablece el foco de forma
predeterminada en el primer elemento con `autofocus` o, si no lo
hay, en el cuerpo del documento. Una vez terminado el manejador, el
navegador comunica al usuario que ha finalizado, lo que, según el
estándar, incluye a la tecnología de apoyo. Una aplicación que sitúe
el foco por su cuenta desactiva ese comportamiento mediante
`focusReset: "manual"`.

Todo se paga de antemano. Una SPA estricta a menudo tiene que cargar
una gran cantidad de JavaScript antes de que nada sea interactivo, y
sus primeras solicitudes de datos solo empiezan cuando se ejecuta
ese código. Divida el paquete por rutas, para que cada visita
descargue solo lo que necesita la vista actual, e inicie las
primeras solicitudes en el servidor. El patrón de Next.js para esto
inicia la obtención de datos en un Server Component sin esperar a
que termine y pasa la promesa a un Client Component, que extrae su
valor con `use()`. Como la solicitud empieza antes de renderizar el
resto de la aplicación, explica la guía, la respuesta puede empezar
a enviarse por partes de inmediato, y el cliente evita una cascada
de solicitudes en la que cada una espera a la anterior.

Lecturas adicionales

  * Cómo crear aplicaciones de una sola página con Next.js — la
definición de SPA estricta, sus costes y los patrones que utiliza
Next.js para mantener la navegación en el cliente y trasladar
trabajo al servidor.

  * Estándar HTML: la interfaz History — `pushState()`,
`replaceState()` y cómo se añaden y sustituyen las entradas del
historial de la sesión.

  * Estándar HTML: API Navigation — el evento `navigate`,
`intercept()` y la gestión del foco y el desplazamiento que los
acompaña.

  * Cómo crear una exportación estática de su aplicación Next.js —
un archivo HTML por ruta, lo que no puede hacer una exportación
estática y cómo servir URL limpias con nginx.

hEsta página en la web	URL:https://engineer.company/es/glossary/single-page-application/	engineer.company	70
