L16 · Construcción y vista previa · 4 min
Cómo leer un mensaje de error
En una frase
Un mensaje de error no es una bronca, sino una pista útil con tres partes: la primera línea dice qué falló, el nombre del archivo y el número de línea indican dónde ocurrió y la traza de error lista los pasos previos para que tu agente lo arregle.
Piénsalo así
Piensa en un detector de humo que no solo pita, sino que imprime un recibo que dice: «Tostada quemada — Cocina, ranura 2 de la tostadora — empezó tras poner el temporizador al 9». En cuanto sabes leer ese recibo, las letras rojas dejan de asustar.
Cómo funciona
Cuando algo falla mientras construyes tu app, tu equipo muestra un Definiciónmensaje de errorLo que dice un programa cuando algo falla. La primera línea suele decir qué; el resto dice dónde.Abrir en el glosario →. Aunque parezca un muro de texto técnico, solo necesitas distinguir tres partes: qué falló, dónde ocurrió y el rastro de pasos que llevó hasta ahí.
La primera línea te dice qué falló, por ejemplo TypeError: Cannot read properties of undefined (reading 'title') (la app intentó leer .title en algo que estaba vacío). Justo debajo, la ruta de un DefiniciónarchivoUn contenido con nombre guardado en tu equipo, como un documento, una imagen o un trozo de código.Abrir en el glosario → con dos números separados por dos puntos —como app/recipes/page.tsx:24:12— te dice dónde: línea 24, columna 12 de ese archivo.
Las líneas de abajo que empiezan por at … forman la Definicióntraza de error (stack trace)La lista de pasos que llevaron a un error. Útil para tu agente; nunca se enseña a tus usuarios.Abrir en el glosario →: el recorrido inverso de los pasos que dio tu app antes de detenerse. No tienes que memorizar ni descifrar cada línea; tu Definiciónagente de programaciónUna IA que trabaja en la carpeta de tu proyecto: lee archivos, escribe código y ejecuta comandos, con tu permiso.Abrir en el glosario → lee trazas de error con soltura y las usa para localizar el origen exacto.
Para informar bien de un fallo, cuéntale a tu agente tres cosas sencillas —qué hiciste, qué esperabas y qué ocurrió en su lugar— y añade el texto exacto del error o una captura. Antes de pegar o adjuntar nada, comprueba siempre que no se vea ningún DefiniciónsecretoTodo lo que abre tus cuentas: claves de API, contraseñas, tokens. Solo se guarda en Vercel y en `.env.local`.Abrir en el glosario →, contraseña ni Definiciónclave de APIUna contraseña que usa tu app con otro servicio. Quien la tenga puede gastar tu dinero.Abrir en el glosario →; el agente puede leer los archivos de Definiciónlog (registro)El diario de tu app: una línea por evento. Cuando algo se rompe, los logs cuentan qué pasó.Abrir en el glosario → por su cuenta.
Cómo se ve en tu proyecto
Cuando aparezca un error en localhost:3000 o en la terminal, copia el mensaje (asegurándote de que no incluya claves ni contraseñas) y dile a tu agente qué pulsaste justo antes. Tu agente te explicará el fallo en una frase sencilla antes de arreglarlo.
Copia para tu agente
Pulsé [botón/enlace], esperaba [qué debía pasar] y en su lugar salió este error: [pega el error sin ningún secreto]. Explícame con palabras sencillas qué significan la primera línea y el archivo:línea, y busca la causa.
Comprobación rápida · 1 pregunta