Path - @david/path



[Symbol.for("Deno.customInspect")](): string



[Symbol.for("nodejs.util.inspect.custom")](): string



ancestors(): Generator<Path>

Resolves the path getting all its ancestor directories in order.



append(data: Uint8Array,
options?: Omit<Deno.WriteFileOptions, "append">,
): Promise<this>

Appends the provided bytes to the file.



appendSync(data: Uint8Array,
options?: Omit<Deno.WriteFileOptions, "append">,
): this

Synchronously appends the provided bytes to the file.



appendText(text: string,
options?: Omit<Deno.WriteFileOptions, "append">,
): Promise<this>

Appends the provided text to the file.



appendTextSync(text: string,
options?: Omit<Deno.WriteFileOptions, "append">,
): this

Synchronously appends the provided text to the file.



basename(): string

Gets the file or directory name of the path.



chmod(mode: number): Promise<this>

Changes the permissions of the file or directory.



chmodSync(mode: number): this

Synchronously changes the permissions of the file or directory.



chown(uid: number | null,
gid: number | null,
): Promise<this>

Changes the ownership permissions of the file.



chownSync(uid: number | null,
gid: number | null,
): this

Synchronously changes the ownership permissions of the file.



components(): Generator<string>

Iterates over the components of a path.



copy(destinationPath: string
 | URL
 | Path,
options?: { overwrite?: boolean;  },
): Promise<Path>

Copies a file or directory to the provided destination.



copyFile(destinationPath: string
 | URL
 | Path): Promise<Path>

Copies the file to the specified destination path.



copyFileSync(destinationPath: string
 | URL
 | Path): Path

Copies the file to the destination path synchronously.



copyFileToDir(destinationDirPath: string
 | URL
 | Path): Promise<Path>

Copies the file to the specified directory.



copyFileToDirSync(destinationDirPath: string
 | URL
 | Path): Path

Copies the file to the specified directory synchronously.



copySync(destinationPath: string
 | URL
 | Path,
options?: { overwrite?: boolean;  },
): Path

Copies a file or directory to the provided destination synchronously.



copyToDir(destinationDirPath: string
 | URL
 | Path,
options?: { overwrite?: boolean;  },
): Promise<Path>

Copies the file or directory to the specified directory.



copyToDirSync(destinationDirPath: string
 | URL
 | Path,
options?: { overwrite?: boolean;  },
): Path

Copies the file or directory to the specified directory synchronously.



create(): Promise<FsFileWrapper>

Creates a new file or opens the existing one.



createNew(): Promise<FsFileWrapper>

Creates a file throwing if a file previously existed.



createNewSync(): FsFileWrapper

Synchronously creates a file throwing if a file previously existed.



createSync(): FsFileWrapper

Synchronously creates a new file or opens the existing one.



dirname(): string

Gets the directory path. In most cases, it is recommended to use .parent() instead since it will give you a PathRef.



emptyDir(): Promise<this>

Ensures that a directory is empty. Deletes directory contents if the directory is not empty. If the directory does not exist, it is created. The directory itself is not deleted.



emptyDirSync(): this

Synchronous version of emptyDir()



endsWith(path: Path
 | URL
 | string): boolean

Gets if the provided path ends with the specified Path, URL, or string.

This verifies based on matching the components.

assert(new Path("/a/b/c").endsWith("b/c"));
assert(!new Path("/a/b/example").endsWith("ple"));



ensureDir(): Promise<this>

Ensures that the directory exists. If the directory structure does not exist, it is created. Like mkdir -p.



ensureDirSync(): this

Synchronously ensures that the directory exists. If the directory structure does not exist, it is created. Like mkdir -p.



ensureFile(): Promise<this>

Ensures that the file exists. If the file that is requested to be created is in directories that do not exist these directories are created. If the file already exists, it is NOTMODIFIED.



ensureFileSync(): this

Synchronously ensures that the file exists. If the file that is requested to be created is in directories that do not exist these directories are created. If the file already exists, it is NOTMODIFIED.



