GCC Code Coverage Report
Directory: ./ Exec Total Coverage
File: node_errors.h Lines: 13 16 81.2 %
Date: 2022-12-31 04:22:30 Branches: 0 0 - %

Line Branch Exec Source
1
#ifndef SRC_NODE_ERRORS_H_
2
#define SRC_NODE_ERRORS_H_
3
4
#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
5
6
#include "debug_utils-inl.h"
7
#include "env.h"
8
#include "v8.h"
9
10
// Use ostringstream to print exact-width integer types
11
// because the format specifiers are not available on AIX.
12
#include <sstream>
13
14
namespace node {
15
16
enum ErrorHandlingMode { CONTEXTIFY_ERROR, FATAL_ERROR, MODULE_ERROR };
17
void AppendExceptionLine(Environment* env,
18
                         v8::Local<v8::Value> er,
19
                         v8::Local<v8::Message> message,
20
                         enum ErrorHandlingMode mode);
21
22
[[noreturn]] void FatalError(const char* location, const char* message);
23
void OnFatalError(const char* location, const char* message);
24
void OOMErrorHandler(const char* location, const v8::OOMDetails& details);
25
26
// Helpers to construct errors similar to the ones provided by
27
// lib/internal/errors.js.
28
// Example: with `V(ERR_INVALID_ARG_TYPE, TypeError)`, there will be
29
// `node::ERR_INVALID_ARG_TYPE(isolate, "message")` returning
30
// a `Local<Value>` containing the TypeError with proper code and message
31
32
#define ERRORS_WITH_CODE(V)                                                    \
33
  V(ERR_BUFFER_CONTEXT_NOT_AVAILABLE, Error)                                   \
34
  V(ERR_BUFFER_OUT_OF_BOUNDS, RangeError)                                      \
35
  V(ERR_BUFFER_TOO_LARGE, Error)                                               \
36
  V(ERR_CLOSED_MESSAGE_PORT, Error)                                            \
37
  V(ERR_CONSTRUCT_CALL_REQUIRED, TypeError)                                    \
38
  V(ERR_CONSTRUCT_CALL_INVALID, TypeError)                                     \
39
  V(ERR_CRYPTO_INITIALIZATION_FAILED, Error)                                   \
40
  V(ERR_CRYPTO_INVALID_AUTH_TAG, TypeError)                                    \
41
  V(ERR_CRYPTO_INVALID_COUNTER, TypeError)                                     \
42
  V(ERR_CRYPTO_INVALID_CURVE, TypeError)                                       \
43
  V(ERR_CRYPTO_INVALID_DIGEST, TypeError)                                      \
44
  V(ERR_CRYPTO_INVALID_IV, TypeError)                                          \
45
  V(ERR_CRYPTO_INVALID_JWK, TypeError)                                         \
46
  V(ERR_CRYPTO_INVALID_KEYLEN, RangeError)                                     \
47
  V(ERR_CRYPTO_INVALID_KEYPAIR, RangeError)                                    \
48
  V(ERR_CRYPTO_INVALID_KEYTYPE, RangeError)                                    \
49
  V(ERR_CRYPTO_INVALID_MESSAGELEN, RangeError)                                 \
50
  V(ERR_CRYPTO_INVALID_SCRYPT_PARAMS, RangeError)                              \
51
  V(ERR_CRYPTO_INVALID_STATE, Error)                                           \
52
  V(ERR_CRYPTO_INVALID_TAG_LENGTH, RangeError)                                 \
53
  V(ERR_CRYPTO_JWK_UNSUPPORTED_CURVE, Error)                                   \
54
  V(ERR_CRYPTO_JWK_UNSUPPORTED_KEY_TYPE, Error)                                \
55
  V(ERR_CRYPTO_OPERATION_FAILED, Error)                                        \
56
  V(ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH, RangeError)                           \
57
  V(ERR_CRYPTO_UNKNOWN_CIPHER, Error)                                          \
58
  V(ERR_CRYPTO_UNKNOWN_DH_GROUP, Error)                                        \
59
  V(ERR_CRYPTO_UNSUPPORTED_OPERATION, Error)                                   \
60
  V(ERR_CRYPTO_JOB_INIT_FAILED, Error)                                         \
61
  V(ERR_DLOPEN_DISABLED, Error)                                                \
62
  V(ERR_DLOPEN_FAILED, Error)                                                  \
63
  V(ERR_ENCODING_INVALID_ENCODED_DATA, TypeError)                              \
64
  V(ERR_EXECUTION_ENVIRONMENT_NOT_AVAILABLE, Error)                            \
65
  V(ERR_INVALID_ADDRESS, Error)                                                \
66
  V(ERR_INVALID_ARG_VALUE, TypeError)                                          \
67
  V(ERR_OSSL_EVP_INVALID_DIGEST, Error)                                        \
68
  V(ERR_INVALID_ARG_TYPE, TypeError)                                           \
69
  V(ERR_INVALID_OBJECT_DEFINE_PROPERTY, TypeError)                             \
70
  V(ERR_INVALID_MODULE, Error)                                                 \
71
  V(ERR_INVALID_STATE, Error)                                                  \
72
  V(ERR_INVALID_THIS, TypeError)                                               \
73
  V(ERR_INVALID_TRANSFER_OBJECT, TypeError)                                    \
74
  V(ERR_MEMORY_ALLOCATION_FAILED, Error)                                       \
75
  V(ERR_MESSAGE_TARGET_CONTEXT_UNAVAILABLE, Error)                             \
76
  V(ERR_MISSING_ARGS, TypeError)                                               \
77
  V(ERR_MISSING_TRANSFERABLE_IN_TRANSFER_LIST, TypeError)                      \
78
  V(ERR_MISSING_PASSPHRASE, TypeError)                                         \
79
  V(ERR_MISSING_PLATFORM_FOR_WORKER, Error)                                    \
80
  V(ERR_NON_CONTEXT_AWARE_DISABLED, Error)                                     \
81
  V(ERR_OUT_OF_RANGE, RangeError)                                              \
82
  V(ERR_SCRIPT_EXECUTION_INTERRUPTED, Error)                                   \
83
  V(ERR_SCRIPT_EXECUTION_TIMEOUT, Error)                                       \
84
  V(ERR_STRING_TOO_LONG, Error)                                                \
85
  V(ERR_TLS_INVALID_PROTOCOL_METHOD, TypeError)                                \
86
  V(ERR_TLS_PSK_SET_IDENTIY_HINT_FAILED, Error)                                \
87
  V(ERR_VM_MODULE_CACHED_DATA_REJECTED, Error)                                 \
88
  V(ERR_VM_MODULE_LINK_FAILURE, Error)                                         \
89
  V(ERR_WASI_NOT_STARTED, Error)                                               \
90
  V(ERR_WORKER_INIT_FAILED, Error)                                             \
91
  V(ERR_PROTO_ACCESS, Error)
92
93
#define V(code, type)                                                          \
94
  template <typename... Args>                                                  \
95
  inline v8::Local<v8::Value> code(                                            \
96
      v8::Isolate* isolate, const char* format, Args&&... args) {              \
97
    std::string message = SPrintF(format, std::forward<Args>(args)...);        \
98
    v8::Local<v8::String> js_code = OneByteString(isolate, #code);             \
99
    v8::Local<v8::String> js_msg =                                             \
100
        OneByteString(isolate, message.c_str(), message.length());             \
101
    v8::Local<v8::Object> e = v8::Exception::type(js_msg)                      \
102
                                  ->ToObject(isolate->GetCurrentContext())     \
103
                                  .ToLocalChecked();                           \
104
    e->Set(isolate->GetCurrentContext(),                                       \
105
           OneByteString(isolate, "code"),                                     \
106
           js_code)                                                            \
107
        .Check();                                                              \
108
    return e;                                                                  \
109
  }                                                                            \
110
  template <typename... Args>                                                  \
111
  inline void THROW_##code(                                                    \
112
      v8::Isolate* isolate, const char* format, Args&&... args) {              \
113
    isolate->ThrowException(                                                   \
114
        code(isolate, format, std::forward<Args>(args)...));                   \
115
  }                                                                            \
116
  template <typename... Args>                                                  \
117
  inline void THROW_##code(                                                    \
118
      Environment* env, const char* format, Args&&... args) {                  \
119
    THROW_##code(env->isolate(), format, std::forward<Args>(args)...);         \
120
  }
