REDROOM

Navigation

Breadcrumbs

/ / opt / cpanel / ea-nodejs20 / include / node

Create

Create File | Create Folder | Upload Files | Run Command

Preview: v8-promise.h Size: 5.17 KB

//opt/cpanel/ea-nodejs20/include/node/v8-promise.h

// Copyright 2021 the V8 project authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef INCLUDE_V8_PROMISE_H_
#define INCLUDE_V8_PROMISE_H_

#include "v8-local-handle.h"  // NOLINT(build/include_directory)
#include "v8-object.h"        // NOLINT(build/include_directory)
#include "v8config.h"         // NOLINT(build/include_directory)

namespace v8 {

class Context;

#ifndef V8_PROMISE_INTERNAL_FIELD_COUNT
// The number of required internal fields can be defined by embedder.
#define V8_PROMISE_INTERNAL_FIELD_COUNT 0
#endif

/**
 * An instance of the built-in Promise constructor (ES6 draft).
 */
class V8_EXPORT Promise : public Object {
 public:
  /**
   * State of the promise. Each value corresponds to one of the possible values
   * of the [[PromiseState]] field.
   */
  enum PromiseState { kPending, kFulfilled, kRejected };

  class V8_EXPORT Resolver : public Object {
   public:
    /**
     * Create a new resolver, along with an associated promise in pending state.
     */
    static V8_WARN_UNUSED_RESULT MaybeLocal<Resolver> New(
        Local<Context> context);

    /**
     * Extract the associated promise.
     */
    Local<Promise> GetPromise();

    /**
     * Resolve/reject the associated promise with a given value.
     * Ignored if the promise is no longer pending.
     */
    V8_WARN_UNUSED_RESULT Maybe<bool> Resolve(Local<Context> context,
                                              Local<Value> value);

    V8_WARN_UNUSED_RESULT Maybe<bool> Reject(Local<Context> context,
                                             Local<Value> value);

    V8_INLINE static Resolver* Cast(Value* value) {
#ifdef V8_ENABLE_CHECKS
      CheckCast(value);
#endif
      return static_cast<Promise::Resolver*>(value);
    }

   private:
    Resolver();
    static void CheckCast(Value* obj);
  };

  /**
   * Register a resolution/rejection handler with a promise.
   * The handler is given the respective resolution/rejection value as
   * an argument. If the promise is already resolved/rejected, the handler is
   * invoked at the end of turn.
   */
  V8_WARN_UNUSED_RESULT MaybeLocal<Promise> Catch(Local<Context> context,
                                                  Local<Function> handler);

  V8_WARN_UNUSED_RESULT MaybeLocal<Promise> Then(Local<Context> context,
                                                 Local<Function> handler);

  V8_WARN_UNUSED_RESULT MaybeLocal<Promise> Then(Local<Context> context,
                                                 Local<Function> on_fulfilled,
                                                 Local<Function> on_rejected);

  /**
   * Returns true if the promise has at least one derived promise, and
   * therefore resolve/reject handlers (including default handler).
   */
  bool HasHandler() const;

  /**
   * Returns the content of the [[PromiseResult]] field. The Promise must not
   * be pending.
   */
  Local<Value> Result();

  /**
   * Returns the value of the [[PromiseState]] field.
   */
  PromiseState State();

  /**
   * Marks this promise as handled to avoid reporting unhandled rejections.
   */
  void MarkAsHandled();

  /**
   * Marks this promise as silent to prevent pausing the debugger when the
   * promise is rejected.
   */
  void MarkAsSilent();

  V8_INLINE static Promise* Cast(Value* value) {
#ifdef V8_ENABLE_CHECKS
    CheckCast(value);
#endif
    return static_cast<Promise*>(value);
  }

  static const int kEmbedderFieldCount = V8_PROMISE_INTERNAL_FIELD_COUNT;

 private:
  Promise();
  static void CheckCast(Value* obj);
};

/**
 * PromiseHook with type kInit is called when a new promise is
 * created. When a new promise is created as part of the chain in the
 * case of Promise.then or in the intermediate promises created by
 * Promise.{race, all}/AsyncFunctionAwait, we pass the parent promise
 * otherwise we pass undefined.
 *
 * PromiseHook with type kResolve is called at the beginning of
 * resolve or reject function defined by CreateResolvingFunctions.
 *
 * PromiseHook with type kBefore is called at the beginning of the
 * PromiseReactionJob.
 *
 * PromiseHook with type kAfter is called right at the end of the
 * PromiseReactionJob.
 */
enum class PromiseHookType { kInit, kResolve, kBefore, kAfter };

using PromiseHook = void (*)(PromiseHookType type, Local<Promise> promise,
                             Local<Value> parent);

// --- Promise Reject Callback ---
enum PromiseRejectEvent {
  kPromiseRejectWithNoHandler = 0,
  kPromiseHandlerAddedAfterReject = 1,
  kPromiseRejectAfterResolved = 2,
  kPromiseResolveAfterResolved = 3,
};

class PromiseRejectMessage {
 public:
  PromiseRejectMessage(Local<Promise> promise, PromiseRejectEvent event,
                       Local<Value> value)
      : promise_(promise), event_(event), value_(value) {}

  V8_INLINE Local<Promise> GetPromise() const { return promise_; }
  V8_INLINE PromiseRejectEvent GetEvent() const { return event_; }
  V8_INLINE Local<Value> GetValue() const { return value_; }

 private:
  Local<Promise> promise_;
  PromiseRejectEvent event_;
  Local<Value> value_;
};

using PromiseRejectCallback = void (*)(PromiseRejectMessage message);

}  // namespace v8

#endif  // INCLUDE_V8_PROMISE_H_

Directory Contents

Dirs: 4 × Files: 63

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
cppgc DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
libplatform DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
openssl DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
uv DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
common.gypi	24.67 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
config.gypi	27.42 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
js_native_api.h	31.43 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
js_native_api_types.h	6.87 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node.h	67.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_api.h	9.96 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_api_types.h	1.57 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_buffer.h	3.60 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_object_wrap.h	3.78 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_version.h	4.08 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
uv.h	67.74 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-array-buffer.h	17.75 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-callbacks.h	15.03 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-container.h	3.40 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-context.h	16.13 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-cppgc.h	7.46 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-data.h	1.58 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-date.h	1.19 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-debug.h	5.04 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-embedder-heap.h	1.90 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-embedder-state-scope.h	1.51 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-exception.h	6.98 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-extension.h	1.83 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-external.h	924 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-forward.h	1.62 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-function-callback.h	15.87 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-function.h	4.24 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-initialization.h	10.23 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-internal.h	39.18 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-isolate.h	60.97 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-json.h	1.32 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-local-handle.h	14.98 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-locker.h	3.86 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-maybe.h	4.47 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-memory-span.h	1.25 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-message.h	6.29 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-microtask-queue.h	4.95 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-microtask.h	861 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-object.h	28.51 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-persistent-handle.h	18.70 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-platform.h	41.37 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-primitive-object.h	2.53 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-primitive.h	27.65 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-profiler.h	40.47 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-promise.h	5.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-proxy.h	1.23 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-regexp.h	3.10 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-script.h	28.08 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-snapshot.h	6.97 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-statistics.h	6.80 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-template.h	37.42 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-traced-handle.h	11.85 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-typed-array.h	8.06 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-unwinder.h	4.63 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-value-serializer.h	10.09 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-value.h	13.45 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-version.h	772 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-wasm.h	6.00 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-weak-callback-info.h	2.41 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8.h	3.69 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8config.h	31.61 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
zconf.h	16.60 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
zlib.h	95.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive