Skip to content
Subscribe to RSS Find me on GitHub Follow me on Twitter

Returning Values from JavaScript Promises Using 'then'


JavaScript promises are a powerful tool for handling asynchronous operations in a more organized and readable manner. Promises allow us to write asynchronous code that looks and feels like synchronous code, making it easier to reason about and maintain.

One important aspect of promises is the ability to return values from them. Returning values from promises allows us to pass data between different parts of our code and perform further processing or operations based on that data. This can be crucial in scenarios where we need to chain multiple asynchronous operations together or handle errors in a specific way.

The 'then' method is a key feature in promises that enables us to handle the resolved value of a promise. When a promise is fulfilled, the 'then' method is called, and we can provide a callback function to process the resolved value.

In the next section, we will explore how to use the 'then' method to handle values returned from promises and how to leverage this feature for sequential processing.

Handling Values with 'then'

One of the key features of JavaScript promises is the ability to handle the values returned by the asynchronous operations. This is achieved using the then method, which allows us to specify what should happen when the promise is resolved successfully.

The then method is called on a promise and takes in two optional callbacks as arguments: onFulfilled and onRejected. The onFulfilled callback is executed when the promise is resolved successfully, while the onRejected callback is executed when the promise is rejected.

Here is the syntax for using the then method:

promise.then(onFulfilled, onRejected);

The onFulfilled callback can take a single argument, which represents the value returned by the promise. This value can be used for further processing or passed on to the next then method in the chain.

To chain multiple then methods together, you simply call the then method on the promise returned by the previous then method. This allows you to process the returned values sequentially.


By chaining multiple then methods, you can perform a series of operations on the returned values in a clean and concise manner.

In the next section, we will explore how to return values from the then callback and how to handle nested promises within then callbacks.

Returning Values from 'then'

In JavaScript promises, the then method plays a crucial role in handling the values returned by promises. It allows us to access and manipulate the resolved values of promises.

When a promise is resolved, the then method is used to specify a callback function that will be executed when the promise is fulfilled. This callback function can return a value, which will be used to resolve a new promise. This new promise can then be further handled using another then method.

