{"canonical_url":"https://engineer.company/es/glossary/single-page-application/","content_markdown":"# aplicación de una sola página\n\n## Qué es\n\nUna aplicación de una sola página, también llamada app de una sola página y\nnormalmente abreviada como SPA, es una aplicación web que carga un documento HTML\ny después lo modifica con JavaScript en lugar de pedir una página nueva al\nservidor. Al pulsar un enlace interno, no se descarta el documento abierto. Un script\nintercepta el clic, obtiene los datos que necesita la siguiente vista, reescribe\nparte del DOM y actualiza la barra de direcciones, de modo que la URL sigue\nindicando dónde se encuentra quien la consulta.\n\nNinguna norma define el término, y quienes crean las herramientas lo reconocen.\nNext.js empieza su guía sobre el tema con «La definición de una SPA varía» y\nestablece una para su propio uso, que denomina SPA estricta. Tiene dos rasgos. Un\nsolo archivo HTML sirve a toda la aplicación, y JavaScript en el navegador se\nencarga de cada ruta, cada transición entre páginas y cada solicitud de datos.\nAdemás, la página nunca se recarga por completo: cuando cambia la ruta, los\nscripts del cliente reescriben el DOM de la página que ya está abierta y cargan\nlos datos cuando hacen falta, en lugar de pedir un documento nuevo al servidor.\nEste artículo utiliza esa definición porque es la más directa disponible e\nidentifica la propiedad de la que depende todo lo demás: un documento que nunca\nse sustituye.\n\nLos componentes del navegador sí están normalizados. La interfaz History del\nestándar HTML proporciona a una página `history.pushState()`, que añade una\nentrada al historial de la sesión y establece la URL sin cargar nada, y\n`history.replaceState()`, que reescribe la entrada actual. Cuando se retrocede o\navanza entre esas entradas, el navegador envía un evento `popstate` a la ventana\ny deja que la página se encargue de redibujarse. La API Navigation, más reciente\ny presentada por el estándar como sucesora de las API clásicas de ubicación e\nhistorial, actúa desde el otro extremo: se emite un evento `navigate` cuando\nempieza una navegación, y su método `intercept()` la convierte en una navegación\ndentro del mismo documento que la propia página gestiona.\n\nLo opuesto es el sitio web convencional de varias páginas, donde cada enlace\npide un documento nuevo al servidor y el navegador descarta el anterior. Que el\nHTML de una página se genere una vez mediante un generador de sitios estáticos o\nen cada solicitud mediante renderizado en el servidor es una cuestión distinta:\ntrata de cómo se produce el HTML, no de lo que sucede después de recibirlo.\nNext.js difumina esa frontera deliberadamente: su exportación estática escribe\nun archivo HTML para cada ruta, pero la navegación entre ellas sigue ocurriendo\nen el cliente.\n\n## Por qué importa\n\nComo el documento nunca se sustituye, todo lo que contiene sobrevive a un clic:\nun formulario a medio rellenar, un vídeo en reproducción, la posición de\ndesplazamiento de un panel lateral o datos ya obtenidos. Solo tienen que cruzar\nla red los datos que necesita la siguiente vista, no una página completamente\nnueva con su cabecera, estilos y scripts. Un cambio de vista puede consistir\núnicamente en reescribir una región de la página.\n\nNext.js expone los costes junto con la definición. Una SPA estricta a menudo\ntiene que cargar una gran cantidad de JavaScript antes de que la página sea\ninteractiva, y las cascadas de solicitudes de datos en el cliente, donde una\nsolicitud solo puede empezar cuando otra ha terminado, son difíciles de\ngestionar. También hay un coste para cualquier sistema que lea la página sin\nejecutar scripts. Si todas las rutas utilizan un solo archivo HTML, un\nrastreador que no ejecute JavaScript recibe el mismo documento casi vacío sea\ncual sea la URL que solicite. Next.js señala lo mismo sobre sus componentes que\nsolo se ejecutan en el navegador: cualquier sistema que indexe la página sin\nejecutar scripts recibe el contenido alternativo, no el componente.\n\nSu respuesta consiste en mantener la navegación en el cliente y trasladar el\nresto. Next.js divide automáticamente los paquetes de JavaScript y genera\nmúltiples puntos de entrada HTML a distintas rutas, para que quien visite el\nsitio no cargue código que una ruta no necesita. Su componente `next/link`\nprecarga rutas, lo que hace que los cambios de ruta parezcan tan inmediatos como\nen una SPA renderizada por completo en el cliente, mientras mantiene el estado\ndel enrutamiento de la aplicación en la URL, que se puede enlazar y compartir.\nUna exportación estática va más allá y escribe una página completamente\nrenderizada para cada ruta, de modo que las visitas reciben contenido sin\nesperar al paquete del cliente, mientras que las transiciones entre páginas en\nel cliente siguen siendo tan rápidas como en una SPA estricta.\n\nTampoco es una decisión definitiva. Next.js describe un proyecto que empieza\ncomo sitio estático, o incluso como SPA estricta renderizada íntegramente en el\ncliente, y añade funciones de servidor a medida que crece. También indica que\nuna SPA existente puede migrar sin reescribirse desde cero.\n\n## Cómo se aplica en la práctica\n\nEl enrutador siguiente, escrito para este artículo, es la versión funcional más\npequeña de la idea. Supone que la página tiene un elemento `\u003cmain\u003e` y que el\nservidor responde a todas las rutas de la aplicación con el mismo documento\nHTML. Las dos vistas representan lo que la aplicación muestre en realidad.\n\n```js\n// router.js\nconst views = {\n  \"/\": { title: \"Orders\", text: \"Your recent orders.\" },\n  \"/settings\": { title: \"Settings\", text: \"Delivery preferences.\" },\n};\nconst main = document.querySelector(\"main\");\n\nfunction show(path, moveFocus) {\n  const view = views[path] ?? views[\"/\"];\n  const heading = document.createElement(\"h1\");\n  const body = document.createElement(\"p\");\n  heading.textContent = view.title;\n  heading.tabIndex = -1;\n  body.textContent = view.text;\n  main.replaceChildren(heading, body);\n  document.title = view.title;\n  if (moveFocus) heading.focus();\n}\n\ndocument.addEventListener(\"click\", (event) =\u003e {\n  const link = event.target.closest(\"a[href]\");\n  const modified = event.metaKey || event.ctrlKey || event.shiftKey;\n  if (!link || link.origin !== location.origin) return;\n  if (modified || event.button !== 0) return;\n  event.preventDefault();\n  history.pushState(null, \"\", link.href);\n  show(location.pathname, true);\n});\n\nwindow.addEventListener(\"popstate\", () =\u003e show(location.pathname, true));\nshow(location.pathname, false);\n```\n\nEl manejador de clics toma el control de los clics normales con el botón\nizquierdo sobre enlaces al mismo origen y deja pasar los clics modificados, por\nlo que sigue siendo posible abrir un enlace en otra pestaña. `preventDefault()`\ndetiene la navegación propia del navegador, y `pushState()` registra una nueva\nentrada en el historial de la sesión con la URL del enlace; su argumento central\nsolo existe por razones históricas, de ahí que sea una cadena vacía. `show()`\nsustituye la vista, establece el título del documento y mueve el foco al nuevo\nencabezado, al que un `tabIndex` de `-1` permite recibir el foco desde un script\nsin incluirlo en el orden de tabulación. El escuchador de `popstate` redibuja la\nvista correspondiente al retroceder o avanzar, y la última línea dibuja la vista\nde la URL con la que se abrió la página. Esto solo funciona si el servidor envía\nel mismo documento para `/settings` que para `/`. Una aplicación real también\nmostraría su propia vista de página no encontrada en lugar de volver en silencio\na la página inicial, y dejaría intactos los enlaces a archivos y a otras partes\ndel sitio.\n\nEn el trabajo actual de la fundadora en NextMariner, el frontend de Next.js 16\nmuestra estos costes en un producto real.\n[Su ficha en el portafolio](/es/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/)\ndescribe un panel con autenticación que debía resultar rápido y mantener una\ninteractividad real, y señala qué ocurre cuando todos los datos se obtienen en\nel cliente: la primera carga se vuelve lenta y aparece el patrón N+1, en el que\ncada componente se activa y envía su propia solicitud hasta que una sola página\nse convierte en una cascada de intercambios de ida y vuelta. Es un caso práctico de la cascada de\nsolicitudes de datos en el cliente de la que advierte la guía de Next.js. La solución mantuvo la interactividad en el cliente\ndonde importaba y trasladó la primera obtención de datos al servidor. En el\npanel y en los grandes listados del directorio, una factoría llamada\n`createPrefetchedServerPage` entrega cada página al cliente con los datos ya\npreparados. La ficha es clara sobre lo que queda: las demás páginas con\nautenticación aún se renderizan en el cliente y esperan su turno. Describe,\npues, una migración que funciona y cuya siguiente página por migrar está clara,\npero que todavía no ha terminado.\n\n## Dónde surgen los problemas\n\n**El botón Atrás sale de la aplicación.** Si un script cambia las vistas sin\nllamar a `pushState()`, el historial de la sesión no tiene entradas para ellas.\nAtrás se salta todas las vistas que se han mostrado y sale por completo de la\naplicación, y una recarga vuelve a la URL con la que se abrió inicialmente.\nAñada una entrada para cada vista que se consideraría una página, utilice\n`replaceState()` para los cambios que no deban convertirse en pasos propios,\ncomo un filtro mientras se escribe, y gestione `popstate`. Next.js defiende\nmantener el estado del enrutamiento en la URL por la misma razón: permite\ncompartir una vista y enlazarla.\n\n**Un enlace profundo encuentra un servidor que solo conoce un archivo.** En una\nSPA estricta, un archivo HTML sirve a todas las rutas, pero la barra de\ndirecciones muestra `/settings`, y eso es lo que pide el navegador al recargar o\nal abrir un enlace compartido. Un servidor que solo tiene `index.html` responde\ncon un 404. Configure el servidor para responder a cada ruta de la aplicación\ncon ese documento, o genere un archivo por ruta. La exportación estática de\nNext.js hace lo segundo: su carpeta `out` contiene archivos como `index.html`,\n`404.html` y `blog/post-1.html`, y su guía muestra una regla de nginx,\n`try_files $uri $uri.html $uri/ =404;`, que asocia una URL limpia con el archivo\ncorrespondiente.\n\n**El foco permanece donde estaba la vista anterior.** `pushState()` cambia el\nhistorial de la sesión y la URL, y nada más. Después de que un script sustituya\nla vista, el foco del teclado permanece en el enlace pulsado, o se pierde si se\nha eliminado el elemento que lo tenía, y nada avisa a la tecnología de apoyo de\nque ha llegado una vista nueva si no lo hace la propia página. Establezca el\ntítulo y mueva el foco al encabezado de la nueva vista, como hace el ejemplo. La\nAPI Navigation asume una parte mayor de esta tarea. Una navegación gestionada\ncon `intercept()` restablece el foco de forma predeterminada en el primer\nelemento con `autofocus` o, si no lo hay, en el cuerpo del documento. Una vez\nterminado el manejador, el navegador comunica al usuario que ha finalizado, lo\nque, según el estándar, incluye a la tecnología de apoyo. Una aplicación que\nsitúe el foco por su cuenta desactiva ese comportamiento mediante\n`focusReset: \"manual\"`.\n\n**Todo se paga de antemano.** Una SPA estricta a menudo tiene que cargar una gran\ncantidad de JavaScript antes de que nada sea interactivo, y sus primeras\nsolicitudes de datos solo empiezan cuando se ejecuta ese código. Divida el\npaquete por rutas, para que cada visita descargue solo lo que necesita la vista\nactual, e inicie las primeras solicitudes en el servidor. El patrón de Next.js\npara esto inicia la obtención de datos en un Server Component sin esperar a que termine y pasa la promesa\na un Client Component, que extrae su valor con\n`use()`. Como la solicitud empieza\nantes de renderizar el resto de la aplicación, explica la guía, la respuesta\npuede empezar a enviarse por partes de inmediato, y el cliente evita una cascada de\nsolicitudes en la que cada una espera a la anterior.\n\n## Lecturas adicionales\n\n- [Cómo crear aplicaciones de una sola página con Next.js](https://nextjs.org/docs/app/guides/single-page-applications)\n  — la definición de SPA estricta, sus costes y los patrones que utiliza Next.js\n  para mantener la navegación en el cliente y trasladar trabajo al servidor.\n- [Estándar HTML: la interfaz History](https://html.spec.whatwg.org/multipage/nav-history-apis.html#the-history-interface)\n  — `pushState()`, `replaceState()` y cómo se añaden y sustituyen las entradas\n  del historial de la sesión.\n- [Estándar HTML: API Navigation](https://html.spec.whatwg.org/multipage/nav-history-apis.html#navigation-api)\n  — el evento `navigate`, `intercept()` y la gestión del foco y el\n  desplazamiento que los acompaña.\n- [Cómo crear una exportación estática de su aplicación Next.js](https://nextjs.org/docs/app/guides/static-exports)\n  — un archivo HTML por ruta, lo que no puede hacer una exportación estática y\n  cómo servir URL limpias con nginx.\n\n\u003chttps://engineer.company/es/glossary/single-page-application/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Una página HTML que JavaScript modifica al navegar: las API del navegador que lo permiten, sus costes y cuatro errores habituales.","formats":{"gemtext":"https://engineer.company/es/glossary/single-page-application/index.gmi","gopher":"https://engineer.company/es/glossary/single-page-application/gophermap","html":"https://engineer.company/es/glossary/single-page-application/","json":"https://engineer.company/es/glossary/single-page-application/index.json","markdown":"https://engineer.company/es/glossary/single-page-application/index.md","pdf":"https://engineer.company/es/glossary/single-page-application/index.pdf"},"kind":"page","language":"es","title":"¿Qué es una aplicación de una sola página?","url":"https://engineer.company/es/glossary/single-page-application/","version":1}