モジュールパス

path モジュールは、ファイルおよびディレクトリ パスを操作するためのいくつかのユーティリティ関数を提供するコア モジュールです。パスが存在するかどうか、または有効なパスであるかどうかはチェックしません。パスを処理するメソッドを提供するだけです。

path モジュールは多くのメソッドを提供します。最も一般的に使用されるのは次のとおりです。

• join(): 指定されたパス セグメントを結合し、それらを標準のパス形式に処理します。
• resolve(): 一連のパスまたはパス フラグメントを絶対パスに解決します。
• basename(): パス内のパスの最後の部分を返します。
• dirname(): 指定されたパスのディレクトリ名を返します。
• extname(): パス内のファイルの拡張子を返します。

これらのメソッドのサンプル コードは次のとおりです。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
const 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

パスを標準化し、パス内の親ディレクトリなどの情報を処理する

1
static String path.normalize(String path);

呼び出しパラメーター:

• path: 文字列、指定された生のパス

戻り値:

• String、処理されたパスを返します

---

basename

パス内のファイル名を照会します。拡張子が指定されている場合、一致する拡張子は自動的にキャンセルされます

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

呼び出しパラメーター:

• path: 文字列、指定されたクエリのパス
• ext: 文字列、拡張子を指定、ファイル名に修飾された拡張子がある場合、自動的に解除されます

戻り値:

• String、ファイル名を返します

---

extname

パス内のファイル拡張子を照会する

1
static String path.extname(String path);

呼び出しパラメーター:

• path: 文字列、指定されたクエリのパス

戻り値:

• String、結果の拡張子を返します

---

format

オブジェクトをパスとしてフォーマットしようとします

1
static 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

パスをパス オブジェクトとして解析する

1
static NObject path.parse(String path);

呼び出しパラメーター:

• path: 文字列、パス

戻り値:

• NObject、pathObject オブジェクトを返します

---

dirname

クエリ パスのディレクトリ パス

1
static String path.dirname(String path);

呼び出しパラメーター:

• path: 文字列、指定されたクエリのパス

戻り値:

• String、結果のディレクトリへのパスを返します

---

fullpath

指定されたパスをフルパスに変換します

1
static String path.fullpath(String path);

呼び出しパラメーター:

• path: 文字列、指定された変換へのパス

戻り値:

• String、変換のフルパスを返します

---

isAbsolute

指定されたパスが絶対パスかどうかを識別します

1
static Boolean path.isAbsolute(String path);

呼び出しパラメーター:

• path: 識別されるパスを指定した文字列

戻り値:

• Boolean、絶対パスの場合は true を返します

---

join

一連のパスを 1 つのパスにマージします

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

呼び出しパラメーター:

• ps: ..., 1 つ以上の相対パス

戻り値:

• String、結果の新しいパスを返します

---

resolve

一連のパスを 1 つの絶対パスにマージする

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

呼び出しパラメーター:

• ps: ..., 1 つ以上の相対パス

戻り値:

• String、結果の新しいパスを返します

---

relative

_from から to までの相対パスを見つける

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

呼び出しパラメーター:

• _from: 文字列、ソース パス
• to: 文字列、ターゲット パス

戻り値:

• String、取得した相対パスを返します

---

toNamespacedPath

名前空間がプレフィックスされたパスに変換します。Windows でのみ有効で、他のシステムは直接戻ります。

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

呼び出しパラメーター:

• path: 値、指定されたパス。

戻り値:

• Value、結果の新しいパスを返します

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

静的プロパティ

sep

文字列、現在のオペレーティング システムのパス区切り文字を照会します。posix は '/' を返し、windows は '\' を返します。

1
static readonly String path.sep;

---

delimiter

文字列、現在のオペレーティング システムのマルチパス組み合わせ文字を照会します。posix は「:」を返し、windows は「;」を返します。

1
static readonly String path.delimiter;

---

posix

オブジェクト、posix 実装、参照path_posix

1
static readonly Object path.posix;

---

win32

オブジェクト、ウィンドウの実装、参照path_win32

1
static readonly Object path.win32;