Returns the user and platform specific directories.
In v1.1.2(2020.06.26), Deno Remove
Deno.dirand dirs dependency #6385
import dir from "https://deno.land/x/dir/mod.ts";
const homeDirectory = dir("home");
// or
import home_dir from "https://deno.land/x/dir/home_dir/mod.ts";
const homeDirectory = home_dir();Requires allow-env permission.
Returns null if there is no applicable directory or if any other error occurs.
Argument values: "home", "cache", "config", "data", "data_local",
"download","tmp"
Not yet implemented: "executable", "audio", "desktop", "document"
"font", "picture", "public", "template", "video"
"home"
| Platform | Value | Example |
|---|---|---|
| Linux | $HOME |
/home/justjavac |
| macOS | $HOME |
/Users/justjavac |
| Windows | $USERPROFILE |
C:\Users\justjavac |
"cache"
| Platform | Value | Example |
|---|---|---|
| Linux | $XDG_CACHE_HOME or $HOME/.cache |
/home/justjavac/.cache |
| macOS | $HOME/Library/Caches |
/Users/justjavac/Library/Caches |
| Windows | $LOCALAPPDATA |
C:\Users\justjavac\AppData\Local |
"config"
| Platform | Value | Example |
|---|---|---|
| Linux | $XDG_CONFIG_HOME or $HOME/.config |
/home/justjavac/.config |
| macOS | $HOME/Library/Preferences |
/Users/justjavac/Library/Preferences |
| Windows | $APPDATA |
C:\Users\justjavac\AppData\Roaming |
"executable"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_BIN_HOME or $XDG_DATA_HOME/../bin or $HOME/.local/bin |
/home/justjavac/.local/bin |
| macOS | - | - |
| Windows | - | - |
"data"
| Platform | Value | Example |
|---|---|---|
| Linux | $XDG_DATA_HOME or $HOME/.local/share |
/home/justjavac/.local/share |
| macOS | $HOME/Library/Application Support |
/Users/justjavac/Library/Application Support |
| Windows | $APPDATA |
C:\Users\justjavac\AppData\Roaming |
"data_local"
| Platform | Value | Example |
|---|---|---|
| Linux | $XDG_DATA_HOME or $HOME/.local/share |
/home/justjavac/.local/share |
| macOS | $HOME/Library/Application Support |
/Users/justjavac/Library/Application Support |
| Windows | $LOCALAPPDATA |
C:\Users\justjavac\AppData\Local |
"audio"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_MUSIC_DIR |
/home/justjavac/Music |
| macOS | $HOME/Music |
/Users/justjavac/Music |
| Windows | {FOLDERID_Music} |
C:\Users\justjavac\Music |
"desktop"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_DESKTOP_DIR |
/home/justjavac/Desktop |
| macOS | $HOME/Desktop |
/Users/justjavac/Desktop |
| Windows | {FOLDERID_Desktop} |
C:\Users\justjavac\Desktop |
"document"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_DOCUMENTS_DIR |
/home/justjavac/Documents |
| macOS | $HOME/Documents |
/Users/justjavac/Documents |
| Windows | {FOLDERID_Documents} |
C:\Users\justjavac\Documents |
"download"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_DOWNLOAD_DIR |
/home/justjavac/Downloads |
| macOS | $HOME/Downloads |
/Users/justjavac/Downloads |
| Windows | $USERPROFILE\Downloads |
C:\Users\justjavac\Downloads |
"font"
| Platform | Value | Example |
|---|---|---|
| Linux | $XDG_DATA_HOME/fonts or $HOME/.local/share/fonts |
/home/justjavac/.local/share/fonts |
| macOS | $HOME/Library/Fonts |
/Users/justjavac/Library/Fonts |
| Windows | – | – |
"picture"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_PICTURES_DIR |
/home/justjavac/Pictures |
| macOS | $HOME/Pictures |
/Users/justjavac/Pictures |
| Windows | {FOLDERID_Pictures} |
C:\Users\justjavac\Pictures |
"public"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_PUBLICSHARE_DIR |
/home/justjavac/Public |
| macOS | $HOME/Public |
/Users/justjavac/Public |
| Windows | {FOLDERID_Public} |
C:\Users\Public |
"template"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_TEMPLATES_DIR |
/home/justjavac/Templates |
| macOS | – | – |
| Windows | {FOLDERID_Templates} |
C:\Users\justjavac\AppData\Roaming\Microsoft\Windows\Templates |
"tmp"
| Platform | Value | Example |
|---|---|---|
| Linux | TMPDIR |
/tmp |
| macOS | TMPDIR |
/tmp |
| Windows | {TMP} |
C:\Users\justjavac\AppData\Local\Temp |
"video"
| Platform | Value | Example |
|---|---|---|
| Linux | XDG_VIDEOS_DIR |
/home/justjavac/Videos |
| macOS | $HOME/Movies |
/Users/justjavac/Movies |
| Windows | {FOLDERID_Videos} |
C:\Users\justjavac\Videos |
deno_dirs is released under the MIT License. See the bundled LICENSE file for details.