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 (*MicrotaskCallback)();

[Sven Panne, 2014/02/10 14:22:02]

We should probably add an Isolate* parameter. Every time we didn't add one for
callbacks, we regretted it later...

[rafaelw, 2014/02/11 00:28:52]

Done.

+
 // --- 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);
 
   /**
+   * Runs the Microtask Work Queue until empty

[rossberg, 2014/02/10 14:09:01]

The new functions could use comments pointing out that they're experimental for
the time being.

[rafaelw, 2014/02/11 00:28:52]

Done.

+   */
+  static void RunMicrotasks(Isolate* isolate);
+
+  /**
+   * Enqueues the callback to the Microtask Work Queue
+   */
+  static void EnqueueExternalMicrotask(Isolate* isolate,
+                                       MicrotaskCallback callback);
+
+   /**
+   * 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 1847 matching lines @@
  */
 
 
 }  // namespace v8
 
 
 #undef TYPE_CHECK
 
 
 #endif  // V8_H_