Skip to content

Conversation

jakecastelli
Copy link
Member

@jakecastelli jakecastelli commented Oct 15, 2025

This flag is very useful for postmortem debugging for OOM. Be able to create the heap snapshot by just a single CLI flag is a big advantage.

Ref: #50711 (comment)

@nodejs-github-bot nodejs-github-bot added cli Issues and PRs related to the Node.js command line interface. doc Issues and PRs related to the documentations. labels Oct 15, 2025

### `--harmony-shadow-realm`

### `--heap-snapshot-on-oom`
Copy link

@paulrutter paulrutter Oct 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically, this is not a nodejs flag. But I'm fine documenting it here, as it has value. I do think the docs should state the difference between the heapdump flags that are available.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Paul, if you take a closer look this section is called useful v8 flags 😄 https://github.com/nodejs/node/pull/60260/files#diff-7349c17bce4d97526eefcb6f8291d617e7edb92ed9927fd3b9264e8014fc4e7cR3968

I do think the docs should state the difference between the heapdump flags that are available.

I think that’s a great idea! Do you want to send a follow-up PR for it? You’ve got plenty of expertise in this area.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, i can supply a PR for this later 👍

@jakecastelli jakecastelli added the author ready PRs that have at least one approval, no pending requests for changes, and a CI started. label Oct 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author ready PRs that have at least one approval, no pending requests for changes, and a CI started. cli Issues and PRs related to the Node.js command line interface. doc Issues and PRs related to the documentations.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants