INICIO
tecnologia · programación
que es error object object, Programador revisando código con un alert mostrando [object Object] en pantalla
tecnologia ·#6525 ·Lectura 6 min. · Redactor: Gonzalo E.Garcia

💻 [object Object] en JavaScript, qué es y cómo resolverlo

Respuesta corta
Verificado
Redactado por Humanos!

[object Object] no es un error del sistema, es Object.prototype.toString() devolviendo su etiqueta genérica cuando no hay representación específica.

01

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 valorEtiqueta 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
que es error object object, Consola del navegador mostrando un objeto JavaScript expandido en árbol
Imagen

Consola del navegador mostrando un objeto JavaScript expandido en árbol

02

No es un bug, es JavaScript haciéndote una pregunta que tú no le hiciste

Como gestor de crisis en compañías de telecomunicaciones, aprendí una lección que aplica igual al código: un diagnóstico vago es peor que un diagnóstico negativo. Y "[object Object]" es el equivalente a un parte de avería que dice simplemente "algo está mal". No te dice qué objeto, no te dice de dónde venía, no te dice qué propiedades contenía. En producción, cuando ese texto aparece en un log, en un mensaje de error de una API o en un toast de interfaz, has perdido por completo la trazabilidad.

Las tres vías para resolverlo son bastante claras, y las he aplicado en todos los proyectos de e-commerce que he liderado. La primera es elegir la propiedad concreta que querías mostrar: si necesitas el nombre, obj.name; si necesitas un importe, obj.total. Es la más eficiente para datos puntuales porque no serializas estructuras enteras.

La segunda, y la que uso más cuando necesito ver todo, es JSON.stringify(). Recorre el objeto, produce una cadena con claves y valores, y con el segundo y tercer argumento controlas la indentación para que quede legible dentro de un elemento pre. Ten en cuenta que omite properties cuyo valor es undefined, una función o un symbol, y lanza TypeError si hay referencias circulares.

La tercera vía, mi favorita absoluta para depurar, es console.log(obj) o console.table(obj). Abres la consola, pasas el objeto solo como argumento, y expandes niveles, ves tipos reales, filtras. Un detalle crítico: si lo concatenas con un string usando el operador más, la consola también lo aplana a "[object Object]" y habrás perdido justo lo que querías conservar.

En mis tareas de crisis management siempre insistía en que nadie confiara en la conversión automática para registros. La práctica profesional es serializar explícitamente antes de loggear, siempre. Porque si mañana un usuario reporta un problema y tu log dice "[object Object]", tienes un agujero negro en la trazabilidad del incidente.

Ahora bien, no confundas esto con el objeto Error de JavaScript, que sí representa fallos reales. Los objetos Error se lanzan en tiempo de ejecución, y junto al constructor genérico existen otros siete: EvalError, InternalError, RangeError, ReferenceError, SyntaxError, TypeError y URIError. La clave es que Error redefine su propio toString(), así que un error bien construido se imprime como "Error: mensaje" y no como esa etiqueta genérica.

Cuando capturas una excepción en try...catch, registra siempre e.name + ": " + e.message o el stack trace completo. Si concatenas el objeto Error con un string sin usar sus propiedades, pierdes toda la información de diagnóstico. Los navegadores aportan fileName, lineNumber, columnNumber y stack, y en V8 tienes Error.captureStackTrace(). Conocer todo eso te permite construir mensajes precisos en lugar de dejar que la conversión automática trunque el rastro.

Para errores propios en ES6, puedes derivar clases de Error y lanzarlas con throw new MiError(), comprobando el tipo con instanceof. Y un matiz final sobre objetos: un objeto simple no es iterable, así que for...of sobre él lanza TypeError. Recorres con Object.entries, Object.keys o Object.values. El spread solo copia el nivel superior, los anidados quedan compartidos; structuredClone recorre todo pero no conserva prototipos ni getters. Todas estas particularidades apuntan a la misma idea: el objeto se aplana porque le pediste que fuera texto, y tú decides cómo debe verse convertido.

Conclusión:

¿que es error object object?

Yo creo que el mayor obstáculo con [object Object] no es técnico, es mental. Si lo etiquetas como "error" en tu cabeza, empiezas a buscar un bug donde no hay ninguno y pierdes tiempo valioso persiguiendo algo inexistente. Tal como yo lo veo, la solución siempre pasa por detenerte un segundo y preguntarte: ¿qué representación textual quiero realmente de este objeto? Una propiedad suelta, un JSON serializado, una inspección en consola. El motor no ha fallado, la intención del programador es la que necesita un ajuste. Y en este caso, tienes varias respuestas válidas según lo que necesites mostrar, así que elige con criterio y deja de tratar esa etiqueta como si fuera un incendio.


Fuentes: 1º Freecodecamp.org, 2º Devgex.com, 3º Developer.mozilla.org, 4º We.inc
IMAGEN1-AUTOR:Nexuscurioso|Licencia:Todos los derechos reservados|Url: ---
IMAGEN2-AUTOR:Nexuscurioso|Licencia:Todos los derechos reservados|Url: ---
Redacción: Gonzalo E.Garcia · Actualizado en: 14/11/2026
Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta Valoración para Respuesta
4.1 / 5 · 60 valoraciones Valorar

¿Tienes algo que aportar? Envíanos tu respuesta