stat

Récupère les informations d'un chemin.

Exemple

import { SF } from "@duplojs/server-utils";
import { E, type ExpectType, unwrap } from "@duplojs/utils";

const result = await SF.stat("/tmp/file.txt");
// result: SF.FileSystemLeft | Success<SF.StatInfo>

if (E.isRight(result)) {
	const fileInfo = unwrap(result);

	type check = ExpectType<
		typeof fileInfo,
		SF.StatInfo,
		"strict"
	>;
}

Syntaxe

function stat(
  path: string | URL
): Promise<FileSystemLeft | E.Success<StatInfo>>

Interface StatInfo

interface StatInfo {
  isFile: boolean;
  isDirectory: boolean;
  isSymlink: boolean;
  sizeBytes: number;
  modifiedAt: D.TheDate | null;
  accessedAt: D.TheDate | null;
  createdAt: D.TheDate | null;
  changedAt: D.TheDate | null;
  deviceId: number;
  inode: number | null;
  permissionsMode: number | null;
  hardLinkCount: number | null;
  ownerUserId: number | null;
  ownerGroupId: number | null;
  specialDeviceId: number | null;
  ioBlockSize: number | null;
  allocatedBlockCount: number | null;
  isBlockDevice: boolean | null;
  isCharacterDevice: boolean | null;
  isFifo: boolean | null;
  isSocket: boolean | null;
}

Paramètres

• path : chemin a analyser.

Valeur de retour

• E.Success<StatInfo> : informations sur le chemin (type, taille, dates, etc.).
• FileSystemLeft : si la lecture échoue.

Notes

• D.TheDate est le type de date fourni par @duplojs/utils.

Voir aussi

• exists - Vérifie qu'un chemin existe.