File: api_last_error.h

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (80 lines) | stat: -rw-r--r-- 3,183 bytes parent folder | download | duplicates (5)
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
// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef EXTENSIONS_RENDERER_BINDINGS_API_LAST_ERROR_H_
#define EXTENSIONS_RENDERER_BINDINGS_API_LAST_ERROR_H_

#include <optional>
#include <string>

#include "base/functional/callback.h"
#include "extensions/renderer/bindings/api_binding_types.h"
#include "v8/include/v8.h"

namespace extensions {

// Handles creating and clearing a 'lastError' property to hold the last error
// set by an extension API function.
class APILastError {
 public:
  // Returns the object the 'lastError' property should be exposed on for the
  // given context. Also allows for the population of a `secondary_parent`; if
  // populated, this object will also have a lastError property, but it will be
  // a simple object without getters/setters. This is to accommodate the
  // legacy chrome.extension.lastError property.
  // Note: `secondary_parent` may be null.
  using GetParent = base::RepeatingCallback<v8::Local<v8::Object>(
      v8::Local<v8::Context>,
      v8::Local<v8::Object>* secondary_parent)>;

  APILastError(GetParent get_parent,
               binding::AddConsoleError add_console_error);
  APILastError(APILastError&& other);

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

  ~APILastError();

  // Sets the last error for the given `context` to `error`.
  void SetError(v8::Local<v8::Context> context, const std::string& error);

  // Clears the last error in the given `context`. If `report_if_unchecked` is
  // true and the developer didn't check the error, this throws an exception.
  void ClearError(v8::Local<v8::Context> context, bool report_if_unchecked);

  // Returns true if the given context has an active error.
  bool HasError(v8::Local<v8::Context> context);

  // Returns the message from the last error for the given `context` without
  // marking it as accessed. If the given context doesn't have an active error
  // returns std::nullopt.
  std::optional<std::string> GetErrorMessage(v8::Local<v8::Context> context);

  // Reports an unchecked error by logging it to the console. This is used when
  // an error occurs, and there is no way it could be checked.
  void ReportUncheckedError(v8::Local<v8::Context> context,
                            const std::string& error);

 private:
  // Sets the lastError property on the primary parent object (in practice, this
  // is chrome.runtime.lastError);
  void SetErrorOnPrimaryParent(v8::Local<v8::Context> context,
                               v8::Local<v8::Object> parent,
                               const std::string& error);

  // Sets the lastError property on the secondary parent object (in practice,
  // this is chrome.extension.lastError).
  void SetErrorOnSecondaryParent(v8::Local<v8::Context> context,
                                 v8::Local<v8::Object> parent,
                                 const std::string& error);

  GetParent get_parent_;

  binding::AddConsoleError add_console_error_;
};

}  // namespace extensions

#endif  // EXTENSIONS_RENDERER_BINDINGS_API_LAST_ERROR_H_