121
14955
ERRORS_WITH_CODE(V)
122
#undef V
123
124
// Errors with predefined static messages
125
126
#define PREDEFINED_ERROR_MESSAGES(V)                                           \
127
  V(ERR_BUFFER_CONTEXT_NOT_AVAILABLE,                                          \
128
    "Buffer is not available for the current Context")                         \
129
  V(ERR_CLOSED_MESSAGE_PORT, "Cannot send data on closed MessagePort")         \
130
  V(ERR_CONSTRUCT_CALL_INVALID, "Constructor cannot be called")                \
131
  V(ERR_CONSTRUCT_CALL_REQUIRED, "Cannot call constructor without `new`")      \
132
  V(ERR_CRYPTO_INITIALIZATION_FAILED, "Initialization failed")                 \
133
  V(ERR_CRYPTO_INVALID_AUTH_TAG, "Invalid authentication tag")                 \
134
  V(ERR_CRYPTO_INVALID_COUNTER, "Invalid counter")                             \
135
  V(ERR_CRYPTO_INVALID_CURVE, "Invalid EC curve name")                         \
136
  V(ERR_CRYPTO_INVALID_DIGEST, "Invalid digest")                               \
137
  V(ERR_CRYPTO_INVALID_IV, "Invalid initialization vector")                    \
