モジュール 基本モジュール

モジュールパス

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;