REDROOM

Navigation

Breadcrumbs

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

Create

Create File | Create Folder | Upload Files | Run Command

Preview: v8-statistics.h Size: 6.80 KB

//opt/cpanel/ea-nodejs20/include/node/v8-statistics.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_STATISTICS_H_
#define INCLUDE_V8_STATISTICS_H_

#include <stddef.h>
#include <stdint.h>

#include <memory>
#include <utility>
#include <vector>

#include "v8-local-handle.h"  // NOLINT(build/include_directory)
#include "v8-promise.h"       // NOLINT(build/include_directory)
#include "v8config.h"         // NOLINT(build/include_directory)

namespace v8 {

class Context;
class Isolate;

namespace internal {
class ReadOnlyHeap;
}  // namespace internal

/**
 * Controls how the default MeasureMemoryDelegate reports the result of
 * the memory measurement to JS. With kSummary only the total size is reported.
 * With kDetailed the result includes the size of each native context.
 */
enum class MeasureMemoryMode { kSummary, kDetailed };

/**
 * Controls how promptly a memory measurement request is executed.
 * By default the measurement is folded with the next scheduled GC which may
 * happen after a while and is forced after some timeout.
 * The kEager mode starts incremental GC right away and is useful for testing.
 * The kLazy mode does not force GC.
 */
enum class MeasureMemoryExecution { kDefault, kEager, kLazy };

/**
 * The delegate is used in Isolate::MeasureMemory API.
 *
 * It specifies the contexts that need to be measured and gets called when
 * the measurement is completed to report the results.
 */
class V8_EXPORT MeasureMemoryDelegate {
 public:
  virtual ~MeasureMemoryDelegate() = default;

  /**
   * Returns true if the size of the given context needs to be measured.
   */
  virtual bool ShouldMeasure(Local<Context> context) = 0;

  /**
   * This function is called when memory measurement finishes.
   *
   * \param context_sizes_in_bytes a vector of (context, size) pairs that
   *   includes each context for which ShouldMeasure returned true and that
   *   was not garbage collected while the memory measurement was in progress.
   *
   * \param unattributed_size_in_bytes total size of objects that were not
   *   attributed to any context (i.e. are likely shared objects).
   */
  virtual void MeasurementComplete(
      const std::vector<std::pair<Local<Context>, size_t>>&
          context_sizes_in_bytes,
      size_t unattributed_size_in_bytes) = 0;

  /**
   * Returns a default delegate that resolves the given promise when
   * the memory measurement completes.
   *
   * \param isolate the current isolate
   * \param context the current context
   * \param promise_resolver the promise resolver that is given the
   *   result of the memory measurement.
   * \param mode the detail level of the result.
   */
  static std::unique_ptr<MeasureMemoryDelegate> Default(
      Isolate* isolate, Local<Context> context,
      Local<Promise::Resolver> promise_resolver, MeasureMemoryMode mode);
};

/**
 * Collection of shared per-process V8 memory information.
 *
 * Instances of this class can be passed to
 * v8::V8::GetSharedMemoryStatistics to get shared memory statistics from V8.
 */
class V8_EXPORT SharedMemoryStatistics {
 public:
  SharedMemoryStatistics();
  size_t read_only_space_size() { return read_only_space_size_; }
  size_t read_only_space_used_size() { return read_only_space_used_size_; }
  size_t read_only_space_physical_size() {
    return read_only_space_physical_size_;
  }

 private:
  size_t read_only_space_size_;
  size_t read_only_space_used_size_;
  size_t read_only_space_physical_size_;

  friend class V8;
  friend class internal::ReadOnlyHeap;
};

/**
 * Collection of V8 heap information.
 *
 * Instances of this class can be passed to v8::Isolate::GetHeapStatistics to
 * get heap statistics from V8.
 */
class V8_EXPORT HeapStatistics {
 public:
  HeapStatistics();
  size_t total_heap_size() { return total_heap_size_; }
  size_t total_heap_size_executable() { return total_heap_size_executable_; }
  size_t total_physical_size() { return total_physical_size_; }
  size_t total_available_size() { return total_available_size_; }
  size_t total_global_handles_size() { return total_global_handles_size_; }
  size_t used_global_handles_size() { return used_global_handles_size_; }
  size_t used_heap_size() { return used_heap_size_; }
  size_t heap_size_limit() { return heap_size_limit_; }
  size_t malloced_memory() { return malloced_memory_; }
  size_t external_memory() { return external_memory_; }
  size_t peak_malloced_memory() { return peak_malloced_memory_; }
  size_t number_of_native_contexts() { return number_of_native_contexts_; }
  size_t number_of_detached_contexts() { return number_of_detached_contexts_; }

  /**
   * Returns a 0/1 boolean, which signifies whether the V8 overwrite heap
   * garbage with a bit pattern.
   */
  size_t does_zap_garbage() { return does_zap_garbage_; }

 private:
  size_t total_heap_size_;
  size_t total_heap_size_executable_;
  size_t total_physical_size_;
  size_t total_available_size_;
  size_t used_heap_size_;
  size_t heap_size_limit_;
  size_t malloced_memory_;
  size_t external_memory_;
  size_t peak_malloced_memory_;
  bool does_zap_garbage_;
  size_t number_of_native_contexts_;
  size_t number_of_detached_contexts_;
  size_t total_global_handles_size_;
  size_t used_global_handles_size_;

  friend class V8;
  friend class Isolate;
};

class V8_EXPORT HeapSpaceStatistics {
 public:
  HeapSpaceStatistics();
  const char* space_name() { return space_name_; }
  size_t space_size() { return space_size_; }
  size_t space_used_size() { return space_used_size_; }
  size_t space_available_size() { return space_available_size_; }
  size_t physical_space_size() { return physical_space_size_; }

 private:
  const char* space_name_;
  size_t space_size_;
  size_t space_used_size_;
  size_t space_available_size_;
  size_t physical_space_size_;

  friend class Isolate;
};

class V8_EXPORT HeapObjectStatistics {
 public:
  HeapObjectStatistics();
  const char* object_type() { return object_type_; }
  const char* object_sub_type() { return object_sub_type_; }
  size_t object_count() { return object_count_; }
  size_t object_size() { return object_size_; }

 private:
  const char* object_type_;
  const char* object_sub_type_;
  size_t object_count_;
  size_t object_size_;

  friend class Isolate;
};

class V8_EXPORT HeapCodeStatistics {
 public:
  HeapCodeStatistics();
  size_t code_and_metadata_size() { return code_and_metadata_size_; }
  size_t bytecode_and_metadata_size() { return bytecode_and_metadata_size_; }
  size_t external_script_source_size() { return external_script_source_size_; }
  size_t cpu_profiler_metadata_size() { return cpu_profiler_metadata_size_; }

 private:
  size_t code_and_metadata_size_;
  size_t bytecode_and_metadata_size_;
  size_t external_script_source_size_;
  size_t cpu_profiler_metadata_size_;

  friend class Isolate;
};

}  // namespace v8

#endif  // INCLUDE_V8_STATISTICS_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