REDROOM

Navigation

Breadcrumbs

/ / opt / cpanel / ea-nodejs20 / include / node

Create

Create File | Create Folder | Upload Files | Run Command

Preview: v8-debug.h Size: 5.04 KB

//opt/cpanel/ea-nodejs20/include/node/v8-debug.h

// Copyright 2021 the V8 project 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 INCLUDE_V8_DEBUG_H_
#define INCLUDE_V8_DEBUG_H_

#include <stdint.h>

#include "v8-script.h"  // NOLINT(build/include_directory)
#include "v8config.h"   // NOLINT(build/include_directory)

namespace v8 {

class Isolate;
class String;

/**
 * A single JavaScript stack frame.
 */
class V8_EXPORT StackFrame {
 public:
  /**
   * Returns the source location, 0-based, for the associated function call.
   */
  Location GetLocation() const;

  /**
   * Returns the number, 1-based, of the line for the associate function call.
   * This method will return Message::kNoLineNumberInfo if it is unable to
   * retrieve the line number, or if kLineNumber was not passed as an option
   * when capturing the StackTrace.
   */
  int GetLineNumber() const { return GetLocation().GetLineNumber() + 1; }

  /**
   * Returns the 1-based column offset on the line for the associated function
   * call.
   * This method will return Message::kNoColumnInfo if it is unable to retrieve
   * the column number, or if kColumnOffset was not passed as an option when
   * capturing the StackTrace.
   */
  int GetColumn() const { return GetLocation().GetColumnNumber() + 1; }

  /**
   * Returns the id of the script for the function for this StackFrame.
   * This method will return Message::kNoScriptIdInfo if it is unable to
   * retrieve the script id, or if kScriptId was not passed as an option when
   * capturing the StackTrace.
   */
  int GetScriptId() const;

  /**
   * Returns the name of the resource that contains the script for the
   * function for this StackFrame.
   */
  Local<String> GetScriptName() const;

  /**
   * Returns the name of the resource that contains the script for the
   * function for this StackFrame or sourceURL value if the script name
   * is undefined and its source ends with //# sourceURL=... string or
   * deprecated //@ sourceURL=... string.
   */
  Local<String> GetScriptNameOrSourceURL() const;

  /**
   * Returns the source of the script for the function for this StackFrame.
   */
  Local<String> GetScriptSource() const;

  /**
   * Returns the source mapping URL (if one is present) of the script for
   * the function for this StackFrame.
   */
  Local<String> GetScriptSourceMappingURL() const;

  /**
   * Returns the name of the function associated with this stack frame.
   */
  Local<String> GetFunctionName() const;

  /**
   * Returns whether or not the associated function is compiled via a call to
   * eval().
   */
  bool IsEval() const;

  /**
   * Returns whether or not the associated function is called as a
   * constructor via "new".
   */
  bool IsConstructor() const;

  /**
   * Returns whether or not the associated functions is defined in wasm.
   */
  bool IsWasm() const;

  /**
   * Returns whether or not the associated function is defined by the user.
   */
  bool IsUserJavaScript() const;
};

/**
 * Representation of a JavaScript stack trace. The information collected is a
 * snapshot of the execution stack and the information remains valid after
 * execution continues.
 */
class V8_EXPORT StackTrace {
 public:
  /**
   * Flags that determine what information is placed captured for each
   * StackFrame when grabbing the current stack trace.
   * Note: these options are deprecated and we always collect all available
   * information (kDetailed).
   */
  enum StackTraceOptions {
    kLineNumber = 1,
    kColumnOffset = 1 << 1 | kLineNumber,
    kScriptName = 1 << 2,
    kFunctionName = 1 << 3,
    kIsEval = 1 << 4,
    kIsConstructor = 1 << 5,
    kScriptNameOrSourceURL = 1 << 6,
    kScriptId = 1 << 7,
    kExposeFramesAcrossSecurityOrigins = 1 << 8,
    kOverview = kLineNumber | kColumnOffset | kScriptName | kFunctionName,
    kDetailed = kOverview | kIsEval | kIsConstructor | kScriptNameOrSourceURL
  };

  /**
   * Returns a StackFrame at a particular index.
   */
  Local<StackFrame> GetFrame(Isolate* isolate, uint32_t index) const;

  /**
   * Returns the number of StackFrames.
   */
  int GetFrameCount() const;

  /**
   * Grab a snapshot of the current JavaScript execution stack.
   *
   * \param frame_limit The maximum number of stack frames we want to capture.
   * \param options Enumerates the set of things we will capture for each
   *   StackFrame.
   */
  static Local<StackTrace> CurrentStackTrace(
      Isolate* isolate, int frame_limit, StackTraceOptions options = kDetailed);

  /**
   * Returns the first valid script name or source URL starting at the top of
   * the JS stack. The returned string is either an empty handle if no script
   * name/url was found or a non-zero-length string.
   *
   * This method is equivalent to calling StackTrace::CurrentStackTrace and
   * walking the resulting frames from the beginning until a non-empty script
   * name/url is found. The difference is that this method won't allocate
   * a stack trace.
   */
  static Local<String> CurrentScriptNameOrSourceURL(Isolate* isolate);
};

}  // namespace v8

#endif  // INCLUDE_V8_DEBUG_H_

Directory Contents

Dirs: 4 × Files: 63

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
cppgc DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
libplatform DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
openssl DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
uv DIR	-	drwxr-xr-x	2026-02-03 09:33:34	Edit Download recursive recursive
common.gypi	24.67 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
config.gypi	27.42 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
js_native_api.h	31.43 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
js_native_api_types.h	6.87 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node.h	67.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_api.h	9.96 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_api_types.h	1.57 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_buffer.h	3.60 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_object_wrap.h	3.78 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
node_version.h	4.08 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
uv.h	67.74 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-array-buffer.h	17.75 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-callbacks.h	15.03 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-container.h	3.40 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-context.h	16.13 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-cppgc.h	7.46 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-data.h	1.58 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-date.h	1.19 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-debug.h	5.04 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-embedder-heap.h	1.90 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-embedder-state-scope.h	1.51 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-exception.h	6.98 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-extension.h	1.83 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-external.h	924 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-forward.h	1.62 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-function-callback.h	15.87 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-function.h	4.24 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-initialization.h	10.23 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-internal.h	39.18 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-isolate.h	60.97 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-json.h	1.32 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-local-handle.h	14.98 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-locker.h	3.86 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-maybe.h	4.47 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-memory-span.h	1.25 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-message.h	6.29 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-microtask-queue.h	4.95 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-microtask.h	861 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-object.h	28.51 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-persistent-handle.h	18.70 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-platform.h	41.37 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-primitive-object.h	2.53 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-primitive.h	27.65 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-profiler.h	40.47 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-promise.h	5.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-proxy.h	1.23 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-regexp.h	3.10 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-script.h	28.08 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-snapshot.h	6.97 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-statistics.h	6.80 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-template.h	37.42 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-traced-handle.h	11.85 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-typed-array.h	8.06 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-unwinder.h	4.63 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-value-serializer.h	10.09 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-value.h	13.45 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-version.h	772 B	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-wasm.h	6.00 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8-weak-callback-info.h	2.41 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8.h	3.69 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
v8config.h	31.61 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
zconf.h	16.60 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive
zlib.h	95.17 KB	lrw-r--r--	2026-01-16 18:04:27	Edit Download recursive recursive