AsyncFunction

AsyncFunction 建構子建立一個新的 async function  物件。在 JavaScript 中,每一個非同步函數實際上是一個 AsyncFunction 物件。

注意 AsyncFunction 不是一個全域物件。 它可以以下程式碼獲得。

Object.getPrototypeOf(async function(){}).constructor

語法

new AsyncFunction([arg1[, arg2[, ...argN]],] functionBody)

參數

arg1, arg2, ... argN
Names to be used by the function as formal argument names. Each must be a string that corresponds to a valid JavaScript identifier or a list of such strings separated with a comma; for example "x", "theValue", or "a,b".
functionBody
一個字串。描述該函數定義的陳述式(statements)。

說明

async function objects created with the AsyncFunction constructor are parsed when the function is created. This is less efficient than declaring an async function with an async function expression and calling it within your code, because such functions are parsed with the rest of the code.

All arguments passed to the function are treated as the names of the identifiers of the parameters in the function to be created, in the order in which they are passed.

Note: async functions created with the AsyncFunction constructor do not create closures to their creation contexts; they are always created in the global scope. When running them, they will only be able to access their own local variables and global ones, not the ones from the scope in which the AsyncFunction constructor was called. This is different from using eval with code for an async function expression.

以函數的方式執行 AsyncFunction 建構式 (不使用 new 運算子) 和以建構子的方式執行是等效的。

屬性

AsyncFunction.length
AsyncFuction 建構子的長度為 1。
AsyncFunction.prototype
可加入屬性至所有陣列物件。

AsyncFunction 原型物件

屬性

AsyncFunction.constructor
The initial value is AsyncFunction.
AsyncFunction.prototype[@@toStringTag]
Returns "AsyncFunction".

AsyncFunction 實例

AsyncFunction 實例繼承 AsyncFunction.prototype 的屬性和方法. 和所有的建構子一樣,變更該建構子 (constructor) 的原型物件 (prototype object)將會影響所有的 AsyncFunction 實例。

範例

 AsyncFunction 建構子建立一個非同步函數

function resolveAfter2Seconds(x) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve(x);
    }, 2000);
  });
}

var AsyncFunction = Object.getPrototypeOf(async function(){}).constructor

var a = new AsyncFunction('a', 
                          'b', 
                          'return await resolveAfter2Seconds(a) + await resolveAfter2Seconds(b);');

a(10, 20).then(v => {
  console.log(v); // prints 30 after 4 seconds
});

規範

Specification Status Comment
ECMAScript Latest Draft (ECMA-262)
The definition of 'AsyncFunction object' in that specification.
Draft Initial definition in ES2017.

瀏覽器相容性

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
AsyncFunctionChrome Full support 55Edge Full support 15Firefox Full support 52IE No support NoOpera Full support 42Safari ? WebView Android Full support 55Chrome Android Full support 55Firefox Android Full support 52Opera Android Full support 42Safari iOS ? Samsung Internet Android Full support 6.0nodejs Full support 7.6.0
Full support 7.6.0
Full support 7.0.0
Disabled
Disabled From version 7.0.0: this feature is behind the --harmony runtime flag.
prototypeChrome Full support 55Edge Full support 15Firefox Full support 52IE No support NoOpera Full support 42Safari ? WebView Android Full support 55Chrome Android Full support 55Firefox Android Full support 52Opera Android Full support 42Safari iOS ? Samsung Internet Android Full support 6.0nodejs Full support 7.6.0
Full support 7.6.0
Full support 7.0.0
Disabled
Disabled From version 7.0.0: this feature is behind the --harmony runtime flag.

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
User must explicitly enable this feature.
User must explicitly enable this feature.

參見