add await function to execute a promise

context.go

@@ -379,3 +379,12 @@ func (ctx *Context) Exception() error {
 func (ctx *Context) Loop() {
 	C.js_std_loop(ctx.ref)
 }
+
+// Wait for a promise and execute pending jobs while waiting for it. Return the promise result or JS_EXCEPTION in case of promise rejection.
+func (ctx *Context) Await(v Value) (Value, error) {
+	val := Value{ctx: ctx, ref: C.js_std_await(ctx.ref, v.ref)}
+	if val.IsException() {
+		return val, ctx.Exception()
+	}
+	return val, nil
+}

quickjs_test.go

@@ -741,3 +741,22 @@ func TestSetTimeout(t *testing.T) {
 
 	require.EqualValues(t, true, a.Bool())
 }
+
+func TestAwait(t *testing.T) {
+	rt := quickjs.NewRuntime()
+	defer rt.Close()
+
+	ctx := rt.NewContext()
+	defer ctx.Close()
+
+	// async function bind to global
+	ctx.Globals().Set("testAsync", ctx.AsyncFunction(func(ctx *quickjs.Context, this quickjs.Value, promise quickjs.Value, args []quickjs.Value) quickjs.Value {
+		return promise.Call("resolve", ctx.String(args[0].String()+args[1].String()))
+	}))
+
+	// testAwait
+	promise, _ := ctx.Eval("testAsync('Hello ', 'Await')")
+	promiseAwait, _ := ctx.Await(promise)
+
+	require.EqualValues(t, "Hello Await", promiseAwait.String())
+}