V8 Microtask Queue & API

include/v8.h

 // Copyright 2012 the V8 project authors. All rights reserved.
 // Redistribution and use in source and binary forms, with or without
 // modification, are permitted provided that the following conditions are
 // met:
 //
 //     * Redistributions of source code must retain the above copyright
 //       notice, this list of conditions and the following disclaimer.
 //     * Redistributions in binary form must reproduce the above
 //       copyright notice, this list of conditions and the following
 //       disclaimer in the documentation and/or other materials provided
@@ skipping 3840 matching lines @@
     kAllocationActionAll = kAllocationActionAllocate | kAllocationActionFree
   };
 
 typedef void (*MemoryAllocationCallback)(ObjectSpace space,
                                          AllocationAction action,
                                          int size);
 
 // --- 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,
                                           Local<Value> data);
 
 // --- AllowCodeGenerationFromStrings callbacks ---
 
 /**
  * Callback to check if code generation from strings is allowed. See
  * Context::AllowCodeGenerationFromStrings.
@@ skipping 701 matching lines @@
    * further callbacks.
    */
   static void AddCallCompletedCallback(CallCompletedCallback callback);
 
   /**
    * Removes callback that was installed by AddCallCompletedCallback.
    */
   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.
    */
   static bool Initialize();
 
   /**
    * Allows the host application to provide a callback which can be used
    * as a source of entropy for random number generators.
    */
@@ skipping 799 matching lines @@
   static const int kStringEncodingMask = 0x4;
   static const int kExternalTwoByteRepresentationTag = 0x02;
   static const int kExternalAsciiRepresentationTag = 0x06;
 
   static const int kIsolateEmbedderDataOffset = 0 * kApiPointerSize;
   static const int kIsolateRootsOffset = 5 * kApiPointerSize;
   static const int kUndefinedValueRootIndex = 5;
   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;
   static const int kNodeStateMask = 0xf;
   static const int kNodeStateIsWeakValue = 2;
   static const int kNodeStateIsPendingValue = 3;
   static const int kNodeStateIsNearDeathValue = 4;
   static const int kNodeIsIndependentShift = 4;
   static const int kNodeIsPartiallyDependentShift = 5;
 
@@ skipping 1027 matching lines @@
  */
 
 
 }  // namespace v8
 
 
 #undef TYPE_CHECK
 
 
 #endif  // V8_H_