Adding api to get last gc object statistics for chrome://tracing.

include/v8.h

Index: include/v8.h
diff --git a/include/v8.h b/include/v8.h
index 910279b52e6b29828a87e25106dde376aecc4869..8bd4500591a7cc3e343e2969bc8d561cc3bc056b 100644
--- a/include/v8.h
+++ b/include/v8.h
@@ -4815,6 +4815,22 @@ class V8_EXPORT HeapSpaceStatistics {
 };
 
 
+class V8_EXPORT HeapObjectStatistics {
+ public:
+  HeapObjectStatistics();
+  const char* object_type() { return object_type_; }

[Primiano Tucci (use gerrit), 2015/05/07 16:54:15]

I wonder here if the right thing to do is concatenating types with slashes (e.g.
"CODE/CODE_AGE/IsExecuted"), or if we should expose them separately at an API
level, something like
const char* object_type();
const char* object_subtype();  // This will be "" for most of the entries, %
code_age, kind and fixed_array.

Ulan, WDYT?

+  size_t object_count() { return object_count_; }
+  size_t object_size() { return object_size_; }
+
+ private:
+  const char* object_type_;
+  size_t object_count_;
+  size_t object_size_;
+
+  friend class Isolate;
+};
+
+
 class RetainedObjectInfo;
 
 
@@ -5203,6 +5219,23 @@ class V8_EXPORT Isolate {
                               size_t index);
 
   /**
+   * Returns the number of types of objects tracked in the heap at GC.
+   */
+  size_t NumberOfTrackedHeapObjectTypes();
+
+  /**
+   * Get statistics about objects in the heap.
+   *
+   * \param object_statistics The HeapObjectStatistics object to fill in
+   *   statistics of objects of given type, which were live in the previous GC.
+   * \param type_index The index of the type of object to fill details about,
+   *   which ranges from 0 to NumberOfHeapObjectsTypes() - 1.
+   * \returns true on success.
+   */
+  bool GetHeapObjectStatisticsAtLastGC(HeapObjectStatistics* object_statistics,
+                                       size_t type_index);
+
+  /**
    * Get a call stack sample from the isolate.
    * \param state Execution state.
    * \param frames Caller allocated buffer to store stack frames.