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": "", // 指定路径的目录 "root": "", // 指定路径的根目录 "base": "", // 指定路径的文件名,等同于 ${name}.${ext} "name": "", // 指定路径的主文件名 "ext": "", // 指定路径的扩展名 }

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;