Skip to content

stat ​

Retorna estatísticas de um arquivo ou diretório. Caminhos inválidos retornam Err com ERR_FS_INVALID_PATH; caminhos que não podem ser inspecionados retornam Err com ERR_FS_STAT_FAILED.

Quando path é um link simbólico, as estatísticas descrevem o destino e isSymlink é true para o caminho original.

Assinaturastat(path: string): Result<FileStats, FsError>

Campos ​

CampoTipoDescrição
sizeu64Tamanho do arquivo em bytes.
isFilebooleantrue se o caminho for um arquivo.
isDirectorybooleantrue se o caminho for um diretório.
isSymlinkbooleantrue se o caminho for um link simbólico.
modifiedu64Horário da última modificação (segundos desde a época Unix).
createdu64Horário de criação (segundos desde a época Unix).
permissionsu32Bits de permissões do arquivo.

Para um caminho acessível em plataformas que não são Unix, permissions é 0; esta API expõe bits de permissão POSIX e não converte ACLs do Windows.

Exemplo ​

tyrus
import { stat, type FileStats, type FsError } from "tyrus:fs";

const result: Result<FileStats, FsError> = stat("./message.txt");
match (result) {
    Ok(info) => {
        print(info.size); // 18
        print(info.isFile); // true
        print(info.isDirectory); // false
    },
    Err(_) => {},
}