learnyounode/exercises/make_it_modular/problem.zh-tw.md

Learn You The Node.js For Much Win! An intro to Node.js via a set of self-guided workshops.

這個習題和前一個習題相同，不過這個習題主要是介紹 **模組（modules）** 的內容。您將需要建立兩個檔案：模組與程式本身，來解決這個習題。

撰寫一個以副檔名作為篩選條件，列出指定資料夾內檔案的程式。程式的第一個參數是目錄的路徑，第二個參數則是篩選用的副檔名。檔案列表應該要顯示在命令列上，一個檔案一列。您 **必須** 使用非同步（asynchronous）的方式讀取目錄。

您必須撰寫一個 *模組（module）* 檔案以執行大部分的工作。這個模組必須 *對外提供（export）* 一個單一的函式，這個函式可接受 *三個* 參數，分別是：目錄名稱，副檔名，以及一個 callback 函式。這個函式所用的副檔名必須和傳給您程式的副檔名相同。也就是說，請不要預先把傳遞給模組函式的副檔名轉換成正規表達式（）或在前面加上一個「.」還是其他的事情，就只要單純的把這個副檔名傳給您的模組。在模組中，您可以做任何您需要進行的處理以完成您的篩選工作。

callback 函式必須符合一般的 node(err, data) 慣例。這個慣例規定除非出現錯誤，否則傳給 callback 函式的第一個參數一定是 null ，而第二個參數是您的資料。在這個狀況中，拿到的資料將是以 Array 呈現，篩選後的檔案列表。如果您收到任何錯誤，例如來自您呼叫的 `fs.readdir()` ，這個 callback 函式必須收到只有一個錯誤的參數。

模組檔案 *絕對* 不能直接輸出任何內容到終端機，只有您的程式可以。

如果您原始的檔案收到任何錯誤，簡單的檢查這個錯誤並且把錯誤訊息顯示到終端機上。

您的模組必須遵守底下四個規範：

1. 對外提供一個單一功能，確實使用上述的參數。
2. 確實執行一次提供的 callback 函式，並給予一個錯誤，或是上述的資料。
3. 不可以修改任何其他東西，例如全域（Global）變數或是標準輸出（stdout）。
4. 處理可能發生的所有錯誤，並且把錯誤傳遞給 callback 函式。

如果確實的遵守以上的規範，您的模組就可以被其他熟知這個規範的人使用。如此一來，您的模組就可以被任何其他作過 learnyounode 的人，或是其他驗證器執行。

----------------------------------------------------------------------
## 提示

建立一個模組，包含您的目錄閱讀及篩選功能。要定義（define）出要 *對外提供（export）* 的 *單一函式（single function）* ，要把您提供的函式指派給 `module.exports` 物件，並覆寫原本的內容：

```js
module.exports = function (args) { /* ... */ }
```

或是您可以使用一個變數來命名這個函式，並把變數指派給 `module.exports` 物件。

要在您原本的程式裡使用您建立的新模組，可以用像使用 `require('fs')` 以載入 `fs` 模組的方式呼叫 `require()` 方法。唯一不同的地方是，放在此處的模組必須以「./」開頭。所以，如果您的檔案名稱是 mymodule.js ，載入模組的方法就是：

```js
const mymodule = require('./mymodule.js')
```

「.js」副檔名是選擇性加入的，您將會常常看到這個副檔名被省略

現在，模組裡的 `module.exports` 物件將會被指派到 `mymodule` 變數。因為您已經提供了一個單一功能， `mymodule` 就成了一個您可以呼叫的函式。

當然，您還是需要謹記在心，檢查錯誤並及早回應到 callback 函式裡是慣例。

```js
function bar (callback) {
  foo(function (err, data) {
    if (err) { return callback(err) } // early return

    // ... no error, continue doing cool things with `data`

    // all went well, call callback with `null` for the error argument

    callback(null, data)
  })
}
```