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

モジュールfs

ファイルシステム処理モジュール

指示:

1
var fs = require('fs');

いくつかの注意:

  • fs.watch(filename)を実行すると、 fs.watch(filename)から継承されたウォッチャーが返されEventEmitter 。これは、「change」、「changeonly」、および「renameonly」の3つのイベントをサポートします。
  • fs.watchFile(target)fs.unwatchFile(target)は引き続きペアで使用できます
  • fs.watchFile(target)返されますStatsWatcherから継承されたオブジェクトEventEmitter呼び出して、 fs.unwatchFile(target)呼び出すのと同じStatsWatcher.close()

静的機能

exists

指定されたファイルまたはディレクトリが存在するかどうかを照会します

1
static Boolean fs.exists(String path) async;

呼び出しパラメーター:

  • path :文字列、照会するパスを指定します

戻り結果:

  • Boolean 、Trueを返し、ファイルまたはディレクトリが存在することを示します

access

指定されたファイルに対するユーザーの権限を照会します

1 2
static fs.access(String path, Integer mode = 0) async;

呼び出しパラメーター:

  • path :文字列、照会するパスを指定します
  • mode :整数、クエリ権限を指定します。デフォルトはファイルが存在するかどうかです

ハードリンクファイルを作成します。この方法はWindowsではサポートされていません

1 2
static fs.link(String oldPath, String newPath) async;

呼び出しパラメーター:

  • oldPath :文字列、ソースファイル
  • newPath :文字列、作成するファイル

指定したファイルを削除します

1
static fs.unlink(String path) async;

呼び出しパラメーター:

  • path :文字列、削除するパスを指定します

mkdir

ディレクトリを作成する

1 2
static fs.mkdir(String path, Integer mode = 0777) async;

呼び出しパラメーター:

  • path :文字列、作成するディレクトリの名前を指定します
  • mode :整数、ファイルのアクセス許可を指定します。Windowsはこのパラメーターを無視します

rmdir

ディレクトリを削除する

1
static fs.rmdir(String path) async;

呼び出しパラメーター:

  • path :文字列、削除するディレクトリの名前を指定します

rename

ファイルの名前を変更する

1 2
static fs.rename(String from, String to) async;

呼び出しパラメーター:

  • from :文字列、名前を変更したファイルを指定します
  • to :文字列、変更する新しいファイル名を指定します

copy

ファイルをコピーする

1 2
static fs.copy(String from, String to) async;

呼び出しパラメーター:

  • from :文字列、名前を変更したファイルを指定します
  • to :文字列、変更する新しいファイル名を指定します

chmod

指定されたファイルのアクセス許可を設定します。Windowsはこの方法をサポートしていません

1 2
static fs.chmod(String path, Integer mode) async;

呼び出しパラメーター:

  • path :文字列、操作ファイルを指定します
  • mode :整数、設定されたアクセス権限を指定します

lchmod

指定したファイルのアクセス権を設定します。ファイルがソフトリンクの場合、ファイルへのアクセス権は変更されません。macOSおよびBSDシリーズプラットフォームでのみ使用できます。

1 2
static fs.lchmod(String path, Integer mode) async;

呼び出しパラメーター:

  • path :文字列、操作ファイルを指定します
  • mode :整数、設定されたアクセス権限を指定します

chown

指定されたファイルの所有者を設定します。Windowsはこの方法をサポートしていません

1 2 3
static fs.chown(String path, Integer uid, Integer gid) async;

呼び出しパラメーター:

  • path :文字列、設定ファイルを指定します
  • uid :整数、ファイル所有者のユーザーID
  • gid :整数、ファイル所有者グループID

lchown

指定されたファイルの所有者を設定します。指定されたファイルがソフトリンクの場合、指定されたファイルの所有者は変更されません。Windowsはこの方法をサポートしていません。

1 2 3
static fs.lchown(String path, Integer uid, Integer gid) async;

呼び出しパラメーター:

  • path :文字列、設定ファイルを指定します
  • uid :整数、ファイル所有者のユーザーID
  • gid :整数、ファイル所有者グループID

stat

指定されたファイルの基本情報を照会します

1
static Stat fs.stat(String path) async;

呼び出しパラメーター:

  • path :文字列、クエリするファイルを指定します

戻り結果:

  • Stat 、ファイルの基本情報を返します

lstat

statとは異なり、指定されたファイルの基本情報を照会します。 pathがソフトリンクの場合、返される情報は、指定されたファイルの情報ではなく、ソフトリンクの情報になります。

1
static Stat fs.lstat(String path) async;

呼び出しパラメーター:

  • path :文字列、クエリするファイルを指定します

戻り結果:

  • Stat 、ファイルの基本情報を返します

