0
0
mirror of https://github.com/nodejs/node.git synced 2024-11-29 15:06:33 +01:00
nodejs/doc/api/v8.markdown

44 lines
1.2 KiB
Markdown
Raw Normal View History

# V8
Stability: 1 - Experimental
This module exposes events and interfaces specific to the version of [V8][]
built with node. These interfaces are subject to change by upstream and are
therefore not covered under the stability index.
### getHeapStatistics()
Returns an object with the following properties
```
{
total_heap_size: 7326976,
total_heap_size_executable: 4194304,
total_physical_size: 7326976,
used_heap_size: 3476208,
heap_size_limit: 1535115264
}
```
### setFlagsFromString()
Set additional V8 command line flags. Use with care; changing settings
after the VM has started may result in unpredictable behavior, including
crashes and data loss. Or it may simply do nothing.
The V8 options available for a version of node may be determined by running
`iojs --v8-options`. An unofficial, community-maintained list of options
and their effects is available
[here](https://github.com/thlorenz/v8-flags/blob/master/flags-0.11.md).
Usage:
```
// Print GC events to stdout for one minute.
var v8 = require('v8');
v8.setFlagsFromString('--trace_gc');
setTimeout(function() { v8.setFlagsFromString('--notrace_gc'); }, 60e3);
```
[V8]: https://code.google.com/p/v8/