速報

PHPの脆弱性を修正した11月19日の更新|FPMとセッションの影響条件

CATEGORY

【JavaScript】Fetch APIでJSONデータを取得する

※本ページのリンクにはプロモーションが含まれています。

【JavaScript】Fetch APIでJSONデータを取得する

目次

本記事では、JavaScriptのFetch でデータを取得する方法をご紹介しています。

JavaScriptのFetch APIでJSONデータを取得したいんだけど、どうすればいいんだろう?

上記の疑問にお答えします。

では、解説していきます。

スポンサーリンク

Fetch APIの概要

これまで非同期通信処理を実装する場合はjQueryのAjaxを使用してきました。JavaScriptのXMLHttpRequestを使用する方法では複雑かつ長い記述になってしまうため、敬遠してた部分もあります。フロント側でjQueryを使用していなくても、非同期通信が必要な場合はのためだけにjQueryを読み込む事例もありました。(懐かしいな~)

しかし、Fetch APIの登場で、JavaScriptでも簡単に非同期通信が実装できるように!

そんな便利なFetch APIですが、難しそうだなというイメージが先行して手を出すことに躊躇している方もいらっしゃると思います。実際に触ってみるととても使いやすいAPIであることがわかっていただけるはずですので、まずは基本的なJSONデータの取得方法から試してみましょう。

Fetch APIとは

Fetch APIは、XMLHttpRequestと似たような機能を持つAPIです。非同期通信によりデータを送受信することができます。

MDNには下記のように記載されています。

Fetch API には (ネットワーク越しの通信を含む) リソース取得のためのインターフェイスが定義されています。XMLHttpRequest と似たものではありますが、より強力で柔軟な操作が可能です。 引用元:https://developer.mozilla.org/ja/docs/Web/API/Fetch_API

XMLHttpRequestと似たものですが、より柔軟に、より操作しやすくなったと認識していただければと思います。

Fetch APIの対応ブラウザ

Can I useというHTMLやJavaScriptなどの各ブラウザの対応状況を確認することができるサイトです。

実際に非同期通信に使用するfetchメソッドの対応状況を確認してみます。

最新のブラウザであれば問題なく対応しています。IEとOpera Miniは対応していないようです。Opera Miniは基本的にスルーで問題ないですが、日本で公開するサイトであればIE11を無視するわけにはいきませんね……

IE11を考慮するとfetch使えなくない?

と思った方もいらっしゃると思いますが、大丈夫です。fetchにはポリフィルが用意されています。万歳!

ポリフィルでIE11に対応できる

ポリフィルというのは、新しい機能が実装されていないブラウザでも新しい機能を使用できるようにするコードを指します。fetchメソッドにはポリフィルがありますので、古いブラウザでも機能を利用することができます。下記のサイトから取得できますので、ドキュメント内で読み込んでご利用ください。

では実際にFetch APIでJSONデータを取得してみます。

Fetch APIの使い方

Fetch APIでデータを取得する前に、fetchメソッドの基本的な使い方をご紹介します。

fetchメソッドの基本的な使い方

下記はシンプルなfetchメソッドの使用例です。urlに指定したリソースをテキスト形式で取得します。

fetch(url, options) //1
    .then(response => response.text()) //2
    .then(data => {  //3
      console.log(data);
    });

コメントに記載した番号部分の処理内容を説明します。

  1. fetchメソッドで指定されたリソース(url)の非同期通信結果をResponseオブジェクトを含むPromiseオブジェクトで返す
  2. thenメソッドでPromiseオブジェクト経由で渡されたResponseオブジェクトを処理する(上記ではtextメソッドで応答データを文字列として取得)
  3. 渡された応答データ(上記ではtextメソッドで取得した文字列)を処理する

少々複雑に思われるかもしれないですが、やっていることはとても単純です。

  1. 非同期通信開始
  2. レスポンスのデータ取り出し
  3. データをページに反映

この辺はfetchメソッドでは必ず記述することになりますので、まとめて覚えておくと良いかもしれません。

