目次

1. はじめに
2. プロジェクトのセットアップ
3. サーバー
4. ウォッチャー
5. 斷片をまとめる
6. 參考文獻(xiàn)

ソースコードはここで見つけることができます: https://github.com/aelassas/watcher

導(dǎo)入

Node.js アプリケーションで作業(yè)する場(chǎng)合、変更を加えた後にサーバーを再起動(dòng)する必要があることがよくあります。そうですね、ソース コードに変更を加えるたびにサーバーを手動(dòng)で再起動(dòng)しなければならないとしたら、面倒です。ありがたいことに、変更が検出されたときにサーバーを自動(dòng)的に再起動(dòng)できるユーティリティがいくつかあります。そして最も有名なのはノデーモンです。 nodemon は、ディレクトリ內(nèi)のファイルの変更が検出されたときにノード アプリケーションを自動(dòng)的に再起動(dòng)することで、Node.js ベースのアプリケーションの開発を支援するツールです。このヒントの目的は、車輪の再発明ではなく、Node.js アプリケーションの変更を監(jiān)視し、わずか數(shù)行のコードでサーバーを自動(dòng)的に再起動(dòng)する獨(dú)自のユーティリティを作成する方法を示すことです。

プロジェクトのセットアップ

最初のステップは、Node.js プロジェクトを初期化することです:

npm init

次に、モジュールを type: として設(shè)定して ES6 のサポートを追加するために、package.json

を更新する必要があります。

{
  "name": "watcher",
  "type": "module",
  "version": "1.0.0",
  "author": "Akram El Assas"
}

次に、開発依存関係をインストールします。

npm i -D @types/node

• @types/node: Visual Studio Code でオートコンプリートを使用するには

サーバ

次のように、単純な Web サーバー server.js を作成します。

import { createServer } from 'http'

const PORT = 8888

createServer((_, res) => {
    res.writeHead(200, { 'Content-Type': 'text/plain' })
    res.write('Hello World!')
    res.end()
}).listen(PORT)

console.log('HTTP server is running on Port', PORT)

次に、次のコマンドを使用して、サーバーの親フォルダーとそのサブフォルダーで変更が検出されるたびにサーバーを再起動(dòng)するためにウォッチャーを作成します。

node watcher.js server.js

ウォッチャー

ウォッチャーは変更が検出されるたびにサーバーを再起動(dòng)します。

何よりもまず、コマンドライン引數(shù)を取得する必要があります。 Node.js では、process.argv を通じてコマンドライン引數(shù)にアクセスできます。 process.argv プロパティは、Node.js プロセスの起動(dòng)時(shí)に渡されたコマンドライン引數(shù)を含む配列を返します。最初の要素は execPath になります。 2 番目の要素は、実行される JavaScript ファイルへのパスになります。殘りの要素は追加のコマンドライン引數(shù)になります。

次のコマンドを?qū)g行すると:

node watcher.js server.js

process.argv は次のようになります:

[
  'C:\Program Files\nodejs\node.exe',
  'C:\dev\watcher\src\watcher.js',
  'server.js'
]

最初の要素は、Node.js 実行可能ファイルへのパスです。 2 番目の要素は、watcher.js へのパスです。そして最後の要素は server.js です。したがって、最初と 3 番目の要素を次のように宣言することでコードを開始できます。

npm init

次に、指定されたファイルを引數(shù)として使用して Node.js を起動(dòng)する子プロセスを開始する関數(shù)を作成する必要があります。この場(chǎng)合は server.js です。これを行うには、child_process モジュールの spawn メソッドを使用します。 child_process.spawn() メソッドは、引數(shù)にコマンドライン引數(shù)を指定して、指定されたコマンドを使用して新しいプロセスを生成します。 spawn メソッドを使用する利點(diǎn)は、pipe メソッドを使用して子プロセスの stdout と stderr を親プロセスにリダイレクトできることです。パイプ メソッドは、書き込み可能なストリームを読み取り可能なストリームにアタッチするために使用されます。その結(jié)果、フロー モードに切り替わり、接続された書き込み可能なストリームにすべてのデータがプッシュされます。関數(shù)のソース コードは次のようになります:

