Skip to content
This repository has been archived by the owner on Apr 22, 2023. It is now read-only.

V8 upgrade process

Julien Gilli edited this page Apr 15, 2015 · 26 revisions

Introduction

This document aims at describing what needs to be done when upgrading the version of V8 that is included in Node.js' source tree.

Floating patches

Patches that need to be upstreamed

Testing

Node.js tests suite

The first step is to run the standard Node.js tests suite. The best way to do that is to push the branch that contains the V8 upgrade to joyent/node in a feature branch (something like v8-upgrade) and to run the the node-review-unix Jenkins job on that branch.

Testing post-mortem debugging on SmartOS

Post-mortem debugging on SmartOS relies on information generated both by the build process and by V8 at runtime. When V8 changes, sometimes the metadata generated at build time needs to change to match V8's runtime data structures.

In order to test post-mortem debugging on SmartOS, simply build a node binary with the default build options and run the following tests: test/pummel/test-postmortem-details.js, test/pummel/test-postmortem-findjsobjects.js, test/pummel/test-postmortem-jsstack.js. All these tests must exit with a 0 exit code.