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
|
// Copyright 2016 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef THIRD_PARTY_BLINK_RENDERER_CORE_DOM_DOCUMENT_PARSER_TIMING_H_
#define THIRD_PARTY_BLINK_RENDERER_CORE_DOM_DOCUMENT_PARSER_TIMING_H_
#include "base/macros.h"
#include "third_party/blink/renderer/core/dom/document.h"
#include "third_party/blink/renderer/platform/heap/handle.h"
#include "third_party/blink/renderer/platform/supplementable.h"
namespace blink {
// DocumentParserTiming is responsible for tracking parser-related timings for a
// given document.
class DocumentParserTiming final
: public GarbageCollectedFinalized<DocumentParserTiming>,
public Supplement<Document> {
USING_GARBAGE_COLLECTED_MIXIN(DocumentParserTiming);
public:
static const char kSupplementName[];
virtual ~DocumentParserTiming() = default;
static DocumentParserTiming& From(Document&);
// markParserStart and markParserStop methods record the time that the
// parser was first started/stopped, and notify that the document parser
// timing has changed. These methods do nothing (early return) if a time has
// already been recorded for the given parser event, or if a parser has
// already been detached.
void MarkParserStart();
void MarkParserStop();
// markParserDetached records that the parser is detached from the
// document. A single document may have multiple parsers, if e.g. the
// document is re-opened using document.write. DocumentParserTiming only
// wants to record parser start and stop time for the first parser. To avoid
// recording parser start and stop times for re-opened documents, we keep
// track of whether a parser has been detached, and avoid recording
// start/stop times for subsequent parsers, after the first parser has been
// detached.
void MarkParserDetached();
// Record a duration of time that the parser yielded due to loading a
// script, in seconds. scriptInsertedViaDocumentWrite indicates whether the
// script causing blocking was inserted via document.write. This may be
// called multiple times, once for each time the parser yields on a script
// load.
void RecordParserBlockedOnScriptLoadDuration(
double duration,
bool script_inserted_via_document_write);
// Record a duration of time that the parser spent executing a script, in
// seconds. scriptInsertedViaDocumentWrite indicates whether the script
// being executed was inserted via document.write. This may be called
// multiple times, once for each time the parser executes a script.
void RecordParserBlockedOnScriptExecutionDuration(
double duration,
bool script_inserted_via_document_write);
// The getters below return monotonically-increasing seconds, or zero if the
// given parser event has not yet occurred. See the comments for
// monotonicallyIncreasingTime in wtf/Time.h for additional details.
TimeTicks ParserStart() const { return parser_start_; }
TimeTicks ParserStop() const { return parser_stop_; }
// Returns the sum of all blocking script load durations reported via
// recordParseBlockedOnScriptLoadDuration.
double ParserBlockedOnScriptLoadDuration() const {
return parser_blocked_on_script_load_duration_;
}
// Returns the sum of all blocking script load durations due to
// document.write reported via recordParseBlockedOnScriptLoadDuration. Note
// that some uncommon cases are not currently covered by this method. See
// crbug/600711 for details.
double ParserBlockedOnScriptLoadFromDocumentWriteDuration() const {
return parser_blocked_on_script_load_from_document_write_duration_;
}
// Returns the sum of all script execution durations reported via
// recordParseBlockedOnScriptExecutionDuration.
double ParserBlockedOnScriptExecutionDuration() const {
return parser_blocked_on_script_execution_duration_;
}
// Returns the sum of all script execution durations due to
// document.write reported via recordParseBlockedOnScriptExecutionDuration.
// Note that some uncommon cases are not currently covered by this method. See
// crbug/600711 for details.
double ParserBlockedOnScriptExecutionFromDocumentWriteDuration() const {
return parser_blocked_on_script_execution_from_document_write_duration_;
}
void Trace(blink::Visitor*) override;
private:
explicit DocumentParserTiming(Document&);
void NotifyDocumentParserTimingChanged();
TimeTicks parser_start_;
TimeTicks parser_stop_;
double parser_blocked_on_script_load_duration_ = 0.0;
double parser_blocked_on_script_load_from_document_write_duration_ = 0.0;
double parser_blocked_on_script_execution_duration_ = 0.0;
double parser_blocked_on_script_execution_from_document_write_duration_ = 0.0;
bool parser_detached_ = false;
DISALLOW_COPY_AND_ASSIGN(DocumentParserTiming);
};
} // namespace blink
#endif
|