指定されたソフト接続ファイルを読み取ります。この方法はWindowsではサポートされていません

1
static String fs.readlink(String path) async;

呼び出しパラメーター:

  • path :文字列、読み取るソフト接続ファイルを指定します

戻り結果:

  • String 、ソフトリンクが指すファイル名を返します

realpath

指定されたパスの絶対パスを返します。指定されたパスに相対パスが含まれている場合は、それも展開されます

1
static String fs.realpath(String path) async;

呼び出しパラメーター:

  • path :文字列、読み取るパスを指定します

戻り結果:

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

ソフト接続ファイルを作成する

1 2 3
static fs.symlink(String target, String linkpath, String type = "file") async;

呼び出しパラメーター:

  • target :文字列、ターゲットファイル。ファイル、ディレクトリ、または存在しないパスの場合があります。
  • linkpath :文字列、作成されるソフトリンクファイル
  • type :文字列、作成されたソフト接続のタイプ、オプションのタイプは「file」、「dir」、「junction」、デフォルトは「file」、このパラメーターはWindowsでのみ有効で、「junction」の場合に作成されます。ターゲットパスのリンクパスは絶対パスである必要があり、ターゲットは自動的に絶対パスに変換されます。

truncate

ファイルサイズを変更します。指定した長さがソースファイルのサイズより大きい場合は、「\ 0」で入力します。そうしないと、より多くのファイルコンテンツが失われます。

1 2
static fs.truncate(String path, Integer len) async;

呼び出しパラメーター:

  • path :文字列、変更されたファイルのパスを指定します
  • len :整数、変更されたファイルのサイズを指定します

read

ファイル記述子に従って、ファイルの内容を読み取ります

1 2 3 4 5
static Integer fs.read(Integer fd, Buffer buffer, Integer offset = 0, Integer length = 0, Integer position = -1) async;

呼び出しパラメーター:

  • fd :整数、ファイル記述子
  • bufferBuffer 、読み取り結果が書き込まれるBufferオブジェクト
  • offset :整数、 Buffer書き込みオフセット、デフォルトは0
  • length :整数、ファイルから読み取られたバイト数。デフォルトは0です。
  • position :整数、ファイル読み取り位置、デフォルトは現在のファイル位置です

戻り結果:

  • Integer 、実際に読み取られたバイト数

fchmod

ファイル記述子に応じて、ファイルモードが変更されます。 POSIXシステムでのみ有効です。

1 2
static fs.fchmod(Integer fd, Integer mode) async;

呼び出しパラメーター:

  • fd :整数、ファイル記述子
  • mode :整数、ファイルのモード

fchown

ファイル記述子によると、所有者が変更されます。 POSIXシステムでのみ有効です。

1 2 3
static fs.fchown(Integer fd, Integer uid, Integer gid) async;

呼び出しパラメーター:

  • fd :整数、ファイル記述子
  • uid :整数、ユーザーID
  • gid :整数、グループID

fdatasync

ファイル記述子に従って、データをディスクに同期します

1
static fs.fdatasync(Integer fd) async;

呼び出しパラメーター:

  • fd :整数、ファイル記述子

fsync

ファイル記述子に従って、データをディスクに同期します

1
static fs.fsync(Integer fd) async;

呼び出しパラメーター:

  • fd :整数、ファイル記述子

readdir

指定されたディレクトリのファイル情報を読み取ります

1
static NArray fs.readdir(String path) async;

呼び出しパラメーター:

  • path :文字列、照会するディレクトリを指定します

戻り結果:

  • NArrayは、ディレクトリのファイル情報配列を返します

openFile

読み取り、書き込み、または読み取りと書き込みの同時実行のためにファイルを開く

1 2
static SeekableStream fs.openFile(String fname, String flags = "r") async;

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します
  • flags :文字列、ファイルを開く方法を指定します。デフォルトは「r」、読み取り専用です

戻り結果:

  • SeekableStreamは、開いたファイルオブジェクトを返します

サポートされているパラメーターフラグのメソッドは次のとおりです。

  • 'r'は読み取り専用で、ファイルが存在しない場合はエラーがスローされます
  • 'r +'読み取りおよび書き込みモード。ファイルが存在しない場合、エラーがスローされます。
  • 「w」は書き込まれるだけで、ファイルが存在しない場合は自動的に作成され、存在する場合はクリアされます。
  • 「w +」読み取りおよび書き込みモード。ファイルが存在しない場合、ファイルは自動的に作成されます。
  • 'a'はaddメソッドのみを書き込みます。ファイルが存在しない場合、ファイルは自動的に作成されます。
  • 'a +'読み取りおよび書き込み追加メソッド。ファイルが存在しない場合、ファイルは自動的に作成されます。

open

