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;