V8 Microtask Queue & API

include/v8.h

Index: include/v8.h
diff --git a/include/v8.h b/include/v8.h
index fe3b020417fadb42eeab6eefa03a4c79c06abe04..f01a1c40f8c84ebeab98f2f331def1604d72f320 100644
--- a/include/v8.h
+++ b/include/v8.h
@@ -3858,6 +3858,9 @@ typedef void (*MemoryAllocationCallback)(ObjectSpace space,
 // --- Leave Script Callback ---
 typedef void (*CallCompletedCallback)();
 
+// --- External Microtask Callback ---
+typedef void (*ExternalMicrotaskCallback)(Isolate* isolate);
+
 // --- Failed Access Check Callback ---
 typedef void (*FailedAccessCheckCallback)(Local<Object> target,
                                           AccessType type,
@@ -4579,6 +4582,23 @@ class V8_EXPORT V8 {
   static void RemoveCallCompletedCallback(CallCompletedCallback callback);
 
   /**
+   * Experimental: Runs the Microtask Work Queue until empty
+   */
+  static void RunMicrotasks(Isolate* isolate);
+
+  /**
+   * Experimental: Enqueues the callback to the Microtask Work Queue
+   */
+  static void EnqueueExternalMicrotask(Isolate* isolate,
+                                       ExternalMicrotaskCallback callback);
+
+   /**
+   * Experimental: Controls whether the Microtask Work Queue is automatically
+   * run when the script call depth decrements to zero.
+   */
+  static void SetAutorunMicrotasks(Isolate *source, bool autorun);
+
+  /**
    * Initializes from snapshot if possible. Otherwise, attempts to
    * initialize from scratch.  This function is called implicitly if
    * you use the API without calling it first.
@@ -5398,7 +5418,7 @@ class Internals {
   static const int kNullValueRootIndex = 7;
   static const int kTrueValueRootIndex = 8;
   static const int kFalseValueRootIndex = 9;
-  static const int kEmptyStringRootIndex = 147;
+  static const int kEmptyStringRootIndex = 148;

[dcarney, 2014/02/11 07:47:13]

did you run make grokdump and commit the changes?

[rafaelw, 2014/02/11 20:37:43]

I didn't, but I have now, although I have no idea what grokdump is and when I
need to run it. The changes now included in this patch now clearly exceed the
scope of this patch. I'm assuming that's ok?

On 2014/02/11 07:47:13, dcarney wrote:

[dcarney, 2014/02/12 07:17:15]

any time you add or remove an instancetype or add or remove heap roots, it must
be run, the changes that it applies are intended

[rafaelw, 2014/02/12 21:25:03]

Got it. Thanks. What is grokdump used for?

On 2014/02/12 07:17:15, dcarney wrote:

 
   static const int kNodeClassIdOffset = 1 * kApiPointerSize;
   static const int kNodeFlagsOffset = 1 * kApiPointerSize + 3;