lstat

Get file/directory metadata without following symlinks. For the link target, use stat.

Basic usage

import { lstat } from '@vooya/fs'
 
const s = await lstat('./some-link')
console.log(s.isSymbolicLink(), s.size)

Methods

lstat(path)

Async. Returns Promise<Stats>.

Return type Stats is the same as stat; when path is a symlink, the returned stats describe the link, not the target.

lstatSync(path)

Sync. Same arguments; returns Stats or throws.

Performance

Single syscall; same order as stat. On par with Node.js (~1.2x in micro-benchmarks). See Benchmarks.

Local scale report

Generated from local performance reports. Do not edit this block by hand.

• Runtime: v22.22.0 on darwin/arm64
• Samples: 2 warmup runs, 10 measured runs
• Aggregation: trimmed mean for wall-clock time; average per-run memory delta for RSS

Notes

• Symlinks: Use lstat to detect and inspect symlinks; use stat to get the resolved file’s stats.
• Known gap: Missing-path errors currently have Node-like messages, but do not expose Node-style code, path, and syscall fields yet.
• Unsupported Node options: bigint, throwIfNoEntry, Buffer paths, and URL paths are not part of the current Vooya FS lstat surface.

Competitor measurements

See the full lstat comparison table for Node 22/24, peer libraries, sync/Promise modes, small and batch workloads, execution routes and measurement limits.