ensureRemove(options?: Deno.RemoveOptions): Promise<this>

Removes the file or directory from the file system, but doesn't throw when the file doesn't exist.



ensureRemoveSync(options?: Deno.RemoveOptions): this

Removes the file or directory from the file system, but doesn't throw when the file doesn't exist.



equals(otherPath: Path): boolean

If this path reference is the same as another one.



exists(): Promise<boolean>

Gets if the path exists. Beware of TOCTOU issues.



existsSync(): boolean

Synchronously gets if the path exists. Beware of TOCTOU issues.



extname(): string | undefined

Returns the extension of the path with leading period or undefined if there is no extension.



isAbsolute(): boolean

Gets if this path is an absolute path.



isDirSync(): boolean

Follows symlinks and gets if this path is a directory.



isFileSync(): boolean

Follows symlinks and gets if this path is a file.



isRelative(): boolean

Gets if this path is relative.



isSymlinkSync(): boolean

Gets if this path is a symlink.



join(...pathSegments: string[]): Path

Joins the provided path segments onto this path.



linkTo(targetPath: string
 | URL
 | Path): Promise<void>

Creates a hardlink to the provided target path.



linkToSync(targetPath: string
 | URL
 | Path): void

Synchronously creates a hardlink to the provided target path.



lstat(): Promise<Deno.FileInfo | undefined>

Resolves the Deno.FileInfo of this path without following symlinks.



lstatSync(): Deno.FileInfo | undefined

Synchronously resolves the Deno.FileInfo of this path without following symlinks.



mkdir(options?: Deno.MkdirOptions): Promise<this>

Creates a directory at this path.



mkdirSync(options?: Deno.MkdirOptions): this

Synchronously creates a directory at this path.



normalize(): Path

Normalizes the path, resolving '..' and '.' segments. Note that resolving these segments does not necessarily mean that all will be eliminated. A '..' at the top-level will be preserved, and an empty path is canonically '.'.



open(options?: Deno.OpenOptions): Promise<FsFileWrapper>

Opens a file.



openSync(options?: Deno.OpenOptions): FsFileWrapper

Opens a file synchronously.



parent(): Path | undefined

Gets the parent directory or returns undefined if the parent is the root directory.



parentOrThrow(): Path

Gets the parent or throws if the current directory was the root.



pipeTo(dest: WritableStream<Uint8Array>,
options?: StreamPipeOptions,
): Promise<this>

Opens the file and pipes it to the writable stream.



readBytes(options?: Deno.ReadFileOptions): Promise<Uint8Array>

Reads the bytes from the file.



readBytesSync(): Uint8Array

Synchronously reads the bytes from the file.



readDir(): AsyncIterable<DirEntry>

Reads the entries in the directory.



readDirFilePaths(): AsyncIterable<Path>

Reads only the directory file paths, not including symlinks.



readDirFilePathsSync(): Iterable<Path>

Synchronously reads only the directory file paths, not including symlinks.



readDirSync(): Iterable<DirEntry>

Synchronously reads the entries in the directory.



readJson<T>(options?: Deno.ReadFileOptions): Promise<T>

Reads and parses the file as JSON, throwing if it doesn't exist or is not valid JSON.



readJsonSync<T>(): T

Synchronously reads and parses the file as JSON, throwing if it doesn't exist or is not valid JSON.



readMaybeBytes(options?: Deno.ReadFileOptions): Promise<Uint8Array | undefined>

Calls .readBytes(), but returns undefined if the path doesn't exist.



readMaybeBytesSync(): Uint8Array | undefined

Calls .readBytesSync(), but returns undefined if the path doesn't exist.



readMaybeJson<T>(options?: Deno.ReadFileOptions): Promise<T | undefined>

Calls .readJson(), but returns undefined if the file doesn't exist.



readMaybeJsonSync<T>(): T | undefined

Calls .readJsonSync(), but returns undefined if the file doesn't exist.



readMaybeText(options?: Deno.ReadFileOptions): Promise<string | undefined>

Calls .readText(), but returns undefined when the path doesn't exist.