138
  V(ERR_CRYPTO_INVALID_JWK, "Invalid JWK format")                              \
139
  V(ERR_CRYPTO_INVALID_KEYLEN, "Invalid key length")                           \
140
  V(ERR_CRYPTO_INVALID_KEYPAIR, "Invalid key pair")                            \
141
  V(ERR_CRYPTO_INVALID_KEYTYPE, "Invalid key type")                            \
142
  V(ERR_CRYPTO_INVALID_MESSAGELEN, "Invalid message length")                   \
143
  V(ERR_CRYPTO_INVALID_SCRYPT_PARAMS, "Invalid scrypt params")                 \
144
  V(ERR_CRYPTO_INVALID_STATE, "Invalid state")                                 \
145
  V(ERR_CRYPTO_INVALID_TAG_LENGTH, "Invalid taglength")                        \
146
  V(ERR_CRYPTO_JWK_UNSUPPORTED_KEY_TYPE, "Unsupported JWK Key Type.")          \
147
  V(ERR_CRYPTO_OPERATION_FAILED, "Operation failed")                           \
148
  V(ERR_CRYPTO_TIMING_SAFE_EQUAL_LENGTH,                                       \
149
    "Input buffers must have the same byte length")                            \
150
  V(ERR_CRYPTO_UNKNOWN_CIPHER, "Unknown cipher")                               \
151
  V(ERR_CRYPTO_UNKNOWN_DH_GROUP, "Unknown DH group")                           \
152
  V(ERR_CRYPTO_UNSUPPORTED_OPERATION, "Unsupported crypto operation")          \
153
  V(ERR_CRYPTO_JOB_INIT_FAILED, "Failed to initialize crypto job config")      \
154
  V(ERR_DLOPEN_FAILED, "DLOpen failed")                                        \
155
  V(ERR_EXECUTION_ENVIRONMENT_NOT_AVAILABLE,                                   \
156
    "Context not associated with Node.js environment")                         \
157
  V(ERR_INVALID_ADDRESS, "Invalid socket address")                             \
158
  V(ERR_INVALID_MODULE, "No such module")                                      \
159
  V(ERR_INVALID_THIS, "Value of \"this\" is the wrong type")                   \
160
  V(ERR_INVALID_TRANSFER_OBJECT, "Found invalid object in transferList")       \
161
  V(ERR_MEMORY_ALLOCATION_FAILED, "Failed to allocate memory")                 \
162
  V(ERR_OSSL_EVP_INVALID_DIGEST, "Invalid digest used")                        \
163
  V(ERR_MESSAGE_TARGET_CONTEXT_UNAVAILABLE,                                    \
164
    "A message object could not be deserialized successfully in the target "   \
165
    "vm.Context")                                                              \
166
  V(ERR_MISSING_TRANSFERABLE_IN_TRANSFER_LIST,                                 \
167
    "Object that needs transfer was found in message but not listed "          \
168
    "in transferList")                                                         \
169
  V(ERR_MISSING_PLATFORM_FOR_WORKER,                                           \
170
    "The V8 platform used by this instance of Node does not support "          \
171
    "creating Workers")                                                        \
172
  V(ERR_NON_CONTEXT_AWARE_DISABLED,                                            \
173
    "Loading non context-aware native addons has been disabled")               \
174
  V(ERR_SCRIPT_EXECUTION_INTERRUPTED,                                          \
175
    "Script execution was interrupted by `SIGINT`")                            \
176
  V(ERR_TLS_PSK_SET_IDENTIY_HINT_FAILED, "Failed to set PSK identity hint")    \
177
  V(ERR_WASI_NOT_STARTED, "wasi.start() has not been called")                  \
178
  V(ERR_WORKER_INIT_FAILED, "Worker initialization failure")                   \
179
  V(ERR_PROTO_ACCESS,                                                          \
180
    "Accessing Object.prototype.__proto__ has been "                           \
181
    "disallowed with --disable-proto=throw")
