HOWTO · React
console.log() en React
Aprende dónde usar console.log() para inspeccionar valores de JavaScript, el estado, las props y los datos de eventos en React, y cuándo conviene retirar los registros de depuración.
En esta página
En React, console.log() envía un valor a la consola de desarrollador del navegador, donde puedes inspeccionar datos de JavaScript mientras depuras. Colócalo donde el valor esté disponible: en un componente para revisar las props o el estado del renderizado actual, en un efecto para observar el estado ya confirmado o en un controlador de eventos para inspeccionar los datos que introduce el usuario.
Qué hace console.log() en React
console.log() es un método de JavaScript, no una función propia de React. Escribe los argumentos que le pasas en la consola de desarrollador; no los muestra en la página. Abre las herramientas de desarrollo del navegador y selecciona el panel Console para ver los mensajes. Un componente puede renderizarse sin registrar nada: los mensajes solo aparecen cuando la ejecución llega a la llamada.
Para consultar la API de la consola y sus métodos, visita la documentación de console en MDN.
Registro básico en la consola de JavaScript
Llama a console.log() con una cadena, un número, un objeto, un arreglo o varios valores. Este ejemplo autónomo de JavaScript envía un saludo a la consola de desarrollador; debajo se muestra la línea resultante:
console.log("Hello, React!");
Hello, React!
Por ejemplo, console.log("user", user) etiqueta un objeto en la consola. Los navegadores formatean los objetos para facilitar su inspección, aunque la presentación exacta depende del navegador. Para aplicar estilo a un mensaje, usa el especificador de formato %c, como en console.log("%cImportant", "color: red; font-weight: bold"); %c aplica la cadena de estilos siguiente al texto del mensaje. console.important() no es un método integrado: si quieres ese comportamiento, debes definirlo en una función propia.
Registrar el estado de un componente
En un componente de función, coloca console.log(count) en el cuerpo del componente para inspeccionar el valor de count en ese renderizado. React vuelve a ejecutar el cuerpo cuando renderiza el componente, por lo que el mensaje puede aparecer muchas veces. En desarrollo también puede haber renderizados adicionales, por ejemplo con Strict Mode; no des por hecho que verás un único mensaje por acción del usuario.
Las actualizaciones de estado programan un renderizado posterior. Si registras el valor justo después de setCount(count + 1), seguirás leyendo el valor count del renderizado actual. Para observar cada valor confirmado, coloca console.log(count) en un efecto cuya dependencia sea [count]; ese efecto también se ejecuta después del montaje inicial. Si quieres registrar una transición concreta, registra el evento o la acción que solicita la actualización, en vez de introducir efectos secundarios de registro dentro de la función que actualiza el estado.
Inspeccionar las props
Registra una prop dentro del componente que la recibe. Por ejemplo, un componente hijo que recibe user puede llamar a console.log("user prop", user) en su cuerpo. Así verás el valor proporcionado para ese renderizado y podrás seguir el flujo de datos del componente padre al hijo. Como el cuerpo puede ejecutarse de nuevo en renderizados posteriores, es posible que la misma prop se registre varias veces. Si el objeto contiene datos anidados, registra el campo concreto que estás investigando para que sea más fácil leer la salida.
Registrar datos de eventos
Coloca el registro en el controlador del evento para inspeccionar los datos cuando el usuario interactúa con la página. En el controlador de cambio de un campo de entrada, console.log(event.currentTarget.value) lee el valor actual del campo cuando se ejecuta el controlador. Si este también actualiza el estado, el valor del evento está disponible de inmediato, mientras que el nuevo estado se observará en un renderizado posterior. Registrar el dato en el controlador evita que renderizados del componente no relacionados repitan el mismo mensaje.
Usar los registros de forma segura y eliminarlos
Considera los registros como ayudas temporales para depurar. Antes de publicar una versión, busca y elimina los que ya no sean útiles, sobre todo si contienen datos personales, tokens u otra información sensible. Las compilaciones de producción no eliminan siempre las llamadas a console.log(); eso depende de la configuración de compilación del proyecto. Conserva los registros operativos intencionados solo si se ajustan a la política de registro de la aplicación.
Para comprobar un valor, regístralo donde esté disponible: usa el renderizado o un efecto para los datos del componente, y un controlador de eventos para los datos de una interacción. En sesiones de depuración más extensas, los puntos de interrupción del navegador y React Developer Tools permiten inspeccionar la ejecución y los datos del componente sin añadir llamadas de registro permanentes. Puedes borrar lo que aparece en la consola con el control para limpiarla o mediante console.clear(), pero eso no elimina las llamadas de registro del código. Si esperas que la compilación quite los registros del paquete de producción, revisa su configuración; de lo contrario, elimina del código fuente las llamadas temporales antes de publicar.