readdir
Lê o conteúdo de um diretório e retorna um array de objetos DirEntry.
Assinatura
readdir(path: string, options?: ReaddirOptions): Result<DirEntry[], FsError>Opções de leitura
ReaddirOptions é uma interface com um campo opcional:
recursive?: boolean: quandotrue, percorre subdiretórios recursivamente e inclui suas entradas no resultado. O padrão éfalse.
Entradas de diretório
Cada DirEntry tem os campos somente para leitura name: string e type: DirEntryType. DirEntryType é um enum com os membros File, Directory, Symlink e Other, permitindo identificar o tipo da entrada sem inspecionar seu nome.
Exemplo
tyrus
import { FsError, readdir } from "tyrus:fs";
match (readdir(".")) {
Ok(entries) => { print(entries.length); } // 3
Err(error) => { printError(error.code); } // ERR_FS_READ_FAILED
}Tratamento de erros
Retorna Err(FsError) com o código ERR_FS_READ_FAILED se o diretório raiz ou qualquer diretório percorrido recursivamente não puder ser lido, ou se uma entrada não puder ser inspecionada. A operação não retorna uma listagem 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
}