Get HTML Content With Javascript Fetch (Simple Example)

Welcome to a quick tutorial and example of how to get HTML content using the Javascript Fetch API. So you are wondering if fetch() can get HTML content just like XMLHttpRequest? Of course, we can.

That covers the quick basics, but read on if you need the full example!

ⓘ I have included a zip file with all the source code at the start of this tutorial, so you don’t have to copy-paste everything… Or if you just want to dive straight in.

 

 

TLDR – QUICK SLIDES

Fullscreen Mode – Click Here

 

TABLE OF CONTENTS

 

 

QUICK NOTES

If you spot a bug, feel free to comment below. I try to answer short questions too, but it is one person versus the entire world… If you need answers urgently, please check out my list of websites to get help with programming.

 

EXAMPLE CODE DOWNLOAD

Click here to download all the example source code, I have released it under the MIT license, so feel free to build on top of it or use it in your own project.

 

 

 

PART 1) THE HTML

<div id="demo"></div>
<input type="button" value="Load Content" onclick="loadContent()">

No sweat. Just a <div id="demo"> to put the loaded contents into, and a <input type="button"> to run the fetch content demo.

 

PART 2) THE JAVASCRIPT

function loadContent () {
  // (A) FETCH "DUMMY.HTML"
  fetch("2-dummy.html")
 
  // (B) RETURN THE RESULT AS TEXT
  .then(res => {
    if (res.status != 200) { throw new Error("Bad Server Response"); }
    return res.text();
  })
 
  // (C) PUT LOADED CONTENT INTO <DIV>
  .then(html => document.getElementById("demo").innerHTML = html)
 
  // (D) HANDLE ERRORS - OPTIONAL
  .catch(err => console.error(err));
}

Right, this is pretty much the “expanded version” of the introduction snippet.

1. Here, we are making a call to 2-dummy.html. It can be whatever server-side script (PHP, ASP, Python, etc… ) in your own project.
2. Take note of if (result.status != 200) { THROW ERROR }. For the uninitiated, fetch() will consider it a success as long as the server responds. That is, even when the server returns a funky 500 (internal server error), 404 (not found), or whatever else server error. We are just doing a manual 200 (OK) check here before returning the contents fetched from the server.
3. Captain Obvious, put the fetched contents in the <div>.
4. Lastly, handle any errors that may have happened. Optional, but highly recommended.

 

 

PART 3) DUMMY HTML

<p>FOO!</p>

Yep. Just dummy HTML. This can be your own server-side script that generates HTML.

 

 

RETURN AS OTHER DATA TYPES?

The sharp code ninjas should have immediately noticed return result.text(). So, does that mean fetch() is capable of dealing with other data types? The answer is yes.

• arrayBuffer()
• blob()
• formData()
• json()

 

 

FETCHING HTML FROM ANOTHER SITE?

• Please take note that there is something called “same origin policy” – By default, site-a.com can only make fetch calls to site-a.com.
• If you want to make a fetch from site-a.com to site-b.com, this is called “cross origins” (CORS for short).
• It is possible to make a CORS fetch – But only if you own both sites, or the other website is open to let your site access. See the CORS fetch link below.

 

COMPATIBILITY CHECKS

• Arrow Functions – CanIUse
• Fetch API – CanIUse

Will not have any problems on all modern browsers.

 

LINKS & REFERENCES

• Fetch API – MDN
• HTTP Response Codes – Wikipedia
• Fetch POST Form Data – Code Boxx
• Javascript Cross-Origins CORS Fetch – Code Boxx

 

INFOGRAPHIC CHEAT SHEET