Skip to content

readdir ​

Lê o conteúdo de um diretório e retorna um array de objetos DirEntry.

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

Opções de leitura ​

ReaddirOptions é uma interface com um campo opcional:

  • recursive?: boolean: quando true, 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
}