Course contentsShow
← JavaScript
Lesson 948 of 2,72321. DestructuringFree lesson

Destructuring Nested Function Return Values

Apply nested patterns directly to functions returning complex data structures like API responses.

Destructuring Nested Function Return Values

What you'll learn: How to extract specific values from complex nested data structures returned by functions—in one clean line.

The Problem: API Responses and Complex Return Values

Functions often return nested objects or arrays—think API responses with multiple layers. Instead of accessing these values with long chains of dot notation or brackets, you can destructure them directly when you call the function.

How It Works

When a function returns a nested structure, apply your destructuring pattern right at the call site:

function getUserProfile() {
  return {
    user: {
      name: 'Alice',
      address: {
        city: 'Portland',
        zip: '97201'
      }
    },
    status: 'active'
  };
}

// Destructure the nested return value directly
const { user: { name, address: { city } }, status } = getUserProfile();

console.log(name);   // "Alice"
console.log(city);   // "Portland"
console.log(status); // "active"

Why This Matters

This pattern shines when working with API responses or complex data transformations. Instead of storing the entire result and drilling down:

// Without destructuring
const result = getUserProfile();
const userName = result.user.name;
const userCity = result.user.address.city;

// With destructuring: one line, crystal clear
const { user: { name, address: { city } } } = getUserProfile();

The Analogy

Think of it like receiving a package within a package. Instead of opening the outer box, then the inner box, then pulling out what you need in separate steps—destructuring lets you specify exactly which items you want from which inner boxes, all in your shipping instructions.

Key Takeaway: Apply nested destructuring patterns directly to function calls to extract deeply nested values cleanly, especially useful for API responses and complex data structures.