File: lazy_source_location.h

package info (click to toggle)
chromium 142.0.7444.175-1~deb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm-proposed-updates
  • size: 6,303,984 kB
  • sloc: cpp: 35,488,370; ansic: 7,479,680; javascript: 4,259,373; python: 1,466,844; xml: 757,444; asm: 710,716; pascal: 187,980; sh: 89,247; perl: 88,690; objc: 79,984; sql: 56,984; cs: 42,192; fortran: 24,137; makefile: 22,919; tcl: 15,277; php: 14,018; yacc: 9,005; ruby: 7,553; awk: 3,720; lisp: 3,096; lex: 1,330; ada: 727; jsp: 228; sed: 36
file content (57 lines) | stat: -rw-r--r-- 2,147 bytes parent folder | download | duplicates (3)
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
// Copyright 2025 The Chromium Authors
// 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_PLATFORM_BINDINGS_LAZY_SOURCE_LOCATION_H_
#define THIRD_PARTY_BLINK_RENDERER_PLATFORM_BINDINGS_LAZY_SOURCE_LOCATION_H_

#include <variant>

#include "third_party/blink/renderer/platform/bindings/trace_wrapper_v8_reference.h"
#include "third_party/blink/renderer/platform/heap/garbage_collected.h"
#include "third_party/blink/renderer/platform/platform_export.h"
#include "third_party/blink/renderer/platform/wtf/text/wtf_string.h"
#include "v8/include/v8.h"

namespace blink {

// A location in JS source code that performs a lazy conversion of the URL
// string from a v8::String to a Blink String. This class is designed to be
// used specifically in scenarios where the URL may not be retrieved, improving
// performance by deferring the string conversion and allocation.
class PLATFORM_EXPORT LazySourceLocation final
    : public GarbageCollected<LazySourceLocation> {
 public:
  LazySourceLocation();

  LazySourceLocation(const String& url);

  LazySourceLocation(v8::Isolate* isolate,
                     v8::Local<v8::String> url,
                     int char_position);

  LazySourceLocation(v8::Isolate* isolate,
                     v8::Local<v8::String> url,
                     int char_position,
                     int line_number,
                     int column_number);
  ~LazySourceLocation();

  // This enables lazy conversion of script URLs for performance.
  static LazySourceLocation* FromCurrentStack(v8::Isolate* isolate);
  const String& Url(v8::Isolate* isolate) const;
  int CharPosition() const { return char_position_; }
  int LineNumber() const { return line_number_; }
  int ColumnNumber() const { return column_number_; }
  void Trace(Visitor* visitor) const;

 private:
  mutable std::variant<String, TraceWrapperV8Reference<v8::String>> url_;
  int char_position_ = -1;
  int line_number_ = 0;
  int column_number_ = 0;
};

}  // namespace blink

#endif  // THIRD_PARTY_BLINK_RENDERER_PLATFORM_BINDINGS_LAZY_SOURCE_LOCATION_H_