readMaybeTextSync(): string | undefined

Calls .readTextSync(), but returns undefined when the path doesn't exist.



readText(options?: Deno.ReadFileOptions): Promise<string>

Reads the text from the file.



readTextSync(): string

Synchronously reads the text from the file.



realPath(): Promise<Path>

Resolves to the absolute normalized path, with symbolic links resolved.



realPathSync(): Path

Synchronously resolves to the absolute normalized path, with symbolic links resolved.



relative(to: string
 | URL
 | Path): string

Gets the relative path from this path to the specified path.



remove(options?: Deno.RemoveOptions): Promise<this>

Removes the file or directory from the file system.



removeSync(options?: Deno.RemoveOptions): this

Removes the file or directory from the file system synchronously.



rename(newPath: string
 | URL
 | Path): Promise<Path>

Moves the file or directory returning a promise that resolves to the renamed path.



renameSync(newPath: string
 | URL
 | Path): Path

Moves the file or directory returning the renamed path synchronously.



renameToDir(destinationDirPath: string
 | URL
 | Path): Promise<Path>

Moves the file or directory to the specified directory.



renameToDirSync(destinationDirPath: string
 | URL
 | Path): Path

Moves the file or directory to the specified directory synchronously.



resolve(...pathSegments: string[]): Path

Resolves this path to an absolute path along with the provided path segments.



startsWith(path: Path
 | URL
 | string): boolean

Gets if the provided path starts with the specified Path, URL, or string.

This verifies based on matching the components.

assert(new Path("/a/b/c").startsWith("/a/b"));
assert(!new Path("/example").endsWith("/exam"));



stat(): Promise<Deno.FileInfo | undefined>

Resolves the Deno.FileInfo of this path following symlinks.



statSync(): Deno.FileInfo | undefined

Synchronously resolves the Deno.FileInfo of this path following symlinks.



symlinkTo(targetPath: URL | Path,
opts: SymlinkOptions,
): Promise<void>

Creates a symlink to the provided target path.



symlinkTo(target: string,
opts?: Partial<SymlinkOptions>,
): Promise<void>

Creates a symlink at the provided path with the provided target text.



symlinkToSync(targetPath: URL | Path,
opts: SymlinkOptions,
): void

Synchronously creates a symlink to the provided target path.



symlinkToSync(target: string,
opts?: Partial<SymlinkOptions>,
): void

Synchronously creates a symlink at the provided path with the provided target text.



toFileUrl(): URL

Resolves the path and gets the file URL.



toString(): string

Gets the string representation of this path.



withBasename(basename: string): Path

Gets a new path reference with the provided file or directory name.



withExtname(ext: string): Path

Gets a new path reference with the provided extension.



write(data: Uint8Array,
options?: Deno.WriteFileOptions,
): Promise<this>

Writes out the provided bytes or text to the file.



writeJson(obj: unknown,
options?: Deno.WriteFileOptions,
): Promise<this>

Writes out the provided object as compact JSON.



writeJsonPretty(obj: unknown,
options?: Deno.WriteFileOptions,
): Promise<this>

Writes out the provided object as formatted JSON.



writeJsonPrettySync(obj: unknown,
options?: Deno.WriteFileOptions,
): this

Synchronously writes out the provided object as formatted JSON.



writeJsonSync(obj: unknown,
options?: Deno.WriteFileOptions,
): this

Synchronously writes out the provided object as compact JSON.



writeSync(data: Uint8Array,
options?: Deno.WriteFileOptions,
): this

Synchronously writes out the provided bytes or text to the file.



writeText(text: string,
options?: Deno.WriteFileOptions,
): Promise<this>

Writes the provided text to this file.



writeTextSync(text: string,
options?: Deno.WriteFileOptions,
): this

Synchronously writes the provided text to this file.

@david/path@0.2.0
Built and signed on GitHub Actions
Built and signed on GitHub Actions

New Ticket: Report package

Constructors

Methods

Static Properties

Static Methods

@david/path@0.2.0Built and signed on GitHub ActionsBuilt and signed on GitHub Actions