Saltar al contenido principal

Fix: «productos.slice is not a function» al crear una plantilla de solicitud

· 5 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Al abrir el formulario de una plantilla de solicitud (SOL-001) la pantalla reventaba:

Unhandled Runtime Error
TypeError: productos.slice is not a function
src\pages\plantillas-solicitud.tsx (383:32) @ slice

🔎 Causa raíz (dos capas)​

1. El contrato del listado de productos cambió y este consumidor no. GET /api/productos responde ahora con un sobre paginado:

{ "data": [ ... ], "meta": { "totalItems": 42, "totalPages": 3 } }

pages/products.tsx se actualizó en su día y hasta documenta el formato en un comentario (// Format: { data: [...], meta: {...} }). plantillas-solicitud.tsx se quedó esperando la forma antigua (un array pelado), así que guardaba el sobre en el estado y productos.slice(...) no encontraba un array.

2. getAllProducts devuelve la respuesta de Axios, no el cuerpo. Es la única función de src/api/product.ts que hace return response en lugar de return response.data — 13 funciones hermanas devuelven el cuerpo — y contradice su propio JSDoc («Paginated list of products»). Por eso el array no está en respuesta.data, sino en respuesta.data.data.

Evidencia de que la forma es esa: widget-datos.ts ya tenía un ayudante propio (aArreglo) que cava primero r.data.data, y getStockByCategory / getGlobalStockFullness hacen lo mismo. Tres autores distintos resolviendo el mismo sobre a mano.

🛠️ Corrección​

Se centraliza la lectura en src/utils/respuesta-api.ts:

const cuerpo = respuesta?.data ?? respuesta;
if (Array.isArray(cuerpo)) return cuerpo;
if (Array.isArray(cuerpo?.data)) return cuerpo.data;
if (Array.isArray(cuerpo?.productos)) return cuerpo.productos;
// items / users / stockAlerts: claves de otros listados del sistema
return [];

extraerLista() garantiza siempre un array, así que ningún consumidor puede volver a llamar a .map() o .slice() sobre un sobre. plantillas-solicitud.tsx pasa a usarlo.

🧪 Verificación​

Primero se reprodujo el fallo con una prueba que fallaba, escrita contra la lógica que tenía la pantalla:

✗ extrae el array del sobre paginado dentro de una respuesta de Axios
Received: {"data": [{"idProducto": 1}, ...], "meta": {"totalItems": 2}}
✗ nunca devuelve algo que no sea un array (el fallo original)
Expected: true Received: false

Es decir: devolvía el sobre, exactamente lo que hace reventar a .slice(). Tras el arreglo, src/utils/respuesta-api.spec.ts pasa 9/9.

  • npx tsc --noEmit -p tsconfig.json → 0 errores.
  • Suite de la web: 241/252 pruebas, con los mismos 3 fallos previos (las suites de la migración TEC-019), sin regresiones nuevas.

✅ Corrección sistémica del contrato (misma entrega)​

Se ha corregido el origen, no solo el síntoma:

  1. getAllProducts devuelve response.data (el cuerpo del API), como sus 13 funciones hermanas y como dice su JSDoc, que ahora avisa explícitamente de que no devuelve la respuesta de Axios.
  2. Los 20 sitios que lo consumen quedaron migrados a extraerLista() —o leyendo el sobre de forma explícita donde hacen falta metadatos—:
FicheroQué requería
pages/products.tsx (2 sitios)Conservar meta.totalItems: era el único que usaba los metadatos y, sin ajustarlo, la paginación habría pasado a contar solo la página actual
api/product.ts (2 sitios)getStockByCategory conserva su throw para no pintar el gráfico con datos de relleno; getGlobalStockFullness usa el ayudante
components/requests/mobile-request-detail.tsxAdemás se corrigió que guardaba el sobre en el estado y que comprobaba officesResponse.success, campo inexistente en la respuesta de oficinas: las oficinas no se cargaban nunca
components/tableros/widget-datos.tsSu ayudante local aArreglo (duplicado del nuevo) se sustituyó por el compartido
hooks/use-offline-inventory.tsCuidado especial: sin cuerpo no se toca la caché offline, porque cachear [] dejaría el modo offline marcado como «disponible» sin datos
components/{inventory,lotes,reports,requests}/*, pages/{inventory-movements,pronostico-demanda,plantillas-solicitud}Sustitución del desenvolvimiento a mano por el ayudante
hooks/use-products.tsSin ningún consumidor (código muerto): se deja como está

El contrato queda blindado con pruebas​

  • src/api/product.spec.ts (nuevo): fija que getAllProducts devuelve el cuerpo y no una AxiosResponse, y que devuelve null si la petición falla. Fallaba antes del cambio (Received: { config, data, headers }).
  • src/utils/respuesta-api.spec.ts: 9 casos con todas las formas de respuesta que hay hoy en el sistema, incluidos los errores del API.

Verificación​

  • npx tsc --noEmit -p tsconfig.json → 0 errores (la comprobación central de los 20 sitios: cazó, por ejemplo, un let x = [] que quedaba inferido como never[] al asignarle la lista).
  • Suite de la web: 246/257 pruebas, con los mismos 3 fallos previos (suites de la migración TEC-019), sin regresiones nuevas.

🧭 Lo que queda (fuera de esta entrega)​

getAllProducts no era el único: otras 20 funciones de src/api/ devuelven la respuesta de Axios en lugar del cuerpo — request.ts (9), aprobaciones.ts (4), inventory-movement.ts (3), presupuestos.ts (3) y log.ts (2), de un total de 365 exports. Por eso siguen existiendo consumidores que cavan .data.data a mano (logs-table.tsx, inventory-summary.tsx con los movimientos, mobile-requests.tsx…). Consolidar esos módulos con el mismo criterio es el siguiente paso natural, y ya tiene el ayudante y las pruebas que necesita.

🐛 Hallazgo aparte: el logger revienta en el navegador​

Al escribir las pruebas apareció que src/config/logger-dev.ts usa el transporte de pino, que necesita APIs de Node. En jsdom el catch de getAllProducts no devuelve null, sino que revienta con:

ReferenceError: setImmediate is not defined

setImmediate tampoco existe en el navegador, así que el efecto probable es que muchos catch que solo registran el error y devuelven un valor de relleno no lleguen a hacerlo, y que el error original quede enmascarado por un ReferenceError. No se toca en esta entrega: merece su propio diagnóstico.