chrome/renderer/page_load_histograms.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_RENDERER_PAGE_LOAD_HISTOGRAMS_H_
   6 #define CHROME_RENDERER_PAGE_LOAD_HISTOGRAMS_H_
   7
   8 #include "base/basictypes.h"
   9 #include "content/public/renderer/render_view_observer.h"
  10
  11 namespace content {
  12 class DocumentState;
  13 }
  14
  15 class PageLoadHistograms : public content::RenderViewObserver {
  16  public:
  17   explicit PageLoadHistograms(content::RenderView* render_view);
  18
  19  private:
  20   // RenderViewObserver implementation.
  21   virtual void FrameWillClose(blink::WebFrame* frame) OVERRIDE;
  22   virtual void ClosePage() OVERRIDE;
  23
  24   // Dump all page load histograms appropriate for the given frame.
  25   //
  26   // This method will only dump once-per-instance, so it is safe to call
  27   // multiple times.
  28   //
  29   // The time points we keep are
  30   //    request: time document was requested by user
  31   //    start: time load of document started
  32   //    commit: time load of document started
  33   //    finish_document: main document loaded, before onload()
  34   //    finish_all_loads: after onload() and all resources are loaded
  35   //    first_paint: first paint performed
  36   //    first_paint_after_load: first paint performed after load is finished
  37   //    begin: request if it was user requested, start otherwise
  38   //
  39   // It's possible for the request time not to be set, if a client
  40   // redirect had been done (the user never requested the page)
  41   // Also, it's possible to load a page without ever laying it out
  42   // so first_paint and first_paint_after_load can be 0.
  43   void Dump(blink::WebFrame* frame);
  44
  45   void LogPageLoadTime(const content::DocumentState* load_times,
  46                        const blink::WebDataSource* ds) const;
  47
  48   DISALLOW_COPY_AND_ASSIGN(PageLoadHistograms);
  49 };
  50
  51 #endif  // CHROME_RENDERER_PAGE_LOAD_HISTOGRAMS_H_