¿Cómo leer todos los archivos de un directorio con Node?

- 2 min read

Una tarea común en una aplicación en un servidor es obtener un listado de archivos que existen dentro de algún directorio para después realizar alguna tarea con ellos.

Nodejs ofrece una API que permite trabajar con archivos incluyendo la posibilidad de leer el contenido de un directorio de forma síncrona y asíncrona (con callbacks o promesas).

js
					
						

/* Leer el contenido de un directorio de forma sincrona */

// files es un arreglo con los nombres de los archivos dentro del directorio
import fs from 'node:fs'
const files = fs.readdirSync('./mi-directorio') 



/* Leer el contenido de un directorio de forma asincrona usando callbacks*/
import fs from 'node:fs'
let files = []
fs.readdir('./mi-directorio',(err, result) => {
  if(err) {
    console.error(err)
    throw Error(err)
  }
  files = result
}) 


/* Leer el contenido de un directorio de forma asincrona usando promesas*/
import fs from 'node:fs'

const files = await fs.promises.readdir('./mi-directorio')
					
				

Pero esto solo retornará la lista de archivos y directorios del “primer nivel”, es decir, si tienes un estructura de directorio como:

!undefined

sponsor

El contenido de este sitio es y será siempre gratuito para todos. Ayudame a mantenerlo así convirtiendote en auspiciador.
Matias Hernández Logo

Tu producto o servicio podría estar aquí

El resultado será:

js
					
						

[
  'node_modules',
  'public',
  'src',
  '.gitignore',
  'package.json',
  'README.md'
]
					
				

¿Cómo obtener todos los archivos incluyendo los sub-directorios?

Recursión es la respuesta:

js
					
						

async function readAllFiles(path, arrayOfFiles = []){
	const files = fs.readdirSync(path)
	files.forEach(file => {
		const stat = fs.statSync(`${path}/${file}`)
		if(stat.isDirectory()){
			readAllFiles(`${path}/${file}`, arrayOfFiles)
		}else{
			arrayOfFiles.push(`${path}/${file}`)
		}
	}
	)
	return arrayOfFiles
}
					
				

La función de arriba realiza la lectura del contenido de un directorio

js
					
						
const file = fs.readdirSync(path)

					
				

Luego, para cada uno de los elementos del arreglo retornado files.forEach revisa si dicho elemento es o no un directorio

js
					
						
const stat = fs.statSync(`${path}/${file}`)

if(stat.isDirectory())

					
				

En caso de ser un directorio, realiza una llamada recursiva, cambiando el primer argumento para que sea el actual directorio.

js
					
						
readAllFiles(`${path}/${file}`, arrayOfFiles)

					
				

En caso contrario, simplemente almacena en el arreglo arrayOfFiles el archivo.

Así, el resultado de leer la estructura de directorios anterior el resultado será

js
					
						
[  
    ................  
    'public/favicon.ico',

    'public/index.html,

    'public/robots.txt',  
    'src/index.css',

    'src/index.js',  
    '.gitignore',  
    'package.json',  
    'README.md'  
]

					
				

😃 Thanks for reading!

Did you like the content? Found more content like this by joining to the Newsletter or following me on Twitter

⚙️ Edit this on github