Module 基礎模組

模組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;