1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
/*
* Copyright (C) 2010 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
* copyright notice, this list of conditions and the following disclaimer
* in the documentation and/or other materials provided with the
* distribution.
* * Neither the name of Google Inc. nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef THIRD_PARTY_BLINK_RENDERER_CORE_TIMING_PERFORMANCE_TIMING_H_
#define THIRD_PARTY_BLINK_RENDERER_CORE_TIMING_PERFORMANCE_TIMING_H_
#include "base/time/time.h"
#include "third_party/blink/renderer/core/core_export.h"
#include "third_party/blink/renderer/core/execution_context/execution_context_lifecycle_observer.h"
#include "third_party/blink/renderer/platform/bindings/script_wrappable.h"
#include "third_party/blink/renderer/platform/heap/handle.h"
#include "third_party/blink/renderer/platform/instrumentation/tracing/traced_value.h"
namespace blink {
class CSSTiming;
class DocumentLoadTiming;
class DocumentLoader;
class DocumentParserTiming;
class DocumentTiming;
class InteractiveDetector;
class LocalFrame;
class PaintTiming;
class PaintTimingDetector;
class ResourceLoadTiming;
class ScriptState;
class ScriptValue;
// Legacy support for NT1(https://www.w3.org/TR/navigation-timing/).
class CORE_EXPORT PerformanceTiming final : public ScriptWrappable,
public ExecutionContextClient {
DEFINE_WRAPPERTYPEINFO();
USING_GARBAGE_COLLECTED_MIXIN(PerformanceTiming);
public:
explicit PerformanceTiming(LocalFrame*);
uint64_t navigationStart() const;
uint64_t inputStart() const;
uint64_t unloadEventStart() const;
uint64_t unloadEventEnd() const;
uint64_t redirectStart() const;
uint64_t redirectEnd() const;
uint64_t fetchStart() const;
uint64_t domainLookupStart() const;
uint64_t domainLookupEnd() const;
uint64_t connectStart() const;
uint64_t connectEnd() const;
uint64_t secureConnectionStart() const;
uint64_t requestStart() const;
uint64_t responseStart() const;
uint64_t responseEnd() const;
uint64_t domLoading() const;
uint64_t domInteractive() const;
uint64_t domContentLoadedEventStart() const;
uint64_t domContentLoadedEventEnd() const;
uint64_t domComplete() const;
uint64_t loadEventStart() const;
uint64_t loadEventEnd() const;
// The below are non-spec timings, for Page Load UMA metrics.
// The time immediately after the user agent finishes prompting to unload the
// previous document, or if there is no previous document, the same value as
// fetchStart. Intended to be used for correlation with other events internal
// to blink. Not to be exposed to JavaScript.
base::TimeTicks NavigationStartAsMonotonicTime() const;
// The time the first paint operation was performed.
uint64_t FirstPaint() const;
// The time the first paint operation for image was performed.
uint64_t FirstImagePaint() const;
// The time of the first 'contentful' paint. A contentful paint is a paint
// that includes content of some kind (for example, text or image content).
uint64_t FirstContentfulPaint() const;
// The first 'contentful' paint as full-resolution monotonic time. Intended to
// be used for correlation with other events internal to blink. Not to be
// exposed to JavaScript.
base::TimeTicks FirstContentfulPaintAsMonotonicTime() const;
// The time of the first 'meaningful' paint, A meaningful paint is a paint
// where the page's primary content is visible.
uint64_t FirstMeaningfulPaint() const;
// The time of the candidate of first 'meaningful' paint, A meaningful paint
// candidate indicates the first time we considered a paint to qualify as the
// potential first meaningful paint. But, be careful that it may be an
// optimistic (i.e., too early) estimate.
// TODO(crbug.com/848639): This function is exposed as an experiment, and if
// not useful, this function can be removed.
uint64_t FirstMeaningfulPaintCandidate() const;
// Largest Image Paint is the first paint after the largest image within
// viewport being fully loaded. LargestImagePaint and LargestImagePaintSize
// are the time and size of it.
uint64_t LargestImagePaint() const;
uint64_t LargestImagePaintSize() const;
// The time of the first paint of the largest text within viewport.
// Largest Text Paint is the first paint after the largest text within
// viewport being painted. LargestTextPaint and LargestTextPaintSize
// are the time and size of it.
uint64_t LargestTextPaint() const;
uint64_t LargestTextPaintSize() const;
// The time at which we are notified of the first input or scroll event which
// causes the largest contentful paint algorithm to stop.
uint64_t FirstInputOrScrollNotifiedTimestamp() const;
// The duration between the hardware timestamp and being queued on the main
// thread for the first click, tap, key press, cancellable touchstart, or
// pointer down followed by a pointer up.
base::Optional<base::TimeDelta> FirstInputDelay() const;
// The timestamp of the event whose delay is reported by FirstInputDelay().
base::Optional<base::TimeDelta> FirstInputTimestamp() const;
// The longest duration between the hardware timestamp and being queued on the
// main thread for the click, tap, key press, cancellable touchstart, or
// pointer down followed by a pointer up.
base::Optional<base::TimeDelta> LongestInputDelay() const;
// The timestamp of the event whose delay is reported by LongestInputDelay().
base::Optional<base::TimeDelta> LongestInputTimestamp() const;
uint64_t ParseStart() const;
uint64_t ParseStop() const;
uint64_t ParseBlockedOnScriptLoadDuration() const;
uint64_t ParseBlockedOnScriptLoadFromDocumentWriteDuration() const;
uint64_t ParseBlockedOnScriptExecutionDuration() const;
uint64_t ParseBlockedOnScriptExecutionFromDocumentWriteDuration() const;
typedef uint64_t (PerformanceTiming::*PerformanceTimingGetter)() const;
using NameToAttributeMap = HashMap<AtomicString, PerformanceTimingGetter>;
static const NameToAttributeMap& GetAttributeMapping();
ScriptValue toJSONForBinding(ScriptState*) const;
void Trace(Visitor*) override;
uint64_t MonotonicTimeToIntegerMilliseconds(base::TimeTicks) const;
std::unique_ptr<TracedValue> GetNavigationTracingData();
private:
const DocumentTiming* GetDocumentTiming() const;
const CSSTiming* CssTiming() const;
const DocumentParserTiming* GetDocumentParserTiming() const;
const PaintTiming* GetPaintTiming() const;
PaintTimingDetector* GetPaintTimingDetector() const;
DocumentLoader* GetDocumentLoader() const;
DocumentLoadTiming* GetDocumentLoadTiming() const;
ResourceLoadTiming* GetResourceLoadTiming() const;
InteractiveDetector* GetInteractiveDetector() const;
base::Optional<base::TimeDelta> MonotonicTimeToPseudoWallTime(
const base::Optional<base::TimeTicks>&) const;
};
} // namespace blink
#endif // THIRD_PARTY_BLINK_RENDERER_CORE_TIMING_PERFORMANCE_TIMING_H_
|
