Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/justjavac/deno_document_dir

Returns the path to the user's document directory.
https://github.com/justjavac/deno_document_dir

deno deno-module deno-starter dir document path

Last synced: 4 days ago
JSON representation

Returns the path to the user's document directory.

Awesome Lists containing this project

README

        

# deno_document_dir

Returns the path to the user's document directory.

The returned value depends on the operating system and is either a string,
containing a value from the following table, or `null`.

| Platform | Value | Example |
| -------- | ------------------------ | ---------------------------- |
| Linux | `XDG_DOCUMENTS_DIR` | /home/justjavac/Documents |
| macOS | `$HOME`/Documents | /Users/justjavac/Documents |
| Windows | `$USERPROFILE`/Documents | C:\Users\justjavac\Documents |

## Usage

Requires `allow-env` permission.

Returns `null` if there is no applicable directory or if any other error occurs.

```ts
import documentDir from "https://deno.land/x/document_dir/mod.ts";

documentDir();
// Lin: "/home/justjavac/Documents"
// Mac: "/Users/justjavac/Documents"
// Win: "C:\Users\justjavac\Documents"
```

## License

[deno_document_dir](https://github.com/justjavac/deno_document_dir) is released
under the MIT License. See the bundled [LICENSE](./LICENSE) file for details.