ファイル記述子を開く

1 2 3
static Integer fs.open(String fname, String flags = "r", Integer mode = 0666) async;

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します
  • flags :文字列、ファイルを開く方法を指定します。デフォルトは「r」、読み取り専用です
  • mode :整数。ファイルを作成するときに、ファイルのモードを指定します。デフォルトは0666です。

戻り結果:

  • Integer 、開いているファイル記述子を返します

サポートされているパラメーターフラグのメソッドは次のとおりです。

  • 'r'は読み取り専用であり、ファイルが存在しない場合はエラーがスローされます。
  • 'r +'読み取りおよび書き込みモード。ファイルが存在しない場合、エラーがスローされます。
  • 「w」は書き込まれるだけで、ファイルが存在しない場合は自動的に作成され、存在する場合はクリアされます。
  • 「w +」読み取り/書き込みモード。ファイルが存在しない場合、ファイルは自動的に作成されます。
  • 'a'はaddメソッドのみを書き込みます。ファイルが存在しない場合、ファイルは自動的に作成されます。
  • 'a +'読み取りおよび書き込み追加メソッド。ファイルが存在しない場合、ファイルは自動的に作成されます。

close

ファイル記述子を閉じる

1
static fs.close(Integer fd) async;

呼び出しパラメーター:

  • fd :整数、ファイル記述子

openTextStream

読み取り、書き込み、または読み取りと書き込みの同時実行のためにテキストファイルを開きます

1 2
static BufferedStream fs.openTextStream(String fname, String flags = "r") async;

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します
  • flags :文字列、ファイルを開く方法を指定します。デフォルトは「r」、読み取り専用です

戻り結果:

  • BufferedStreamは、開いているファイルオブジェクトを返します

サポートされているパラメーターフラグのメソッドは次のとおりです。

  • 'r'は読み取り専用で、ファイルが存在しない場合はエラーがスローされます
  • 'r +'読み取りおよび書き込みモード。ファイルが存在しない場合、エラーがスローされます。
  • 「w」は書き込まれるだけで、ファイルが存在しない場合は自動的に作成され、存在する場合はクリアされます。
  • 「w +」読み取りおよび書き込みモード。ファイルが存在しない場合、ファイルは自動的に作成されます。
  • 'a'はaddメソッドのみを書き込みます。ファイルが存在しない場合、ファイルは自動的に作成されます。
  • 'a +'読み取りおよび書き込み追加メソッド。ファイルが存在しない場合、ファイルは自動的に作成されます。

readTextFile

テキストファイルを開いてコンテンツを読む

1
static String fs.readTextFile(String fname) async;

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します

戻り結果:

  • String 、ファイルのテキストコンテンツを返します

readFile

バイナリファイルを開き、コンテンツを読みます

1 2
static Variant fs.readFile(String fname, String encoding = "") async;

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します
  • encoding :文字列、デコード方法を指定します。デフォルトではデコードされません

戻り結果:

  • Variant 、ファイルのテキストコンテンツを返します

readLines

ファイルを開き、配列内のテキスト行のグループを読み取ります。行の終わりは、EOL属性の設定に基づいています。デフォルトでは、posix: "\ n"; windows: "\ r \ n"

1 2
static Array fs.readLines(String fname, Integer maxlines = -1);

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します
  • maxlines :整数、今回読み取る最大行数を指定し、デフォルトですべてのテキスト行を読み取ります

戻り結果:

  • Arrayは、読み取るデータがない場合、または接続が中断されている場合は、読み取ったテキスト行配列を返します。空の配列

writeTextFile

テキストファイルを作成してコンテンツを書き込む

1 2
static fs.writeTextFile(String fname, String txt) async;

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します
  • txt :文字列、書き込む文字列を指定します

writeFile

バイナリファイルを作成してコンテンツを書き込む

1 2
static fs.writeFile(String fname, Buffer data) async;

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します
  • dataBuffer 、書き込むバイナリデータを指定します

appendFile

バイナリファイルを作成してコンテンツを書き込む

1 2
static fs.appendFile(String fname, Buffer data) async;

呼び出しパラメーター:

  • fname :文字列、ファイル名を指定します
  • dataBuffer 、書き込むバイナリデータを指定します

setZipFS

zip仮想ファイルマッピングを設定する

1 2
static fs.setZipFS(String fname, Buffer data);

呼び出しパラメーター:

  • fname :文字列、マッピングパスを指定します
  • dataBuffer 、マップされたzipファイルデータを指定します

clearZipFS

クリアzip仮想ファイルマッピング

1
static fs.clearZipFS(String fname = "");

呼び出しパラメーター:

  • fname :文字列、マッピングパスを指定し、デフォルトですべてのキャッシュをクリアします

