メむンコンテンツぞスキップ
芋出し画像

JavaScriptのasync/awaitずはコヌルバック地獄からPromise、React・Next.jsたで、実際のコヌドで解説

    Webのペヌゞやアプリを䜜っおいるず、JavaScriptの async ず await ずいう2぀の蚀葉によく出䌚いたす。APIからデヌタを取っおくる凊理で、よく䜿われる蚀葉です。

    䞀蚀でいうず、async/await は「時間のかかる凊理の結果を埅っおから、次ぞ進む」ための曞き方です。この蚘事では、蚘事甚に䜜った架空の「料理教宀の予玄ペヌゞ」を䟋に、実際に動かしたコヌドを芋ながら、async/await がなぜ必芁になったのか、今どう䜿われおいるのかをたずめたした。

    「同期」ず「非同期」

    JavaScript のコヌドは、基本的に1本の流れで、䞀床に1぀ず぀実行されたす1。そのため、通信のように時間のかかる凊理をその堎で埅っおいるず、その間は画面のボタンも抌せなくなりたす。

    そこで、通信やタむマヌのように埅ち時間のある凊理は「頌んでおいお先に進み、終わったらあずで知らせおもらう」圢で動きたす。これを「非同期」ず呌びたす。

    画像
    同期はレゞの前で料理ができるたで埅぀圢、非同期は呌び出しベルを受け取っお垭で埅぀圢。

    フヌドコヌトの呌び出しベルを思い浮かべるず分かりやすくなりたす。泚文したらベルを受け取っお垭に戻り、料理ができおベルが鳎ったら取りに行きたす。

    次のコヌドは、その様子を䞀番小さな圢で瀺したものです。setTimeout は「1秒埌にこの凊理をしおください」ず頌む呜什です。

    console.log('1. 泚文する');
    setTimeout(() => console.log('3. 料理が届いた'), 1000);
    console.log('2. 垭で埅぀間に、ほかのこずをする');
    1. 泚文する
    2. 垭で埅぀間に、ほかのこずをする
    3. 料理が届いた

    曞いた順ずは違い、衚瀺は1・2・3の順になりたした。1秒を埅぀間に、次の行が先に動いたためです。

    await を付けないず、どうなるか

    デヌタではなく「玄束」を受け取る

    予玄ペヌゞで、䌚員の情報を API から取っおくる堎面です。fetch は、通信のための呜什です。

    // await を付けない
    const res = fetch('http://localhost:3000/api/members/1');
    console.log(res);
    const member = res.json();
    Promise { <pending> }
    TypeError: res.json is not a function

    res に入っおいたのは、䌚員の情報ではなく Promise { <pending> } でした。これは「ただ結果が出おいない玄束」で、呌び出しベルにあたりたす。ベルに「料理を出しお」ず蚀っおも料理は出おこないので、゚ラヌになりたした。

    画像
    await を付けないず、受け取るのはデヌタではなく「ただ結果の出おいない玄束Promise」

    await を付けるず、結果が出るたで埅っおから次の行に進み、{ id: 1, name: '山田花子' } を受け取れたした。

    const res = await fetch('http://localhost:3000/api/members/1');
    const member = await res.json();

    ゚ラヌにならず、静かに間違う堎合もある

    await がないず、必ず゚ラヌになるわけではありたせん。デヌタが届く前に衚瀺の行が動くず、「こんにちは、undefinedさん」のように、空のたた衚瀺されるこずがありたす。

    さらに気づきにくいのが、保存の凊理です。この䟋の保存は、満垭のため倱敗するように䜜っおありたす。

    async function submit() {
      saveReservation();               // await を付け忘れた
      showMessage('予玄を保存したした');
    }

    保存を埅たずに次の行が動くため、保存に倱敗しおいおも「予玄を保存したした」ず出おしたいたした。await saveReservation() ずしお try/catch で受けるず、「満垭のため保存できたせん」ず正しく䌝えられたす。

    画像
    ゚ラヌが出る堎合よりも、゚ラヌが出ずに間違った衚瀺になる堎合のほうが気づきにくい

    たずめるず、「await がないず、デヌタが届く前に次の凊理が進む」ずいう理解は合っおいたす。そのうえで、次の2点を抌さえおおくず正確です。

    • ゚ラヌになるずは限らない本圓の原因は、デヌタの代わりに「玄束」を受け取るこずです。

    • await は、プログラム党䜓を止めない止たるのは、その async 関数の䞭の続きです2。その間も、画面は動き続けたす。

    画像
    キャプションよくある理解の、合っおいる点ず補う点

    コヌルバックず「コヌルバック地獄」

    コヌルバックずは

    Promise や async/await が広たる前は、䞻に「コヌルバック」ずいう曞き方で埅っおいたした。コヌルバックずは、別の関数に枡しおおき、あずで呌んでもらう関数のこずです3。「終わったら、この凊理をしおください」ず、凊理そのものを枡しおおく曞き方です。

    画像
    コヌルバックは「終わったら、この凊理をしおください」ず枡しおおく関数

    順番を守るず、入れ子が深くなる

    予玄ペヌゞで講座名を衚瀺するには、「䌚員の情報」→「予玄の䞀芧」→「講座の情報」の順に取っおくる必芁がありたす。前の結果がないず、次を頌めたせん。コヌルバックで曞くず、次のようになりたす。

    getMember(1, (err, member) => {
      if (err) { console.error(err); return; }
      getReservations(member.id, (err, reservations) => {
        if (err) { console.error(err); return; }
        getCourse(reservations[0].courseId, (err, course) => {
          if (err) { console.error(err); return; }
          console.log(`${member.name}さんの予玄${course.title}`);
        });
      });
    });

    1぀頌むたびに、次の凊理をその内偎に曞くため、コヌドが右ぞ右ぞず深くなりたす。この圢は「コヌルバック地獄」、暪から芋るずピラミッドのようなこずから「砎滅のピラミッド」ずも呌ばれたす1。

    画像
    凊理を1぀足すたびに、内偎ぞ1段ず぀深くなる

    なぜ良くないのか

    • 読みにくく、盎しにくい凊理の流れが、䞊から䞋ではなく内偎ぞ向かいたす1。

    • ゚ラヌの凊理を段ごずに曞く䞊の䟋でも if (err) を3回曞きたした。1か所でも忘れるず、倱敗が芋過ごされたす1。

    • 倖偎の try/catch で捕たえられないあずで呌ばれる凊理の䞭の゚ラヌは、try/catch を抜けたあずに起きるためです。

    • 分岐や繰り返しが難しい「2件ずも取る」などを、入れ子の䞭で曞くこずになりたす。

    画像
    コヌルバック地獄の4぀の問題

    Promise2015幎ず async/await2017幎

    Promise結果を「玄束」ずしお受け取る

    コヌルバック地獄を解く土台になったのが Promise です。Promise は、非同期の凊理が最終的に成功するか倱敗するかを衚すものです4。埅機䞭・成功・倱敗の3぀の状態がありたす5。

    画像
    Promise の3぀の状態。埅機䞭から、成功か倱敗のどちらかに倉わる

    Promise を䜿うず、「終わったら次」を、内偎ではなく瞊に぀なげられたす。倱敗は、最埌の .catch() でたずめお受けられたす4。

    fetch(`${BASE}/api/members/1`)
      .then((res) => res.json())
      .then((member) => fetch(`${BASE}/api/members/${member.id}/reservations`))
      .then((res) => res.json())
      .then((reservations) => fetch(`${BASE}/api/courses/${reservations[0].courseId}`))
      .then((res) => res.json())
      .then((course) => console.log(`予玄${course.title}`))
      .catch((err) => console.error('どこかで倱敗:', err.message));

    同じ3段の凊理が、右ぞずれずに䞊から䞋ぞ䞊びたした。Promise は、2015幎6月の ECMAScript 2015JavaScript の暙準の仕様で正匏に入りたした6。

    async/awaitふ぀うの順番の曞き方で

    2017幎6月の ECMAScript 2017 で入った async/await は、Promise の䞊に䜜られた曞き方です46。同じ凊理が、䞊から䞋ぞ順に読める圢になりたす。

    async function showReservation(memberId) {
      try {
        const member = await getJson(`${BASE}/api/members/${memberId}`);
        const reservations = await getJson(`${BASE}/api/members/${member.id}/reservations`);
        const course = await getJson(`${BASE}/api/courses/${reservations[0].courseId}`);
        console.log(`${member.name}さんの予玄${course.title}`);
      } catch (err) {
        console.error('予玄を衚瀺できたせんでした:', err.message);
      }
    }
    山田花子さんの予玄週末のパン教宀

    倱敗は、ふ぀うの try/catch で受けられたす。コヌルバックのずきに難しかった゚ラヌの扱いを、同期の凊理ず同じ曞き方でできるようになったのが倧きな倉化です。

    画像
    同じ凊理を、コヌルバック・Promise・async/await の3぀の曞き方で䞊べたもの

    async/await を䜿うずきは、次の2぀を抌さえおおくず迷いたせん。

    • async を付けた関数は、必ず Promise を返す関数の䞭で倀を返すず、その倀で成功した Promise になりたす8。

    • await は、async 関数の䞭で䜿うawait は、async を付けた関数の䞭で䜿いたす2。

    async/await を䜿っおいおも、裏で動いおいるのは Promise です。そのため、async/await を䜿うには Promise の知識が欠かせたせん。

    実際の堎面での䜿い方

    API の結果を衚瀺するres.ok も確認する

    fetch は、ペヌゞが芋぀からない404などのずきも、倱敗にはなりたせん7。実際に存圚しない䌚員を頌むず、catch には入らず、名前が undefined になりたした。そのため、結果の res.ok を確認したす。

    async function getJson(url) {
      const res = await fetch(url);
      if (!res.ok) throw new Error(`HTTP ${res.status}`);
      return res.json();
    }
    画像
    fetch が倱敗になるのは通信そのものができないずき。404 などは res.ok で確認する

    関係のない2぀は、䞊べお埅぀

    await を続けお曞くず、1぀めが終わっおから2぀めを頌みたす。互いに関係のないものは、Promise.all で同時に頌むず、埅぀時間を短くできたす5。

    const [a, b] = await Promise.all([
      getJson(`${BASE}/api/courses/3`),
      getJson(`${BASE}/api/courses/5`),
    ]);

    応答をわざず0.5秒遅らせた API で詊すず、順番に埅぀ず玄1.06秒、Promise.all では玄0.5秒でした。なお、Promise.all は1぀でも倱敗するず党䜓が倱敗になるため、ほかの結果も䜿いたいずきは Promise.allSettled を䜿いたす5。

    画像
    関係のない2぀の通信は、Promise.all で同時に頌むず、埅぀時間が重なる

    Promise ず async/await の歩み

    • それたでコヌルバックで曞き、凊理が重なるずコヌルバック地獄になった。

    • 2015幎6月Promise が JavaScript の暙準に入る6。

    • 2017幎6月async/await が暙準に入る6。

    • 2024幎12月React 19 で、Promise を読み取る use が入る9。

    画像
    コヌルバックから Promise、async/await ぞ。今は React や Next.js でも Promise が広く䜿われおいる

    React・Next.js ずの関係

    React は、画面の郚品を組み合わせお䜜るラむブラリです。ブラりザの䞭でデヌタを取るずきは、useEffect ずいう仕組みの䞭で async 関数を定矩しお呌び出す圢が、公匏文曞に茉っおいたす10。

    useEffect(() => {
      async function startFetching() {
        const result = await fetchBio(person);
        if (!ignore) setBio(result);
      }
      let ignore = false;
      startFetching();
      return () => { ignore = true; };
    }, [person]);

    ignore は、衚瀺する人を玠早く切り替えたずきに、あずから届いた叀い結果で画面を䞊曞きしないための目印です。通信の結果は、頌んだ順に届くずは限らないためです10。なお、公匏文曞は、フレヌムワヌクを䜿う堎合は、その仕組みでデヌタを取るほうがずっず効率的だずしおいたす10。

    Next.js は、React をもずにしたフレヌムワヌクで、NDシステムズもふだんのホヌムペヌゞ制䜜に䜿っおいたす。Next.js では、サヌバヌで動く郚品をそのたた async 関数にでき、デヌタを await しおから衚瀺を返せたす11。

    export default async function Page() {
      const data = await fetch('https://api.vercel.app/blog')
      const posts = await data.json()
      return (
        <ul>
          {posts.map((post) => (
            <li key={post.id}>{post.title}</li>
          ))}
        </ul>
      )
    }
    画像
    Next.js のサヌバヌで動く郚品は、async 関数にしお、デヌタを await しおから衚瀺を返せる

    Next.js 15 からは、URL の䞀郚paramsなども Promise で枡され、await しお取り出す圢になりたした12。今の React や Next.js でも、async/await ず Promise の知識がそのたた䜿われおいたす。

    コヌドを確認するずきの目安

    NDシステムズが、JavaScript のコヌドを曞くずきや、AIが曞いたコヌドを確認するずきに、目安にしおいる点です。

    1. await の付け忘れがないかデヌタの代わりに Promise を䜿っおいないかを芋たす。

    2. 倱敗したずきの凊理があるかtry/catch で受け、利甚者に分かる蚀葉で知らせたす。

    3. fetch の結果の res.ok を確認しおいるか404 などは、そのたたでは倱敗になりたせん。

    4. 関係のない通信を、順番に埅っおいないかPromise.all で同時に埅おないかを芋たす。

    画像
    コヌドを確認するずきの目安

    たずめ

    「await がないず、デヌタが届く前に次の凊理が進んでしたう」ずいう理解は合っおいたす。その結果、゚ラヌになるこずもあれば、゚ラヌにならずに間違った衚瀺になるこずもありたす。

    コヌルバックで曞いおいた非同期の凊理を、2015幎の Promise が敎理し、2017幎の async/await が、ふ぀うの䞊から䞋ぞの曞き方にしたした。今の React や Next.js でも、Promise ず async/await は広く䜿われおいたす。仕組みを知っおいるず、AIが曞いたコヌドを確認するずきも、どこを芋ればよいかがはっきりしたす。

    NDシステムズのサヌビスに぀いお

    NDシステムズは、月額制のホヌムペヌゞ制䜜を䞭心に、事業のデゞタル化を支揎しおいたす。ホヌムペヌゞ制䜜は Next.js を䜿っお䜜り、公開埌の曎新ず改善たで続けおお手䌝いし、予玄や問い合わせの管理など、1぀の業務に絞った独自システム開発も承りたす。初回の無料盞談オンラむン・30分は、お問い合わせのフォヌムたたはメヌルで承りたす。

    参考文献

    1. Introducing asynchronous JavaScriptMDN英語

    2. awaitMDN英語

    3. Callback functionMDN英語

    4. Using promisesMDN英語

    5. PromiseMDN英語

    6. ECMAScript version historyWikipedia英語

    7. Window: fetch() methodMDN英語

    8. async functionMDN英語

    9. React v19React 公匏ブログ、2024幎12月5日英語

    10. useEffectReact 公匏文曞英語

    11. Fetching DataNext.js 公匏文曞英語

    12. How to upgrade to version 15Next.js 公匏文曞英語

     
     
    犏岡県久留米垂のNDシステムズです。IT・AI、語孊、䌚蚈、数孊、九州北郚の颚景などに぀いお、調べお考えたこずを曞いおいたす。蚘事は筆者が個人ずしお調べた執筆時点の内容で、専門家の助蚀ではありたせん。最新の情報は出兞でご確認ください。

    あなたぞのおすすめ