node.js readFile関数にて読み込んだ文字を使えない

Question

お世話になります。現在nodeにてファイルの読み込みの勉強をしています。

ファイルを読み込むにはreadFile関数が使えるということなので利用し始めましたが、なかなか自分のしたいことができません。
やりたいことは、簡単なテキストファイルの内容を変数に代入し、その変数の内容をreadFile関数ののあとに使っていきたいと考えています。

コードは以下の通りです。

const fs = require("fs");

var text = "";

fs.readFile('test.txt', (err, data) => {
    if (err) throw err;
    // console.log(data.toString());
    text = data.toString();
    // console.log(text);
});

console.log(text);

私の予想していた結果は、一番下の行のconsole.logで代入された文字列が変数textに代入されているはずなので、それが表示されると考えていました。
ですが、実際は何も表示されていません。これはなぜでしょうか。かれこれこれに５時間程使っています。どなたかご教授願いします。

Answer 1

NOTE:
コメントでの指摘に従い, 同期・非同期についての解説を追加.

---

readFileメソッドに文字コードに関わるパラメータを渡していないため, 文字列ではなくバイナリ列が返されています. 下記のように文字コードを渡して下さい.
なお, readFileメソッドは非同期に実行される(ファイルの読込結果を直接返すわけでない)点に注意して下さい.

const fs = require("fs");
let text;
fs.readFile('test.txt', "utf-8",(err, data) => {
  if (err) throw err;
  console.log(data);
  text = data;
});//←この記述はファイルの読み込みを予約し, 読み込みが完了したら何をするかを設定しているだけ
console.log(text);//←そのため, 読み込みの完了前に変数にアクセスしても何も起こりません.

https://nodejs.org/api/fs.html#fs_fs_readfile_path_options_callback

同期的にファイルを読み込む(ファイルの読み込み処理を呼び出したら即その内容を取得する)場合はreadFileメソッドの代わりにreadFileSyncを使って下さい.

const fs = require("fs");
const text = fs.readFileSync('drop.htm', "utf-8");
console.log(text);

https://nodejs.org/api/fs.html#fs_fs_readfilesync_path_options

Comments

[HayatoKamono]

質問者さんはたぶん、readFileメソッドが非同期実行されるものと知らないのか、非同期処理がどういうものか分かっておらず、最後の行で値を確認出来ることを期待しているのに何も表示されないと言ってるのだと思われます。

[defghi1977]

ご指摘ありがとうございます

[sponge]

私もおそらくそうだとは、うすうす気づいてはいました。
しかし、どれだけ待っても表示されないので、なにか根本的に間違っていたのか心配になったので、質問しました。
無知で申し訳ありませんが、私が書いたコードは非同期のコードとしては普通動作するのでしょうか？それとも動かないコードを書いているのでしょうか。
どうかよろしくおねがいします。

[sponge]

上記に質問しましたが、defghi1977様の解説で完璧に理解しました！！！！
とても単純なことでため息をついています。
本当にありがとうございました！

[miyabi-sun]

処理が多くなるとどんどんネストが深くなって読みづらくなりますので、
Node.js特有のコールバック地獄を処理するテクニカルなコードが必要になります。

同期的にファイルを読み込むfs.readFileSync(path[, options])というメソッドも存在しますよ。
これなら戻り値がファイルの中身になるのでとても分かりやすいしシンプルです。
（同期、つまりファイルの読み込みが終わるまでNode.js全体が待ちぼうけてしまうので速度を求められるシステムでは嫌われますけどね）

普段使いはfs.readFileSyncを使って行くと分かりやすいと思いますよ。
https://nodejs.org/api/fs.html