File: layout_shift_normalization.h

package info (click to toggle)
chromium 138.0.7204.183-1~deb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm-proposed-updates
  • size: 6,080,960 kB
  • sloc: cpp: 34,937,079; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,954; asm: 946,768; xml: 739,971; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,811; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (69 lines) | stat: -rw-r--r-- 2,435 bytes parent folder | download | duplicates (6)
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
// Copyright 2020 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_PAGE_LOAD_METRICS_BROWSER_LAYOUT_SHIFT_NORMALIZATION_H_
#define COMPONENTS_PAGE_LOAD_METRICS_BROWSER_LAYOUT_SHIFT_NORMALIZATION_H_

#include "base/time/time.h"
#include "components/page_load_metrics/browser/page_load_metrics_observer.h"

namespace page_load_metrics {

// LayoutShiftNormalization implements some experimental strategies for
// normalizing layout shift. Instead of adding all layout shift scores together
// like what we do in Cumulative Layout Shift(CLS), we aggregate layout shifts
// window by window. For more information, see go/layoutshiftnorm.
class LayoutShiftNormalization {
 public:
  LayoutShiftNormalization();

  LayoutShiftNormalization(const LayoutShiftNormalization&) = delete;
  LayoutShiftNormalization& operator=(const LayoutShiftNormalization&) = delete;

  ~LayoutShiftNormalization();
  const NormalizedCLSData& normalized_cls_data() const {
    return normalized_cls_data_;
  }

  void AddNewLayoutShifts(
      const std::vector<page_load_metrics::mojom::LayoutShiftPtr>& new_shifts,
      base::TimeTicks current_time,
      /*Whole page CLS*/ float cumulative_layout_shift_score);

  void ClearAllLayoutShifts();

 private:
  struct SessionWindow {
    base::TimeTicks start_time;
    base::TimeTicks last_time;
    float layout_shift_score = 0.0;
  };

  void UpdateWindowCLS(
      std::vector<std::pair<base::TimeTicks, double>>::const_iterator first,
      std::vector<std::pair<base::TimeTicks, double>>::const_iterator
          first_non_stale,
      std::vector<std::pair<base::TimeTicks, double>>::const_iterator last,
      float cumulative_layout_shift_score);

  void UpdateSessionWindow(
      SessionWindow* session_window,
      base::TimeDelta gap,
      base::TimeDelta max_duration,
      std::vector<std::pair<base::TimeTicks, double>>::const_iterator begin,
      std::vector<std::pair<base::TimeTicks, double>>::const_iterator end,
      float& max_score);

  // CLS normalization
  NormalizedCLSData normalized_cls_data_;

  // This vector is maintained in sorted order.
  std::vector<std::pair<base::TimeTicks, double>> recent_layout_shifts_;

  SessionWindow session_gap1000ms_max5000ms_;
};

}  // namespace page_load_metrics

#endif  // COMPONENTS_PAGE_LOAD_METRICS_BROWSER_LAYOUT_SHIFT_NORMALIZATION_H_