Me tropecé con [object Object] mil veces en proyectos web, y te cuento qué demonios es
Si alguna vez has visto ese molesto [object Object] saliendo en una pantalla, en un log o en medio de una interfaz, respira. No has roto nada, y el motor de JavaScript tampoco. Lo que ocurre es mucho más simple y a la vez más traicionero de lo que parece: has pedido al navegador que muestre un objeto donde solo cabía un texto plano, y él, sin más información, ha devuelto su etiqueta genérica por defecto.
Recuerdo cuando dirigía un canal de ventas online y un compañero me llamó desesperado porque la pasarela de pago devolvía ese mensaje en pantalla en lugar del resumen del pedido. Tardé apenas unos minutos en darme cuenta de que alguien había metido el objeto respuesta completo dentro de un alert sin extraer la propiedad concreta. No era un fallo del sistema, era una conversión implícita de tipos que nadie había previsto.
El origen está en el sistema de prototipos. Todo objeto en JavaScript hereda de Object.prototype, y ese prototipo trae un método toString() que se dispara automáticamente cuando el valor necesita convertirse en cadena. Para un objeto literal plano, ese toString() no sabe qué contenido interno hay, así que escupe literalmente el texto "[object Object]". El primer "object" marca la categoría interna del valor, el segundo hace referencia al constructor Object que creó la instancia.
Para que quede claro, mira esta tabla de etiquetas que devuelve Object.prototype.toString.call() según el tipo:
| Tipo de valor | Etiqueta devuelta |
|---|---|
| Función | [object Function] |
| Array | [object Array] |
| Expresión regular | [object RegExp] |
| Fecha | [object Date] |
| Objeto plano | [object Object] |
Lo que me fascinó desde que empecé a trastear con código es que no es un mensaje de fallo en absoluto, sino una etiqueta de tipo genérica. El motor te está diciendo "esto es un objeto, ya me apañaré yo para decirte cuál". Y ahí reside la confusión, porque uno lo interpreta como un error crítico cuando en realidad es el comportamiento más normal del lenguaje.
Los contextos donde aparece con más frecuencia son dos: el alert() del navegador, que fuerza la conversión a cadena de su único argumento, y la llamada directa a toString() sobre un objeto. Pero ojo, también se activa en operaciones mucho más sutiles, concatenar con el operador más, meter un objeto dentro de un template literal, asignarlo a element.textContent o innerText. En esos casos ni siquiera has invocado toString() tú, el lenguaje lo ha hecho por ti sin avisar.
Un caso que me persiguió durante años en proyectos con WordPress y Prestashop era el de los objetos envolventes tipo jQuery. Pasabas un objeto jQuery directamente a alert y salía "[object Object]" porque se serializaba antes de mostrarse. La solución nunca fue insistir con el alert, sino ir a la propiedad concreta, extraer el nodo DOM subyacente, o acceder al identificador mediante el índice. En mis siguientes auditorías de código siempre buscaba ese patrón, porque indica que alguien no tenía claro qué quería imprimir realmente.
“JSON.stringify(obj, null, 2) sustituye el aplanamiento por una cadena legible con indentación controlada.”
Dato clave