まくまくNode.jsノート
node-fetch モジュールを使用して HTTP 通信を行う
node-fetch モジュールは、Node.js アプリで Web ブラウザと同様の fetch 関数を扱えるようにするためのライブラリです。
これを使うと、Promise ベースの HTTP 通信を行うことができます。
2020年2月に HTTP 通信モジュールのデファクトスタンダードであった request モジュールやそれに依存する request-promise モジュールが非推奨 (deprecated) になってしまったため、代わりの HTTP 通信モジュールが必要です。
代替モジュールとしては axios なども人気があるようですが、node-fetch モジュールであれば、Web ブラウザの JavaScript から使える fetch 関数と同じ感覚で使えるため、API の使用方法を新しく学ぶ手間が省けます。
node-fetch は次のようにインストールできます。
コンパクトなモジュールなので、インストールは一瞬で終わります。
$ npm install node-fetch --save
次のサンプルコードは、node-fetch が提供する fetch 関数を使って、HTTP GET リクエストを送信する例です。
Promise に対応しているので、非同期処理を .then 〜 .catch のチェーンで簡潔に記述することができます。
const fetch = require('node-fetch');
const URL = 'https://example.com';
fetch(URL)
.then(res => {
if (!res.ok) {
// 200 系以外のレスポンスはエラーとして処理
throw new Error(`${res.status} ${res.statusText}`);
}
return res.text();
})
// これがレスポンス本文のテキスト
.then(text => console.log(text))
// エラーはここでまとめて処理
.catch(err => console.error(err));
async / await を使って、次のように同期的な処理として記述することもできます。
const fetch = require('node-fetch');
const URL = 'https://example.com';
async function main() {
try {
const res = await fetch(URL);
if (!res.ok) {
throw new Error(`${res.status} ${res.statusText}`);
}
const text = await res.text();
console.log(text);
} catch (err) {
console.error(err);
}
}
main();