182
183
#define V(code, message)                                                     \
184
  inline v8::Local<v8::Value> code(v8::Isolate* isolate) {                   \
185
    return code(isolate, message);                                           \
186
  }                                                                          \
187
  inline void THROW_ ## code(v8::Isolate* isolate) {                         \
188
    isolate->ThrowException(code(isolate, message));                         \
189
  }                                                                          \
190
  inline void THROW_ ## code(Environment* env) {                             \
191
    THROW_ ## code(env->isolate());                                          \
192
  }
193
2601
  PREDEFINED_ERROR_MESSAGES(V)
194
#undef V
195
196
// Errors with predefined non-static messages
197
13
inline void THROW_ERR_SCRIPT_EXECUTION_TIMEOUT(Environment* env,
198
                                               int64_t timeout) {
199
13
  std::ostringstream message;
200
13
  message << "Script execution timed out after ";
201
13
  message << timeout << "ms";
202
13
  THROW_ERR_SCRIPT_EXECUTION_TIMEOUT(env, message.str().c_str());
203
13
}
204
205
inline v8::Local<v8::Value> ERR_BUFFER_TOO_LARGE(v8::Isolate* isolate) {
206
  char message[128];
207
  snprintf(message, sizeof(message),
208
      "Cannot create a Buffer larger than 0x%zx bytes",
209
      v8::TypedArray::kMaxLength);
210
  return ERR_BUFFER_TOO_LARGE(isolate, message);
211
}
212
213
8
inline v8::Local<v8::Value> ERR_STRING_TOO_LONG(v8::Isolate* isolate) {
214
  char message[128];
215
8
  snprintf(message, sizeof(message),
216
      "Cannot create a string longer than 0x%x characters",
217
      v8::String::kMaxLength);
218
8
  return ERR_STRING_TOO_LONG(isolate, message);
219
}
220
221
#define THROW_AND_RETURN_IF_NOT_BUFFER(env, val, prefix)                     \
222
  do {                                                                       \
223
    if (!Buffer::HasInstance(val))                                           \
224
      return node::THROW_ERR_INVALID_ARG_TYPE(env,                           \
225
                                              prefix " must be a buffer");   \
226
  } while (0)
227
228
#define THROW_AND_RETURN_IF_NOT_STRING(env, val, prefix)                     \
229
  do {                                                                       \
230
    if (!val->IsString())                                                    \
231
      return node::THROW_ERR_INVALID_ARG_TYPE(env,                           \
232
                                              prefix " must be a string");   \
233
  } while (0)
234
235
namespace errors {
236
237
class TryCatchScope : public v8::TryCatch {
238
 public:
239
  enum class CatchMode { kNormal, kFatal };
240
241
1137083
  explicit TryCatchScope(Environment* env, CatchMode mode = CatchMode::kNormal)
242
1137083
      : v8::TryCatch(env->isolate()), env_(env), mode_(mode) {}
243
  ~TryCatchScope();
244
245
  // Since the dtor is not virtual we need to make sure no one creates
246
  // object of it in the free store that might be held by polymorphic pointers.
247
  void* operator new(std::size_t count) = delete;
248
  void* operator new[](std::size_t count) = delete;
249
  TryCatchScope(TryCatchScope&) = delete;
250
  TryCatchScope(TryCatchScope&&) = delete;
251
  TryCatchScope operator=(TryCatchScope&) = delete;
252
  TryCatchScope operator=(TryCatchScope&&) = delete;
253
254
 private:
255
  Environment* env_;
256
  CatchMode mode_;
257
};
258
259
// Trigger the global uncaught exception handler `process._fatalException`
260
// in JS land (which emits the 'uncaughtException' event). If that returns
261
// true, continue program execution, otherwise exit the process.
262
void TriggerUncaughtException(v8::Isolate* isolate,
263
                              const v8::TryCatch& try_catch);
264
void TriggerUncaughtException(v8::Isolate* isolate,
265
                              v8::Local<v8::Value> error,
266
                              v8::Local<v8::Message> message,
267
                              bool from_promise = false);
268
269
const char* errno_string(int errorno);
270
void PerIsolateMessageListener(v8::Local<v8::Message> message,
271
                               v8::Local<v8::Value> error);
272
273
void DecorateErrorStack(Environment* env,
274
                        const errors::TryCatchScope& try_catch);
275
}  // namespace errors
276
277
v8::ModifyCodeGenerationFromStringsResult ModifyCodeGenerationFromStrings(
278
    v8::Local<v8::Context> context,
279
    v8::Local<v8::Value> source,
280
    bool is_code_like);
281
}  // namespace node
282
283
#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS
284
285
#endif  // SRC_NODE_ERRORS_H_