模組path_win32

檔案路徑處理模組

引用方法：

1
var path = require('path').win32;

靜態函數

normalize

標準化路徑，處理路徑中父目錄等訊息

1
static String path_win32.normalize(String path);

呼叫參數:

• path: String, 給定的未處理的路徑

回傳結果:

• String, 返回經過處理的路徑

---

basename

查詢路徑中的檔案名稱，若指定副檔名，則自動取消符合的副檔名

1
2
static String path_win32.basename(String path,
    String ext = "");

呼叫參數:

• path: String, 給定查詢的路徑
• ext: String, 指定副檔名，若檔案名稱中有符合條件的副檔名，將自動取消

回傳結果:

• String, 回傳檔案名稱

---

extname

查詢路徑中的檔案副檔名

1
static String path_win32.extname(String path);

呼叫參數:

• path: String, 給定查詢的路徑

回傳結果:

• String, 返回得到的擴展名

---

format

嘗試將一個物件格式化為路徑

1
static String path_win32.format(Object pathObject);

呼叫參數:

• pathObject: Object, 指定參數

回傳結果:

• String, 返回格式化後的路徑

pathObject 支援的欄位如下：

1
2
3
4
5
6
7
{
    "dir": "", // specify the directory of the path
    "root": "", // specify the root of the path
    "base": "", // specify the base of the path, it's the combination of name and ext
    "name": "", // specify the name of the path
    "ext": "", // specify the ext of the path
}

---

parse

解析路徑為路徑對象

1
static NObject path_win32.parse(String path);

呼叫參數:

• path: String, 路徑

回傳結果:

• NObject, 傳回pathObject 對象

---

dirname

查詢路徑中的目錄路徑

1
static String path_win32.dirname(String path);

呼叫參數:

• path: String, 給定查詢的路徑

回傳結果:

• String, 返回得到的目錄的路徑

---

fullpath

轉換給定路徑為全路徑

1
static String path_win32.fullpath(String path);

呼叫參數:

• path: String, 給定轉換的路徑

回傳結果:

• String, 返回轉換的全路徑

---

isAbsolute

識別給定的路徑是否為絕對路徑

1
static Boolean path_win32.isAbsolute(String path);

呼叫參數:

• path: String, 給定需要辨識的路徑

回傳結果:

• Boolean, 是絕對路徑則回傳true

---

join

合併一系列路徑成為單一路徑

1
static String path_win32.join(...ps);

呼叫參數:

• ps: ..., 一個或多個相關的路徑

回傳結果:

• String, 返回得到的新路徑

---

resolve

合併一系列路徑成為絕對路徑

1
static String path_win32.resolve(...ps);

呼叫參數:

• ps: ..., 一個或多個相關的路徑

回傳結果:

• String, 返回得到的新路徑

---

relative

求_from 到to 的相對路徑

1
2
static String path_win32.relative(String _from,
    String to);

呼叫參數:

• _from: String, 來源路徑
• to: String, 目標路徑

回傳結果:

• String, 返回得到的相對路徑

---

toNamespacedPath

轉換成namespace-prefixed 路徑。只在windows 有效，其他系統直接回傳。

1
static Value path_win32.toNamespacedPath(Value path = undefined);

呼叫參數:

• path: Value, 給定的路徑。

回傳結果:

• Value, 返回得到的新路徑

see: https://msdn.microsoft.com/library/windows/desktop/aa365247(v=vs.85).aspx#namespaces

靜態屬性

sep

String, 查詢目前作業系統的路徑分割字符，posix 回傳'/', windows 返回'\'

1
static readonly String path_win32.sep;

---

delimiter

String, 查詢目前作業系統的多路徑組合字符，posix 回傳':', windows 返回';'

1
static readonly String path_win32.delimiter;

---

posix

Object, posix 實現，參見path_posix

1
static readonly Object path_win32.posix;

---

win32

Object, windows 實現，請參考path_win32

1
static readonly Object path_win32.win32;