watch

ファイルを観察し、対応するウォッチャーオブジェクトを返します

1
static FSWatcher fs.watch(String fname);

呼び出しパラメーター:

  • fname :文字列、 fnameするファイルオブジェクトを指定します

戻り結果:


ファイルを観察し、対応するウォッチャーオブジェクトを返します

1 2
static FSWatcher fs.watch(String fname, Function callback);

呼び出しパラメーター:

  • fname :文字列、 fnameするファイルオブジェクトを指定します
  • callback :Function、 (evtType: 'change' | 'rename', filename: string) => anyファイルオブジェクトが変更されたときの処理コールバック

戻り結果:


ファイルを観察し、対応するウォッチャーオブジェクトを返します

1 2
static FSWatcher fs.watch(String fname, Object options);

呼び出しパラメーター:

  • fname :文字列、 fnameするファイルオブジェクトを指定します
  • options :オブジェクト、観測オプション
  • options.persistent :{boolean}デフォルト:ターゲットファイルがまだ監視されている限りプロセスが終了しない場合はtrue
  • options.recursive :{boolean}デフォルト:false fnameがフォルダーの場合、その下のすべてのサブディレクトリを再帰的に監視するかどうか
  • options.encoding :{enum}デフォルト: 'utf8'は、着信fnameを解析するための文字エンコーディングを指定します

戻り結果:


ファイルを観察し、対応するウォッチャーオブジェクトを返します

1 2 3
static FSWatcher fs.watch(String fname, Object options, Function callback);

呼び出しパラメーター:

  • fname :文字列、 fnameするファイルオブジェクトを指定します
  • options :オブジェクト、観測オプション
  • options.persistent :{boolean}デフォルト:ターゲットファイルがまだ監視されている限りプロセスが終了しない場合はtrue
  • options.recursive :{boolean}デフォルト:false fnameがフォルダーの場合、その下のすべてのサブディレクトリを再帰的に監視するかどうか
  • options.encoding :{enum}デフォルト: 'utf8'は、着信fnameを解析するための文字エンコーディングを指定します
  • callback(evtType: 'change' | 'rename', filename: string) => anyファイルオブジェクトが変更されたときの処理コールバック

戻り結果:


watchFile

ファイルを観察し、対応するStatsWatcherオブジェクトをStatsWatcherます

1 2
static StatsWatcher fs.watchFile(String fname, Function callback);

呼び出しパラメーター:

  • fname :文字列、 fnameするファイルオブジェクトを指定します
  • callback :Function、 (curStats: Stats, prevStats: Stats) => anyファイルオブジェクトの統計が変更されたときの処理コールバック

戻り結果:


ファイルを観察し、対応するStatsWatcherオブジェクトをStatsWatcherます

1 2 3
static StatsWatcher fs.watchFile(String fname, Object options, Function callback);

呼び出しパラメーター:

  • fname :文字列、 fnameするファイルオブジェクトを指定します
  • options :オブジェクト、観測オプション
  • options.persistent :{boolean}デフォルト:ターゲットファイルがまだ監視されている限りプロセスが終了しない場合はtrue
  • options.recursive :{boolean}デフォルト:false fnameがフォルダーの場合、その下のすべてのサブディレクトリを再帰的に監視するかどうか
  • options.encoding :{enum}デフォルト: 'utf8'は、着信fnameを解析するための文字エンコーディングを指定します
  • callback(curStats: Stats, prevStats: Stats) => anyファイルオブジェクトの統計が変更されたときの処理コールバック

戻り結果:


unwatchFile

fnameを監視するStatsWatcherからすべての監視イベントのコールバックを削除します

1
static fs.unwatchFile(String fname);

呼び出しパラメーター:

  • fname :文字列、 fnameするファイルオブジェクトを指定します

戻り結果:


fnameを監視するStatsWatcher監視イベントcallbackバックからcallbackバックcallbackバックを削除しcallback

1 2
static fs.unwatchFile(String fname, Function callback);

呼び出しパラメーター:

  • fname :文字列、 fnameするファイルオブジェクトを指定します
  • callback :関数、削除するcallback

戻り結果:

コールバックがStatsWatcher監視イベントコールバックにStatsWatcherれなくなった場合でも、エラーは報告されません。

静的プロパティ

constants

オブジェクト、fsモジュールの定数オブジェクト

1
static readonly Object fs.constants;

絶え間ない

SEEK_SET

シークモード定数、絶対位置に移動

1
const fs.SEEK_SET = 0;

SEEK_CUR

シークモード定数、現在位置の相対位置に移動

1
const fs.SEEK_CUR = 1;

SEEK_END

シークモード定数、ファイルの終わりの相対位置に移動します

1
const fs.SEEK_END = 2;