gc-extension.h 1.72 KB
Newer Older
1
// Copyright 2010 the V8 project authors. All rights reserved.
2 3
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
4 5 6 7

#ifndef V8_EXTENSIONS_GC_EXTENSION_H_
#define V8_EXTENSIONS_GC_EXTENSION_H_

8
#include "include/v8.h"
9
#include "src/base/strings.h"
10 11 12 13

namespace v8 {
namespace internal {

14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
// Provides garbage collection on invoking |fun_name|(options), where
// - options is a dictionary like object. See supported properties below.
// - no parameter refers to options:
//   {type: 'major', execution: 'sync'}.
// - truthy parameter that is not setting any options:
//   {type: 'minor', execution: 'sync'}.
//
// Supported options:
// - type: 'major' or 'minor' for full GC and Scavenge, respectively.
// - execution: 'sync' or 'async' for synchronous and asynchronous execution,
// respectively.
// - Defaults to {type: 'major', execution: 'sync'}.
//
// Returns a Promise that resolves when GC is done when asynchronous execution
// is requested, and undefined otherwise.
29 30
class GCExtension : public v8::Extension {
 public:
31 32 33
  explicit GCExtension(const char* fun_name)
      : v8::Extension("v8/gc",
                      BuildSource(buffer_, sizeof(buffer_), fun_name)) {}
34 35
  v8::Local<v8::FunctionTemplate> GetNativeFunctionTemplate(
      v8::Isolate* isolate, v8::Local<v8::String> name) override;
36
  static void GC(const v8::FunctionCallbackInfo<v8::Value>& args);
37 38 39

 private:
  static const char* BuildSource(char* buf, size_t size, const char* fun_name) {
40 41
    base::SNPrintF(base::Vector<char>(buf, static_cast<int>(size)),
                   "native function %s();", fun_name);
42 43 44 45
    return buf;
  }

  char buffer_[50];
46 47
};

48 49
}  // namespace internal
}  // namespace v8
50 51

#endif  // V8_EXTENSIONS_GC_EXTENSION_H_