For example, consider the following code snippet:

  .then(response => response.json())
  .then(data => {
    // Manipulate the data
    return =>;
  .then(names => {
    // Do something with the manipulated data
  .catch(error => {
    // Handle any errors

In this example, the fetch function returns a promise that resolves to a response object. The first then method is used to extract the JSON data from the response. The second then method then manipulates the data by mapping the name property of each item. The manipulated data is then passed to the third then method, where it can be further processed or used for any other purpose.

By returning a value from the then callback, we can pass the transformed data to the next then method in the chain. This allows for sequential processing and manipulation of promise values.

To access the returned value from a then method, we can simply specify a callback function as the argument to the next then method. This function will receive the resolved value as its argument. In the example above, the last then method receives the manipulated data as the names parameter.

In conclusion, the then method is essential for handling and manipulating the resolved values of promises. By returning values from then callbacks and using subsequent then methods, we can create a chain of actions that operate on the resolved values in a sequential manner.

Resolving Nested Promises

Promises in JavaScript can often be nested within 'then' callbacks, allowing for more complex asynchronous operations to be handled. This allows us to handle multiple promises in a sequential manner or even simultaneously using 'Promise.all'.

When dealing with nested promises, we can use the 'then' method to handle the resolution of each promise. By chaining 'then' methods together, we can ensure that each promise is resolved in the desired order.

To handle nested promises within 'then' callbacks, we simply return the promise from the 'then' callback and chain another 'then' method to handle its resolution. This allows us to nest promises in a way that ensures proper sequencing of asynchronous operations.

For example, consider the following code snippet:

  .then(user => {
    return getUserPosts(;
  .then(posts => {
    // Do something with the user's posts
  .catch(error => {
    // Handle any errors that occurred during the promise chain

In this example, the 'getUser' function returns a promise that resolves to a user object. We then use the 'then' method to chain another promise, 'getUserPosts', passing the user's id as a parameter. This allows us to retrieve the user's posts and perform further operations on them.

Another approach to handling multiple promises simultaneously is by using the 'Promise.all' method. 'Promise.all' takes an array of promises as input and returns a new promise that resolves when all the input promises have resolved. The resolved values of the input promises are accessible in the 'then' callback.

Here is an example that demonstrates the usage of 'Promise.all':

const promise1 = fetchDataFromAPI();
const promise2 = fetchDataFromDatabase();
const promise3 = fetchDataFromFile();

Promise.all([promise1, promise2, promise3])
  .then(data => {
    // Access the resolved values of the promises
    const [apiData, dbData, fileData] = data;
    // Perform operations with the resolved values
  .catch(error => {
    // Handle any errors that occurred during the promise chain

In this example, we have three promises, 'promise1', 'promise2', and 'promise3', representing data fetched from different sources. We pass these promises as an array to 'Promise.all', and the 'then' callback will be executed when all promises have resolved. The resolved values of the promises are accessible in the 'data' array, allowing us to perform further operations with the retrieved data.

Resolving nested promises and handling multiple promises simultaneously using 'then' and 'Promise.all' provides us with powerful tools for managing complex asynchronous operations in JavaScript. By understanding these concepts, we can write more efficient and organized code when working with promises.

Error Handling

One of the key benefits of using promises in JavaScript is the ability to handle errors effectively. The 'then' method provides a convenient way to handle errors within promise chains.

When an error occurs within a 'then' callback, it can be caught and handled using the 'catch' method. The 'catch' method is attached to the end of a promise chain and will be triggered if any error occurs in the previous 'then' callback or any of the preceding promises.

Here is an example of how to handle errors within 'then' callbacks using the 'catch' method:

  .then(response => {
    // Process the response data
    return response.json();
  .then(data => {
    // Use the processed data
  .catch(error => {
    // Handle any errors that occurred in the previous 'then' callback or any preceding promises

In this example, if an error occurs while processing the response data or any preceding promise rejects, the error will be caught by the 'catch' method. The error object will be passed as an argument to the 'catch' callback, allowing you to handle the error appropriately.

In addition to handling errors, it is also possible to return error values from promises. This can be useful in situations where you want to propagate an error value through the promise chain. By convention, error values are typically instances of the Error class or its subclasses.

Here is an example of how to return an error value from a promise:

function fetchData() {
  return new Promise((resolve, reject) => {
    // Simulate an error
    setTimeout(() => {
      reject(new Error('Failed to fetch data'));
    }, 1000);

  .then(data => {
    // This will not be executed in case of an error
  .catch(error => {
    // Handle the error and propagate it if needed
    throw error; // Propagate the error to the next 'catch' callback
  .catch(error => {
    // Handle the propagated error
    console.error('Propagated error:', error);

In this example, the 'fetchData' function returns a promise that rejects after a 1-second delay, simulating a failed data fetch. The error is caught and logged in the first 'catch' callback. If needed, the error can be propagated to the next 'catch' callback by throwing it.

Handling errors and returning error values from promises is crucial for building robust and reliable applications. By effectively handling errors, you can gracefully recover from failures and provide meaningful feedback to users.


In this article, we have explored the concept of returning values from JavaScript promises using the 'then' method. We have seen how returning values from promises is crucial for handling asynchronous operations and passing data between promise chains.

The 'then' method plays a vital role in handling values returned from successful promises. By chaining multiple 'then' methods, we can process data sequentially and perform various operations on the returned values.

We have also discussed how 'then' resolves to a new promise, allowing us to access the returned value using another 'then' function. This enables us to handle nested promises and resolve multiple promises in a sequential manner.

Error handling is an essential aspect of promises, and we have seen how to handle errors within 'then' callbacks. The 'catch' method provides a way to handle promise rejections and return error values from promises.

In summary, returning values from promises using the 'then' method is fundamental for working with asynchronous operations in JavaScript. It allows us to process data, handle errors, and pass values between promise chains. By understanding and effectively using the 'then' method, we can write more robust and efficient code.

Remember to always prioritize error handling in promises to ensure the stability and reliability of your applications.

Thank you for reading! If you want to learn more about JavaScript promises, check out the additional resources below.


  • Links to additional resources on JavaScript promises
  • Mention of other related blog posts or tutorials
  • Concluding thoughts and call to action


Here are some additional resources on JavaScript promises:

These resources provide in-depth explanations, examples, and tutorials on working with JavaScript promises. Reading and practicing with these resources will help you further enhance your understanding of promises and their usage in JavaScript.

Remember, promises are an essential part of asynchronous programming in JavaScript. By mastering promises, you can write cleaner and more maintainable code that handles asynchronous operations effectively. So, keep learning, practicing, and exploring the power of promises in your JavaScript projects!