Skip to content

doc: clarify that V8 major upgrade uses stable release #67106

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nodejs-github-bot merged 2 commits into from
Oct 31, 2026
+9 −2
Merged

doc: clarify that V8 major upgrade uses stable release #67106

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
546b7d6
doc: clarify that V8 major upgrade uses stable release
joyeecheung Oct 29, 2026
6581266
Update maintaining-V8.md
joyeecheung Oct 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions doc/contributing/maintaining/maintaining-V8.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -327,8 +327,15 @@ Revision_ from the 5.4 branch that can be useful in the update process above.

### Major updates

We upgrade the version of V8 in Node.js `main` whenever a V8 release goes stable
upstream, that is, whenever a new release of Chrome comes out.
Along with Chrome, V8 has several
[different release channels](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/process/release_cycle.md).
A V8 release only reaches stable after the stable cut has been rolled out and tested
in several Chrome release channels, where regressions and bugs are discovered and fixed.

In the Node.js `main` branch, we typically upgrade the version of V8 whenever a
release of V8 finishes stable promotion and a _stable release_ is out.
The schedule of V8 release cycles can be found
[here](https://chromiumdash.appspot.com/schedule).

V8 updates can require a `NODE_MODULE_VERSION` bump if they change the native
addon ABI. See the release process documentation for when
Expand Down
Loading