¿Qué causa el error ERR_INVALID_ARG_TYPE?

Pasar un número donde se espera una cadena de ruta de archivo. Pasar undefined o null a una función que requiere un Buffer o cadena. Una variable que contiene el tipo incorrecto debido a un error de lógica anterior. Desestructurar la propiedad incorrecta de un objeto antes de pasarla a una API.

← Errores

JavaScript

Qué significa ERR_INVALID_ARG_TYPE y cómo solucionarlo

Referencia del error

ERR_INVALID_ARG_TYPE

Lenguaje

JavaScript

Severidad

Media

Cuándo ocurre

Node.js lanza ERR_INVALID_ARG_TYPE cuando una función de API incorporada recibe un argumento del tipo incorrecto.

Posibles soluciones

Lee el mensaje de error cuidadosamente: nombra el argumento y el tipo esperado. Valida los tipos de entrada antes de pasarlos a las APIs de Node.js. Usa TypeScript o tipos JSDoc para detectar estos desajustes en tiempo de desarrollo.

Errores relacionados

TypeError TS7006: Any implícito ValueError

Más detalles

Node.js lanza ERR_INVALID_ARG_TYPE cuando una función de API incorporada recibe un argumento del tipo incorrecto. El mensaje de error especifica el nombre del argumento, los tipos esperados y el valor real recibido.

Por qué ocurre

•Pasar un número donde se espera una cadena de ruta de archivo.
•Pasar undefined o null a una función que requiere un Buffer o cadena.
•Una variable que contiene el tipo incorrecto debido a un error de lógica anterior.
•Desestructurar la propiedad incorrecta de un objeto antes de pasarla a una API.

Posibles soluciones

Lee el mensaje de error cuidadosamente: nombra el argumento y el tipo esperado. Valida los tipos de entrada antes de pasarlos a las APIs de Node.js. Usa TypeScript o tipos JSDoc para detectar estos desajustes en tiempo de desarrollo.

Ejemplos

JavaScript

Código que causa el error

const fs = require("fs");
fs.readFile(123, "utf8", (err, data) => console.log(data));

Error en la terminal

TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received type number (123)

Código corregido

const fs = require("fs");
fs.readFile("./data.txt", "utf8", (err, data) => {
  if (err) throw err;
  console.log(data);
});

Practica en inglés

¿Cómo le explicarías un ERR_INVALID_ARG_TYPE a un compañero dev? Elige la frase correcta:

"I hit an error...

¿Programando en inglés?

Para arreglar esto, leíste inglés técnico real. Lingua-e tiene ejercicios gratis hechos igual: dailys, code reviews y situaciones reales de trabajo.

Practicar inglés para developers gratis