async/await implicitly returns promise?

by

The return value will always be a promise. If you don’t explicitly return a promise, the value you return will automatically be wrapped in a promise.

async function increment(num) {
  return num + 1;
}

// Even though you returned a number, the value is
// automatically wrapped in a promise, so we call
// `then` on it to access the returned value.
//
// Logs: 4
increment(3).then(num => console.log(num));

Same thing even if there’s no return! (Promise { undefined } is returned)

async function increment(num) {}

Same thing even if there’s an await.

function defer(callback) {
  return new Promise(function(resolve) {
    setTimeout(function() {
      resolve(callback());
    }, 1000);
  });
}

async function incrementTwice(num) {
  const numPlus1 = await defer(() => num + 1);
  return numPlus1 + 1;
}

// Logs: 5
incrementTwice(3).then(num => console.log(num));

Promises auto-unwrap, so if you do return a promise for a value from within an async function, you will receive a promise for the value (not a promise for a promise for the value).

function defer(callback) {
  return new Promise(function(resolve) {
    setTimeout(function() {
      resolve(callback());
    }, 1000);
  });
}

async function increment(num) {
  // It doesn't matter whether you put an `await` here.
  return defer(() => num + 1);
}

// Logs: 4
increment(3).then(num => console.log(num));

In my synopsis the behavior is indeed inconsistent with traditional
return statements. It appears that when you explicitly return a
non-promise value from an async function, it will force wrap it in a
promise. I don’t have a big problem with it, but it does defy normal
JS.

ES6 has functions which don’t return exactly the same value as the return. These functions are called generators.

function* foo() {
  return 'test';
}

// Logs an object.
console.log(foo());

// Logs 'test'.
console.log(foo().next().value);

More Related Contents:

  1. How to know if a function is async?
  2. Is it an anti-pattern to use async/await inside of a new Promise() constructor?
  3. Async/Await Class Constructor
  4. How can I use async/await at the top level?
  5. How to return values from async functions using async-await from function? [duplicate]
  6. Using async/await with a forEach loop
  7. How can I wait In Node.js (JavaScript)? l need to pause for a period of time
  8. Can’t throw error from within an async promise executor function
  9. SyntaxError: Unexpected token function – Async Await Nodejs
  10. Using await outside of an async function
  11. for await of VS Promise.all
  12. Using filesystem in node.js with async / await
  13. JavaScript array .reduce with async/await
  14. Why do I need to await an async function when it is not supposedly returning a Promise?
  15. How to use ES8 async/await with streams?
  16. Understanding async/await on NodeJS
  17. Will async/await block a thread node.js
  18. using async await and .then together
  19. Async / await vs then which is the best for performance?
  20. Node.js Async/Await module export
  21. Wait promise inside for loop
  22. Difference of using async / await vs promises?
  23. Transpile Async Await proposal with Babel.js?
  24. Node.js mongodb driver async/await queries
  25. Does an async function always need to be called with await?
  26. Can I set a private class field using a variable as identifier? How?
  27. ASYNC / AWAIT SyntaxError: await is only valid in async functions and the top level bodies of modules
  28. Why I got document is not defined error in puppeteer?
  29. Is it possible to inherit old-style class from ECMAScript 6 class in JavaScript?
  30. Selenium WebDriver wait till element is displayed

Leave a Comment