モジュールパス
path モジュールは、ファイルおよびディレクトリ パスを操作するためのいくつかのユーティリティ関数を提供するコア モジュールです。パスが存在するかどうか、または有効なパスであるかどうかはチェックしません。パスを処理するメソッドを提供するだけです。
path モジュールは多くのメソッドを提供します。最も一般的に使用されるのは次のとおりです。
- join(): 指定されたパス セグメントを結合し、それらを標準のパス形式に処理します。
- resolve(): 一連のパスまたはパス フラグメントを絶対パスに解決します。
- basename(): パス内のパスの最後の部分を返します。
- dirname(): 指定されたパスのディレクトリ名を返します。
- extname(): パス内のファイルの拡張子を返します。
これらのメソッドのサンプル コードは次のとおりです。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16const path = require('path');
// connect path segments using the platform-specific separator as a delimiter,
console.log(path.join('/usr', 'local', 'bin')); // output: /usr/local/bin
// resolve a sequence of paths or path segments into an absolute path
console.log(path.resolve('/foo/bar', './baz')); // output: /foo/bar/baz
// return the last portion of a path
console.log(path.basename('/foo/bar/baz')); // output: baz
// return the directory name of a path
console.log(path.dirname('/foo/bar/baz')); // output: /foo/bar
// return the extension of the path, from the last '.' to end of string in the last portion of the path
console.log(path.extname('/foo/bar/baz.txt')); // output: .txt
上記のメソッドに加えて、パス モジュールは、パスの正規化、パス セパレータ、パス フォーマット処理などを処理するための、normalize()、delimiter、posix、win32 などの他の多くのメソッドも提供します。これらの手法は、実際の開発でもよく使われます。
path モジュールは、パスを処理するための便利なツール機能を多数提供しており、ファイルやディレクトリのパスをより便利に処理することができ、開発に不可欠なツールの 1 つです。
静的関数
normalize
パスを標準化し、パス内の親ディレクトリなどの情報を処理する
1static String path.normalize(String path);
呼び出しパラメーター:
- path: 文字列、指定された生のパス
戻り値:
- String、処理されたパスを返します
basename
パス内のファイル名を照会します。拡張子が指定されている場合、一致する拡張子は自動的にキャンセルされます
1
2static String path.basename(String path,
String ext = "");
呼び出しパラメーター:
- path: 文字列、指定されたクエリのパス
- ext: 文字列、拡張子を指定、ファイル名に修飾された拡張子がある場合、自動的に解除されます
戻り値:
- String、ファイル名を返します
extname
パス内のファイル拡張子を照会する
1static String path.extname(String path);
呼び出しパラメーター:
- path: 文字列、指定されたクエリのパス
戻り値:
- String、結果の拡張子を返します
format
オブジェクトをパスとしてフォーマットしようとします
1static String path.format(Object pathObject);
呼び出しパラメーター:
- pathObject:オブジェクト、オブジェクト
戻り値:
- String、フォーマットされたパスを返します
pathObject でサポートされているパラメーターは次のとおりです。
1
2
3
4
5
6
7{
"root": "/",
"dir": "/a/b",
"base": "c.ext",
"ext": ".ext",
"name": "c"
}
parse
パスをパス オブジェクトとして解析する
1static NObject path.parse(String path);
呼び出しパラメーター:
- path: 文字列、パス
戻り値:
- NObject、pathObject オブジェクトを返します
dirname
クエリ パスのディレクトリ パス
1static String path.dirname(String path);
呼び出しパラメーター:
- path: 文字列、指定されたクエリのパス
戻り値:
- String、結果のディレクトリへのパスを返します
fullpath
指定されたパスをフルパスに変換します
1static String path.fullpath(String path);
呼び出しパラメーター:
- path: 文字列、指定された変換へのパス
戻り値:
- String、変換のフルパスを返します
isAbsolute
指定されたパスが絶対パスかどうかを識別します
1static Boolean path.isAbsolute(String path);
呼び出しパラメーター:
- path: 識別されるパスを指定した文字列
戻り値:
- Boolean、絶対パスの場合は true を返します
join
一連のパスを 1 つのパスにマージします
1static String path.join(...ps);
呼び出しパラメーター:
- ps: ..., 1 つ以上の相対パス
戻り値:
- String、結果の新しいパスを返します
resolve
一連のパスを 1 つの絶対パスにマージする
1static String path.resolve(...ps);
呼び出しパラメーター:
- ps: ..., 1 つ以上の相対パス
戻り値:
- String、結果の新しいパスを返します
relative
_from から to までの相対パスを見つける
1
2static String path.relative(String _from,
String to);
呼び出しパラメーター:
- _from: 文字列、ソース パス
- to: 文字列、ターゲット パス
戻り値:
- String、取得した相対パスを返します
toNamespacedPath
名前空間がプレフィックスされたパスに変換します。Windows でのみ有効で、他のシステムは直接戻ります。
1static Value path.toNamespacedPath(Value path = undefined);
呼び出しパラメーター:
- path: 値、指定されたパス。
戻り値:
- Value、結果の新しいパスを返します
参照: https://msdn.microsoft.com/library/windows/desktop/aa365247(v=vs.85).aspx#namespaces
静的プロパティ
sep
文字列、現在のオペレーティング システムのパス区切り文字を照会します。posix は '/' を返し、windows は '\' を返します。
1static readonly String path.sep;
delimiter
文字列、現在のオペレーティング システムのマルチパス組み合わせ文字を照会します。posix は「:」を返し、windows は「;」を返します。
1static readonly String path.delimiter;
posix
オブジェクト、posix 実装、参照path_posix
1static readonly Object path.posix;
win32
オブジェクト、ウィンドウの実装、参照path_win32
1static readonly Object path.win32;