前回までで、外部のデータを取得して表示し、通信の失敗にも備えられるようになった。
ところで、実務の一覧画面では、取得したデータをそのまま並べることは少ない。「未完了だけ見たい」「キーワードで探したい」「新しい順に並べたい」といった加工が、ほぼ必ず求められる。今回から3回に分けて、取得したデータの加工方法を扱う。初回は、配列から条件に合うものだけを取り出すfilterで、タスクの状態による絞り込みを作ってみよう。
filterとは
filter()は、配列の要素を1つずつ条件に照らし、trueになったものだけを集めた新しい配列を返すメソッドである。
const numbers = [1, 2, 3, 4, 5];
const evens = numbers.filter((n) => n % 2 === 0);
console.log(evens); // [2, 4]
console.log(numbers); // [1, 2, 3, 4, 5](元の配列はそのまま)filter()に渡している(n) => n % 2 === 0は、要素を1つ受け取ってtrueかfalseを返す関数である。このように、別の関数に渡して呼んでもらう関数を「コールバック関数」と呼ぶ。
ここで大切なのは、元の配列が変わらないことである。
ToDoリストを作ろう(2)で使ったsplice()は元の配列そのものを書き換えたが、filter()は書き換えない。
今回の作り方
取得したデータはallTodosという配列に保存しておく。絞り込みの選択を変えたときは、通信し直さず、保存したデータから画面を描き直すだけにする。通信の回数が減り、操作にもすぐ反応できる。
index.html(完成版)
前回のindex.htmlに、状態の選択欄を追加する。全体は次のとおりである
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<title>外部データを取得しよう</title>
</head>
<body>
<h1>外部のToDoデータ</h1>
<label>件数:
<select id="limit-select">
<option value="5">5件</option>
<option value="10">10件</option>
<option value="20">20件</option>
</select>
</label>
<label>状態:
<select id="status-select">
<option value="all">すべて</option>
<option value="done">完了</option>
<option value="undone">未完了</option>
</select>
</label>
<button id="reload-button">再読み込み</button>
<p id="message"></p>
<ul id="todo-list"></ul>
<script src="script.js"></script>
</body>
</html>script.js(完成版)
script.jsを、次の内容に置き換えよう。
const BASE_URL = 'https://jsonplaceholder.typicode.com/todos';
const list = document.getElementById('todo-list');
const message = document.getElementById('message');
const select = document.getElementById('limit-select');
const statusSelect = document.getElementById('status-select');
const button = document.getElementById('reload-button');
// 取得したデータを保存しておく配列(未取得・取得失敗時は null)
let allTodos = null;
// 保存したデータを絞り込んで、画面に表示する
function renderTodos() {
// データがないとき(読み込み中・取得失敗)は何もしない
if (allTodos === null) {
return;
}
list.innerHTML = '';
const status = statusSelect.value;
const visibleTodos = allTodos.filter((todo) => {
if (status === 'done') {
return todo.completed;
}
if (status === 'undone') {
return !todo.completed;
}
return true;
});
visibleTodos.forEach((todo) => {
const li = document.createElement('li');
li.textContent = (todo.completed ? '✅ ' : '⬜ ') + todo.title;
list.appendChild(li);
});
if (visibleTodos.length === 0) {
message.textContent = '該当するタスクはありません';
} else {
message.textContent = `${visibleTodos.length}件表示(全${allTodos.length}件)`;
}
}
async function loadTodos() {
allTodos = null;
message.textContent = '読み込み中...';
list.innerHTML = '';
button.disabled = true;
select.disabled = true;
try {
const response = await fetch(`${BASE_URL}?_limit=${select.value}`);
if (!response.ok) {
throw new Error(`HTTPエラー:${response.status}`);
}
allTodos = await response.json();
renderTodos();
} catch (error) {
message.textContent = `取得に失敗した(${error.message})`;
} finally {
button.disabled = false;
select.disabled = false;
}
}
select.addEventListener('change', loadTodos);
statusSelect.addEventListener('change', renderTodos);
button.addEventListener('click', loadTodos);
loadTodos();コードの解説
表示を担当するrenderTodos()を新しく作り、取得を担当するloadTodos()と役割を分けた。loadTodos()は取得したデータをallTodosに入れるだけで、表示はrenderTodos()に任せている。
renderTodos()では、選択中の状態に応じてfilter()で絞り込んでいる。コールバック関数の中で、「完了」ならtodo.completedがtrueのもの、「未完了」ならfalseのものを残し、「すべて」なら全部を残す。絞り込みの結果はvisibleTodosに入り、画面にはこれを表示している。元のallTodosは変わらないため、「すべて」に戻せば全件が表示される。
状態の選択欄はchangeイベントでrenderTodos()を呼んでいる。ここではfetchを使わないので、通信は発生しない。
該当するタスクが0件のときは、メッセージを表示している。何も出ないままだと、読み込みに失敗したのか、該当がないのかが分からないためである。
データの有無は、allTodosで区別している。取得を始めるときにnull(データなし)に戻し、成功したときだけ配列を入れる。renderTodos()は、nullのときは何もしない。そのため、取得に失敗したあとで状態の選択を変えても、エラーメッセージはそのまま残る。「取得に失敗した」状態と、「取得できたが該当が0件だった」状態(空の配列)を、混同しないための工夫である。
動作確認とまとめ
ブラウザで開き、状態の選択欄を切り替えてみよう。件数が5件のときは、完了が1件、未完了が4件と表示されるはずである。「すべて」に戻すと、全件が表示される。


今回のポイントは次のとおりである。
filter()は、条件に合う要素だけを集めた新しい配列を返す。- 元の配列は変わらないので、絞り込みを解除して元に戻せる。
- 絞り込みは、保存したデータから描き直すだけで、通信は不要にできる。
- 該当が0件のときの表示も、実務では忘れずに用意しておく。
- 「取得に失敗した」状態と「該当が0件」の状態は、
nullと空の配列で区別する。
次回は、map()でデータを画面用の要素に変換し、キーワード検索を加えて、絞り込みと組み合わせてみよう。


コメント