Skip to content

readdir ​

Lee el contenido de un directorio y devuelve un array de objetos DirEntry.

Firmareaddir(path: string, options?: ReaddirOptions): Result<DirEntry[], FsError>

Opciones de lectura ​

ReaddirOptions es una interfaz con un campo opcional:

  • recursive?: boolean: cuando es true, recorre los subdirectorios de forma recursiva e incluye sus entradas en el resultado. El valor predeterminado es false.

Entradas de directorio ​

Cada DirEntry tiene los campos de solo lectura name: string y type: DirEntryType. DirEntryType es un enum con los miembros File, Directory, Symlink y Other, que permite identificar el tipo de entrada sin inspeccionar su nombre.

Ejemplo ​

tyrus
import { FsError, readdir } from "tyrus:fs";

match (readdir(".")) {
    Ok(entries) => { print(entries.length); } // 3
    Err(error) => { printError(error.code); } // ERR_FS_READ_FAILED
}

Tratamiento de errores ​

Devuelve Err(FsError) con el código ERR_FS_READ_FAILED si no se puede leer el directorio raíz o algún directorio recorrido de forma recursiva, o si no se puede inspeccionar una entrada. La operación no devuelve un listado parcial.

error

tyrus
import { FsError, readdir } from "tyrus:fs";

match (readdir("/nonexistent")) {
    Ok(entries) => { print(entries.length); }
    Err(error) => { printError(error.code); } // ERR_FS_READ_FAILED
}