Menú
NextToolbar

La barra

Cada segmento de la barra, su panel emergente, minimizar y temas.

La barra es una franja de ancho completo que flota 16 px por encima de la parte inferior de la ventana. Cada segmento resume un aspecto de la página actual; pasa el ratón por encima (o enfócalo con Tab) para abrir un panel con los detalles.

 N │ 200  # f9b45c  ⌥ /blog/[slug]  Static? │ ⏱ 39 ms server 46 ms nav  ⇄ fetch 3  ⚠ errors 0 │ … ⌘ Next 16.3.6  ◐  ⊗
 1    2      3            4            5            6                     7          8            9          10  11

Segmentos

#SegmentoQué muestraPanel al pasar el ratón
1LogoLa marca de NextToolbar. Haz clic para minimizar.—
2EstadoEstado HTTP: chip con degradado para 2xx, ámbar para 3xx, rojo para 4xx/5xx, gris — cuando se desconoceEl estado y si vino de una petición de documento o de una navegación en el cliente (RSC)
3Id de peticiónLos 6 primeros caracteres del id de la petición en el servidor, o profiler cuando las request insights están desactivadas— Al hacer clic abre el profiler en esta petición
4RutaEl patrón de ruta que coincidió, p. ej. /blog/[slug]Patrón, ruta real y cada valor de params.*
5Modo de renderStatic, Dynamic, Static?, Rendering… o ?El porqué, y lo que el modo desarrollo puede y no puede saber. Consulta Modo de render
6Tiemposserver: tiempo de render en el servidor. TTFB: tiempo hasta el primer byte de una carga completa. nav: duración de la petición RSC de una navegación en el clienteCada valor, y una pista para activar las request insights si están desactivadas
7FetchLlamadas fetch del servidor y porcentaje de acierto de la caché. Solo con request insightsResumen de la caché y cada fetch. Consulta Caché de fetch
8ErroresErrores del cliente + error del servidor de esta página. En rojo cuando son > 0Errores del servidor (clic → profiler) y errores del cliente (expandir → stack)
9NextVersión de Next.js instaladaVersión de React, request insights activadas/desactivadas, HMR socket conectado/desconectado
10TemaTema actualAl hacer clic alterna system → light → dark
11MinimizarIcono de cerrarPliega la barra a un círculo

El estado, la ruta y los tiempos siempre describen la página en la que estás. Cuando navegas en el cliente, la barra cambia a los datos de la nueva página en cuanto termina su petición RSC.

De dónde sale cada valor

ValorOrigen
Estado, TTFBNavigation Timing del navegador (responseStatus, responseStart)
Estado y nav en navegaciones en el clienteResource Timing del navegador para la petición ?_rsc=
Ruta (Next 16)route de la request insight que Next envía por el HMR socket de desarrollo
Ruta (Next 15 / sin insights)Reconstruida a partir de usePathname() y useParams()
Modo de renderDatos del indicador estático de desarrollo de Next, corregidos con la información de los fetches
Tiempo del servidor, fetches, errores del servidorRequest insights de Next 16
Errores del clienteEventos error y unhandledrejection de window

Más en Cómo funciona.

Errores

El segmento de errores cuenta los errores del cliente en la página actual más un error del servidor si la petición al servidor de esta página terminó con un error.

  • Los errores del servidor muestran el span donde se originó el error y su mensaje, p. ej. AppRender.waitShellReady · boom. Haz clic en la fila (Details) para abrir el profiler en esa petición con el error expandido.
  • Los errores del cliente (excepciones no capturadas y rechazos de promesas no gestionados) se expanden en el mismo sitio para mostrar su stack trace.
  • Los errores del cliente se reinician cuando navegas a otra página y se limitan a los últimos 20. El botón Clear del profiler también los vacía.

El stack trace del servidor nunca llega al navegador. Se imprime en la terminal que ejecuta next dev.

Minimizar

Haz clic en el logo o en el botón de cerrar y la barra se encoge en un círculo de 52 px en la esquina inferior izquierda. El círculo te mantiene informado:

  • un punto con degradado cuando la página devolvió 2xx; ámbar para 3xx, rojo para 4xx/5xx, gris cuando se desconoce;
  • una burbuja roja con el número cuando la página tiene errores.

Haz clic en el círculo para expandir la barra de nuevo. El estado plegado se recuerda por navegador.

Tema

La barra sigue por defecto la preferencia clara/oscura del sistema operativo. El botón de tema alterna system → light → dark y recuerda la elección. Establece el tema inicial con la prop theme; consulta Configuración.

Comportamiento responsive

ViewportComportamiento
más de 1024 pxTodo visible
hasta 1024 pxOculta la versión de Next, las etiquetas fetch / errors, el valor TTFB/nav cuando hay tiempo del servidor disponible y la etiqueta % hit
hasta 640 pxMárgenes de 8 px; la barra se desplaza horizontalmente. El logo de la izquierda siempre la minimiza

Teclado y accesibilidad

  • Tab recorre los segmentos; un segmento enfocado abre su panel.
  • Esc cierra el profiler.
  • Las animaciones se desactivan cuando el sistema operativo pide movimiento reducido.
  • La barra vive en un Shadow DOM: tu CSS no puede romperla y su CSS no puede filtrarse a tu app.