Home/ Questions/Q 8119849
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-06-06T04:55:47+00:00

I have a node.js (v0.6.12) application that starts by evaluating a Javascript file, startup.js.

  • 0

I have a node.js (v0.6.12) application that starts by evaluating a Javascript file, startup.js. It takes a long time to evaluate startup.js, and I’d like to ‘bake it in’ to a custom build of Node if possible.

The v8 source directory distributed with Node, node/deps/v8/src, contains a SconScript that can almost be used to do this. On line 302, we have

LIBRARY_FILES = '''
runtime.js
v8natives.js
array.js
string.js
uri.js
math.js
messages.js
apinatives.js
date.js
regexp.js
json.js
liveedit-debugger.js
mirror-debugger.js
debug-debugger.js
'''.split()

Those javascript files are present in the same directory. Something in the build process apparently evaluates them, takes a snapshot of state, and saves it as a byte string in node/out/Release/obj/release/snapshot.cc (on Mac OS). This file seems to be baked into Node.

Some customization of the startup snapshot is possible by altering the SconScript. For example, I can change the definition of the builtin Date.toString by altering date.js. I can even add new global variables by adding startup.js to the list of library files, with contents global.test = 1.

However, I can’t put just any javascript code in startup.js. If it contains Date.toString = 1;, an error results even though the code is valid at the node repl:

Build failed:  -> task failed (err #2): 
    {task: libv8.a SConstruct -> libv8.a}
make: *** [program] Error 1

And it obviously can’t make use of code that depends on libraries Node adds to v8. global.underscore = require('underscore'); causes the same error.

I’d ideally like a tool, customSnapshot, where customSnapshot startup.js evaluates startup.js with Node and then dumps a snapshot to a file, snapshot.cc, which I can put into the Node source directory. I can then build node and tell it not to rebuild the snapshot.

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. Editorial Team

    I just added an option to the mksnapshot command (which runs while you are building V8). The new –extra-file=filename.js flag lets you specify a file that is to be loaded and run in the process and then put in the snapshot. It’s on the trunk version of V8, not the 3.11 branch that is being used for node 0.8 so you will have to run node 0.8 with V8 version 3.11. As far as I know at the moment that works, but you will be somewhat on your own.

    Please file bugs if you try this and it doesn’t work for you.

    • 0