Split up leak detector into two stages for better leak reporting.

third_party/WebKit/public/web/WebLeakDetector.h

 /*
  * Copyright (C) 2014 Google Inc. 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
@@ skipping 35 matching lines @@
         unsigned numberOfLiveResources;
         unsigned numberOfLiveActiveDOMObjects;
         unsigned numberOfLiveScriptPromises;
         unsigned numberOfLiveFrames;
         unsigned numberOfLiveV8PerContextData;
     };
 
     virtual void onLeakDetectionComplete(const Result&) = 0;
 };
 
+// |WebLeakDetector| detects leaks of various Blink objects, counting
+// the ones remaining after having reset Blink's global state and
+// collected all garbage. See |WebLeakDetectorClient::Results|
+// for the kinds of objects supported.
 class WebLeakDetector {
 public:
     virtual ~WebLeakDetector() { }
 
     BLINK_EXPORT static WebLeakDetector* create(WebLeakDetectorClient*);
 
-    // Cleans up the DOM objects and counts them. |WebLeakDetectorClient::onLeakDetectionComplete()| is called when done.
-    // This is supposed to be used for detecting DOM-object leaks.
-    virtual void collectGarbageAndGetDOMCounts(WebLocalFrame*) = 0;
+    // Leak detection is performed in two stages,
+    // |prepareForLeakDetection()| and |collectGarbageAndReport()|.
+    //
+    // The first clearing out various global resources that a frame
+    // keeps, with the second clearing out all garbage in Blink's
+    // managed heaps before reporting leak counts.
+    //
+    // |WebLeakDetectorClient::onLeakDetectionComplete()| is called
+    // with the result of the (leaked) resource counting.
+    //
+    // By separating into two, the caller is able to inject any
+    // additional releasing of resources needed before the garbage
+    // collections go ahead.
+
+    // Perform initial stage of preparing for leak detection,
+    // releasing references to resources held globally.
+    virtual void prepareForLeakDetection(WebLocalFrame*) = 0;
+
+    // Garbage collect Blink's heaps and report leak counts.
+    // |WebLeakDetectorClient::onLeakDetectionComplete()| is called
+    // upon completion.
+    virtual void collectGarbageAndReport() = 0;
 };
 
 } // namespace blink
 
 #endif // WebLeakDetector_h