【Node.js24.x】Object::dirname()メソッドの使い方
dirnameメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
dirnameメソッドは、指定されたパス文字列から、ファイル名や最後のディレクトリ部分を除いた、ディレクトリ名を示す文字列を抽出するメソッドです。これは、特定のファイルがどのディレクトリに属しているかを知りたい場合や、既存のディレクトリをベースとして新しいファイルのパスを構築したい場合などに非常に便利です。
このメソッドは、引数として一つのパス文字列を受け取ります。そして、そのパス文字列の最後のパスセグメント(ファイル名、またはパスの末尾にあるディレクトリ名)を取り除き、その一つ上の階層のディレクトリパスを文字列として返します。たとえば、「/home/user/documents/report.txt」というパスが与えられた場合、「/home/user/documents」という文字列を返します。また、パスの末尾にスラッシュがある場合でも、そのスラッシュは無視され、その直前のディレクトリ名が返されます。例えば、「/data/logs/」というパスからは「/data/logs」が返されます。
もし与えられたパスがルートディレクトリ(例えば、POSIX環境での「/」やWindows環境での「C:\」など)であれば、そのままルートディレクトリを示す文字列が返されます。パスにディレクトリ情報が含まれずファイル名のみが指定された場合は、カレントディレクトリを示す「.」(ピリオド)が返されることがあります。Node.jsのpathモジュールに属しており、オペレーティングシステム(Windows、Linux、macOSなど)に応じた適切なパス区切り文字を自動的に処理してくれるため、異なるOS環境でも一貫したパス操作を実現できます。これにより、システム開発において、ファイルやディレクトリのパスを安定して管理する上で重要な機能を提供します。
構文(syntax)
1console.log(__dirname);
引数(parameters)
path
- path: string: ファイルパスの文字列
戻り値(return)
string
指定されたパスのディレクトリ名を表す文字列を返します。