optionsにリクエストのオプションを指定することもできます。下記は指定可能なオプション一覧です。実際にfetchメソッドで処理を構築する際にオプションは入念に調べることになります。なのでここではこんなものがあるんだな~くらいに流し見てくださいね。

指定可能なオプション

method GET/POSTなどのリクエストメソッドを指定(デフォルトはGET)
headers リクエストヘッダーを指定(Headersオブジェクト参照)
body リクエスト本体を指定(FormDataやURLSearchParamsなど)
mode リクエストモードを指定(cors,、no-cors、 same-originなど)
credentials 機密情報を送信する際のルールを指定
cache キャッシュモードを指定(キャッシュモード参照)
redirect リダイレクトの処理を指定(follow、manualなど)
referrer USVStringでリクエストのリファラーを指定。同一のオリジンのURL、about:client、空文字列のいずれかを指定
referrerPolicy リファラポリシーを指定(no-referrer、same-origin、originなど)
integrity 取得するリソースのハッシュ値を指定(integrity属性)

以上がfetchメソッドの基本的な使い方です。

では実際にFetch APIでJSONデータを取得してみます。

スポンサーリンク

Fetch APIでJSONデータを取得する

といっても上記のサンプルでご紹介した内容とほぼ同じです。Responseオブジェクトからデータを取得する部分をtextメソッドからjsonメソッドに変えるだけです。それでJSONデータを取得することができます。

下記にサンプルを用意しました。実行すると、本記事に関するJSONデータを取得することができます。公開している情報ですので練習用に使用していただいても大丈夫です。

let url = 'https://into-the-program.com/wp-json/wp/v2/posts/6129';

fetch(url) .then(response => response.json()) .then(data => { console.log(data); });

以上でFetch APIでJSONデータを取得することができます。

最後に

Fetch APIのおかげでJavaScriptでも簡単に非同期通信を実装することができるようになりました。jQueryもまだまだ現役のですが、fetchメソッドを使った方法も知っておくと臨機応変に対応できます。非同期通信のライブラリとしてaxiosがありますが、そちらについてはまた別の機会にご紹介できればと思います。

以上、JavaScriptのFetch APIでJSONデータを取得する方法のご紹介でした!

この記事を書いた人

Ryohei

Webエンジニア / アプリ開発者 / 技術ブログ運営者

福岡のWeb制作会社に勤務するWebエンジニアです。10年以上にわたりWeb制作・開発に携わり、ヒアリングや進行管理から、コーディング、CMSの構築、システム開発、サーバーの構築・保守・運用まで、Webサイト制作の工程を幅広く担当しています。Webサイトは、これまでに100以上の構築・保守を手がけてきました。

個人でもWebサイトの制作・改修やWebアプリの開発・運用を行い、AIを活用した開発にも取り組んでいます。近年はWebセキュリティにも注力しています。

2015年から技術メディア「Into the Program」を運営し、実務や開発で得た知識をもとに、プログラミングの実装方法やWebサイトの運用・セキュリティ情報を発信しています。

主な分野
Webサイト構築・保守・運用 / HTML/CSS / JavaScript / PHP / WordPress / サーバー構築・保守・運用 / アプリ開発 / セキュリティ対策
資格・試験合格
情報セキュリティマネジメント試験
基本情報技術者試験
AWS認定ソリューションアーキテクト アソシエイト
PHP8技術者認定ウィザード
メディア運営
2015年〜

記事の作成・更新について

セキュリティ記事は、ベンダーの公式アドバイザリやCVE・JVNなどの一次情報を参照し、出典と情報確認日を記載します。実環境での検証を行った場合は、その環境と確認範囲を明示します。重要な追加情報や誤りを把握した場合は、内容を確認して追記・訂正します。

関連する記事

おすすめの書籍

キーワードから探す

スポンサーリンク

Ajax

ページを再読み込みせずに、JavaScriptでサーバーと通信して画面の一部を更新する手法。

詳しく見る

JSON

データを「名前と値」の組で表す、軽くて読みやすいテキストの形式。APIのデータのやりとりなどで広く使われる。

詳しく見る

API

ソフトウェアやサービスの機能を、ほかのプログラムから決まった方法で呼び出して使えるようにした窓口。

詳しく見る