Contents

• Introduction
• Install
• Example
• Usage
• API
  • parseCwd

Introduction

Parses the full path to current working directory.

Validates that directory actually exists.

Install

1npm i parse-cwd

Example

1import { parseCwd } from 'parse-cwd';
2
3console.log(process.cwd()); // /path/to/cwd
4console.log(import.meta.url); // file:///path/to/cwd/foo/bar/my-file.js
5
6console.log(await parseCwd()); // /path/to/cwd
7console.log(await parseCwd(process.cwd())); // /path/to/cwd
8console.log(await parseCwd('foo/bar/my-file.js')); // /path/to/cwd/foo/bar
9console.log(await parseCwd('./foo/bar/my-file.js')); // /path/to/cwd/foo/bar
10console.log(await parseCwd(import.meta.url)); // /path/to/cwd/foo/bar
11console.log(await parseCwd(new URL(import.meta.url))); // /path/to/cwd/foo/bar
12console.log(await parseCwd({ cwd: 'foo/bar/my-file.js' })); // /path/to/cwd/foo/bar
13
14// Error - Directory not found
15await parseCwd('does/not/exist');

Usage

parse-cwd is an ESM module. That means it must be imported. To load from a CJS module, use dynamic import const { parseCwd } = await import('parse-cwd');.

API

parseCwd(cwd)

• cwd
  • file path to resolve to URL
  • Type: string or URL or null
  • optional, defaults to process.cwd()
  • Optionally wrap as an object, e.g. { cwd: '/foo/bar' }
    • Convenient for directly passing higher level options object