This page is a work in progress.You can help improve it. →

Fetching Data From Remote Servers

The Fetch API provides an interface for fetching resources, primarily across the network.


The fetch() method takes one mandatory argument, the path to the resource you want to fetch. It returns a Promise that resolves to the Response to that request, whether it is successful or not. You can also optionally pass in an object as the second argument which will also give options on how fetch behaves.

  • This will access the Countries and fetch a list of all countries.

  • But if we just log this response we will see something that we cannot directly use

let response = fetch('')
Promise {<pending>}
__proto__: Promise
[[PromiseStatus]]: "pending"
[[PromiseValue]]: undefined
  • We cannot use this promise directly, we must "resolve" the promise
  • Think of a promise as an IOU
  • A promise is an asynchronous IOU that will supply a function when the IOU is ready to redeem.
  • To cash-in on our IOU we call the then method of the promise as such:
fetch('').then(response => {
  • The response here is still not quite usable:
Response {type: "cors", url: "", redirected: true, status: 200, ok: true, …}
body: (...)
bodyUsed: false
headers: Headers {}
ok: true
redirected: true
status: 200
statusText: ""
type: "cors"
url: ""
  • This is because the response body itself must be converted into a form we can use.
  • Fortunately, the response object gives us a method to gain access to the JSON:
.then(response => {
return response.json()
.then(json => {
  • This returns usable information!
{ name: 'Afghanistan', alpha2Code: 'AF', alpha3Code: 'AFG' },
{ name: 'Åland Islands', alpha2Code: 'AX', alpha3Code: 'ALA' },
{ name: 'Albania', alpha2Code: 'AL', alpha3Code: 'ALB' },
{ name: 'Algeria', alpha2Code: 'DZ', alpha3Code: 'DZA' },
{ name: 'American Samoa', alpha2Code: 'AS', alpha3Code: 'ASM' },

Improving the use of fetch

Promises can often be challenging to use and JavaScript has implemented a way to make asynchronous calls into synchronous calls. Similar to C#'s async / await system we can add await to a call that returns a promise. For any function that has done so we have to mark the method as async.

So our fetch call above becomes:

async function countries() {
const response = await fetch('')
if (response.ok) {
const json = await response.json()

Making a POST request

Making a POST request will require us to supply a second argument containing options. The first required option is the method. We may also need to supply headers such as the content-type and perhaps some authentication information such as an API key or a token. Finally if the request requires a body, we specify it in the correct format. Here we take a JavaScript object and turn it into JSON format.

async function createOneListItem() {
const response = await fetch(
// URL
// Options
// This is a POST request
method: 'POST',
// We are sending JSON
headers: { 'content-type': 'application/json' },
// The body of the message is the object, but turned into a string in JSON format
body: JSON.stringify({
item: { text: 'Learn about Regular Expressions!' },
if (response.ok) {
// Process the response
const json = response.json()


The HTTP verbs will work similarly to the POST

© 2017 - 2021; Built with ♥ in St. Petersburg, Florida.