require('express').Router() について、関数なのかオブジェクトなのかわかりません。

Question

'use strict';
const express = require('express');
const router = express.Router();

console.log(`router: ${router}`);  // express.Router()ってなに？

router.get("/", (req, res, next) => {
	res.render("login", {user: req.user});
});

module.exports = router;

上記プログラムの４行目の
console.log(router: ${router}); // express.Router()ってなに？
の結果が、以下のように出力されます。

router: function router(req, res, next) {
    router.handle(req, res, next);
  }

これは、関数だと思うのですが、なぜ次の行で

router.get("/", (req, res, next) => {
	res.render("login", {user: req.user});
});

```というような、オブジェクトのメソッドを呼ぶようなことが、なぜできるのでしょうか？

また、最終行で
module.exports = router; 
としていますが、別のファイルからrouter関数を使えるようにしているという考え方で合っていますでしょうか？

Answer 1

関数なのかオブジェクトなのかわかりません。

express 用のミドルウェア関数でしたよ。

---

express.js は、MITライセンス のミドルウェアフレームワークですので、コードを読むのが手っ取り早いです。

npm でインストールしたファイルは node_modules フォルダにあります。（NodeJS の モジュール管理方法は参照）

現在、ルーティングエンジン（Router）は express の標準実装なので、ファイルを特定して、ソースのmodule.exports を検索すると、モジュールが公開する場所を見つけることができます。
読まれる順番は、require() にも着目。

1. /node_modules/express/index.js
2. /node_modules/express/lib/express.js

var Router = require('./router'); が読める
3. /node_modules/express/lib/router/index.js <- これ

express v4.17.1の例では、 [/node_modules/express/lib/router/index.js]L:43 にありました。

var proto = module.exports = function(options) {
  var opts = options || {};

  // express middleware function
  function router(req, res, next) {
    router.handle(req, res, next);
  }

  /* omitted */

  return router;
};

追記）コメントを受けて

ソース(express v4.17.1)を軽く追いかけてみました。

1. L136: proto.handle() が実行され、この中で req.mehod による切り分けが行われています。
2. この関数内（L243 付近）の route._handles_method(method) が怪しい。

router.get()、router.post() 等は 条件付き use() メソッド と考えて差し支えないと思います。端的に言えば、ミドルウェア登録用ユーティリティ関数ですので、実行できないと機能しないということになります（route.js L192 で実装している様子です）。

1. 要求された HTTP_METHOD
2. 要求された PATH

に合致するミドルウェア登録用配列が小分けに管理します。

router.handle() によって、管理されていたミドルウェア群の条件にあったものを選ぶ仕組みのようです。

詳細まで追いかけてませんが、イメージはこう。

[
 {method:"GET", path:"/hoga", middlewares:[/* middlewares A *./] },
 :
 {method:"GET", path:"/hogu", middlewares:[/* middlewares U *./] },
 :
 {method:"GET", path:"/hogz", middlewares:[/* middlewares Z *./] }
]

（/hogu に対して、GET要求されると、 [/* middlewares U *./] が use() されていたものとして実行するイメージ）

Comments

[TrueOgre2]

詳細な調べ方を教えて頂き、どうもありがとうございます。
[/node_modules/express/lib/router/index.js]L:43　に、該当の箇所を見つけることができました。

しかし、なぜ router.get()は実行できるのでしょうか？
getという名前の関数は、上記ファイルの中で見つけることが出来ませんでした。　お手数おかけします。　教えて頂けるとありがたいです。

[AkitoshiManabe]

同ファイルを「軽く」追いかけて、追記しました。

[TrueOgre2]

追記をして頂き、どうもありがとうございました。
私ひとりでは、到底追いかけることが出来なかったので、大変助かりました。
すごく勉強になりました。

Answer 2

オブジェクトのメソッドを呼ぶようなことが、なぜできるのでしょうか？

JavaScriptでは、関数もオブジェクトです。関数オブジェクトに別途でメソッドを定義することも可能です。

Comments

[TrueOgre2]

回答をして頂き、どうもありがとうございました。
自分で作った関数に、メソッドを追加して実行することも出来ました。
よい勉強になりました。