Skip to content

stat ​

Devuelve estadísticas de un archivo o directorio. Las rutas no válidas devuelven Err con ERR_FS_INVALID_PATH; las rutas que no se pueden inspeccionar devuelven Err con ERR_FS_STAT_FAILED.

Si path es un enlace simbólico, las estadísticas describen el destino e isSymlink es true para la ruta original.

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

Campos ​

CampoTipoDescripción
sizeu64Tamaño del archivo en bytes.
isFilebooleantrue si la ruta es un archivo.
isDirectorybooleantrue si la ruta es un directorio.
isSymlinkbooleantrue si la ruta es un enlace simbólico.
modifiedu64Hora de la última modificación (segundos desde la época Unix).
createdu64Hora de creación (segundos desde la época Unix).
permissionsu32Bits de permisos del archivo.

Para una ruta accesible en plataformas que no son Unix, permissions vale 0; esta API expone bits de permisos POSIX y no convierte las ACL de Windows.

Ejemplo ​

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(_) => {},
}