Course contentsShow
← JavaScript
Lesson 2256 of 2,72347. Networking PrimitivesFree lesson

The Response Object

Examining what fetch returns: a Response object wrapping HTTP response data.

The Response Object

You'll learn: What the fetch() function returns and how the Response object packages HTTP response data for you to work with.

What Is the Response Object?

When you call fetch(), the promise it returns doesn't directly give you the data from the server. Instead, it resolves to a Response object—a wrapper that contains everything about the HTTP response: status codes, headers, and methods to access the body content.

Think of it like receiving a package in the mail. The Response object is the entire package: the shipping label (headers), the tracking status (status code), and the box itself with methods to open it and retrieve what's inside (the body).

Key Properties and Methods

The Response object provides:

  • status: The HTTP status code (200, 404, 500, etc.)
  • statusText: Human-readable status ("OK", "Not Found")
  • ok: A boolean—true if status is in the 200-299 range
  • headers: A Headers object containing response headers
  • Body methods like json(), text(), blob() to extract the actual data

You don't get the response data immediately—you must call one of these body methods, which themselves return promises.

fetch('https://api.example.com/data')
  .then(response => {
    console.log(response.status); // e.g., 200
    console.log(response.ok);     // true if successful
    // The response body hasn't been read yet!
  });

Key Takeaway: The Response object wraps all HTTP response metadata and provides methods to asynchronously extract the body content—it's your gateway to understanding what the server sent back.