{
  "name": "watcher",
  "type": "module",
  "version": "1.0.0",
  "author": "Akram El Assas"
}

まず、指定されたファイル引數(shù)を使用して子 Node.js プロセスを生成します。次に、子プロセスの stdout と stderr をパイプメソッドを使用して親プロセスにリダイレクトします。次に、子プロセスが閉じられると、同じ終了コードで親プロセスを終了します。 process.exit() メソッドは、コードの終了ステータスと同期してプロセスを終了するように Node.js に指示します。コードが省略された場(chǎng)合、exit は成功コード 0 または process.exitCode の値 (設(shè)定されている場(chǎng)合) を使用します。 Node.js は、すべての exit イベント リスナーが呼び出されるまで終了しません。そして最後に、子プロセスを返します。

ここで、ファイルの親フォルダーとそのサブフォルダーに対する変更を検出する必要があります。そして、JavaScript ファイルに関連する変更が検出されるたびに、子プロセスを強(qiáng)制終了し、子プロセスを再度生成します。これを行うには、fs/promises モジュールの watch メソッドを使用します。 fs/promises.watch() メソッドは、ファイル名の変更を監(jiān)視する非同期イテレータを返します。ここで、ファイル名はファイルまたはディレクトリです。ファイルの親フォルダーにウォッチャーを作成します。次に、ウォッチャーを反復(fù)処理します。 node_modules フォルダーを無視し、JavaScript ファイルで変更が検出されるたびに、次のように子プロセスを強(qiáng)制終了し、再度生成します。

npm i -D @types/node

subprocess.kill() メソッドは子プロセスにシグナルを送信します。引數(shù)が指定されていない場(chǎng)合、プロセスには SIGTERM シグナルが送信されます。 SIGKILL シグナルはキャッチ、ブロック、無視できないため、子プロセスが強(qiáng)制的に停止されます。利用可能なシグナルのリストについては、signal(7) を參照してください。

それだけです!わずか數(shù)行のコードで獨(dú)自のノードモンを完成させました。

最後に重要なことですが、次のように起動(dòng)スクリプトと開発スクリプトを package.json に追加する必要があります。

import { createServer } from 'http'

const PORT = 8888

createServer((_, res) => {
    res.writeHead(200, { 'Content-Type': 'text/plain' })
    res.write('Hello World!')
    res.end()
}).listen(PORT)

console.log('HTTP server is running on Port', PORT)

アプリケーションを開始するには、次のコマンドを入力するだけです:

node watcher.js server.js

ここでアプリケーションを?qū)g行し、server.js に変更を加えると、サーバーは自動(dòng)的に再起動(dòng)されます。サーバーを手動(dòng)で停止および起動(dòng)する必要はなくなりました。

斷片をまとめる

わずか數(shù)行のコードで獨(dú)自のノードモンをセットアップしました。 watcher.js のソース コード全體は次のようになります:

npm init

これは単なる?yún)g純な例ですが、ビデオ ファイルの変更を監(jiān)視し、変更が検出されるたびに変換の子プロセス (ffmpeg) が起動(dòng)される他の狀況も想像できます。

次のような他のオプションを?qū)g裝することもできます。

• 特定のファイルまたはディレクトリを無視する
• 特定のディレクトリの監(jiān)視
• 複數(shù)のディレクトリの監(jiān)視
• 拡張機(jī)能ウォッチリストの指定
• 再起動(dòng)の遅延
• Python、Ruby、make など、Node.js 以外の実行可能ファイルの実行
• など...

參考文獻(xiàn)

• ノデモン
• child_process.spawn(コマンド[, 引數(shù)][, オプション])
• process.exit([コード])
• fsPromises.watch(ファイル名[, オプション])
• process.kill(pid[, signal])
• シグナル(7)

以上が數(shù)行のコードで獨(dú)自のノードモンを構(gòu)築の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語 Web サイトの他の関連記事を參照してください。