import { dir } from "https://dotland.deno.dev/x/wmill@v1.364.1/deps.ts";
Returns the user and platform specific directories.
import { dir } from "https://deno.land/x/dir/mod.ts";
const homeDirectory = dir("home");
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"
,
"home"
Platform | Value | Example |
---|---|---|
Linux | $HOME |
/home/justjavac |
macOS | $HOME |
/Users/justjavac |
Windows | {FOLDERID_Profile} |
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 | {FOLDERID_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 | {FOLDERID_RoamingAppData} |
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 | {FOLDERID_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 |