V8 14.x: NAN internal-field pointer calls need EmbedderDataTypeTag (compile failure)

[ssalekin-extron]

Description

Compiling a minimal NAN addon against Electron 41.0.0 (which bundles Node 24.14.0 and V8 14.6) triggers build failures inside nan.h when the following methods in AsyncResource attempts to use V8’s legacy untagged internal‑field pointer APIs. V8 14.x removed the following untagged overloads:

GetAlignedPointerFromInternalField(int)
SetAlignedPointerInInternalField(int, void*)

V8 now only exposes the tagged versions requiring an EmbedderDataTypeTag, in the v8::Object API for V8 14.x. The compiler (MSVC in my case) throws exception when compiled against electron 41.0.0 and node 24.14.0. This seems to be due to the recent v8 upgrade.

(ClCompile target) ->
...\node_modules\nan\nan.h(822,20): error C2661: 'v8::Object::GetAlignedPointerFromInternalField': no overloaded function takes 1 arguments [...\build\hello.vcxproj]
 ...\node_modules\nan\nan.h(829,13): error C2660: 'v8::Object::SetAlignedPointerInInternalField': function does not take 2 arguments [...\build\hello.vcxproj]

These failures do not occur when compiling against standard Node builds using older V8 versions. They occur only when building against Electron 41+ because its toolchain exposes the newer V8 APIs where the untagged overloads have been removed. Here is the update in node

Steps to Reproduce

Here is a repo that contains a minimal example reproducing the issue

Suggested Fix

I have a small patch that detects V8 ≥ 14 using V8_MAJOR_VERSION and switches to the tagged overloads but reserves the legacy API for older Node versions. Once maintainers confirm the desired direction, I can open a PR with the changes. Thank you!

[kkoopa]

I am out of office until next week, but from glancing through your message, doing the V8 version checking and using the tagged versions with some sane default tag (or however that works) sounds like precisely the correct way of moving forward.

…

On Fri, Mar 13, 2026, 22:35 Shawn Salekin ***@***.***> wrote: *ssalekin-extron* created an issue (nodejs/nan#1009) <#1009> Description Compiling a minimal NAN addon against Electron 41.0.0 (which bundles Node 24.14.0 and V8 14.6) triggers build failures inside nan.h when the following methods in AsyncResource attempts to use V8’s legacy untagged internal‑field pointer APIs. V8 14.x removed the following untagged overloads: GetAlignedPointerFromInternalField(int) SetAlignedPointerInInternalField(int, void*) V8 now only exposes the tagged versions requiring an EmbedderDataTypeTag, in the v8::Object API for V8 14.x. The compiler (MSVC in my case) throws exception when compiled against electron 41.0.0 and node 24.14.0. This seems to be due to the recent v8 upgrade. (ClCompile target) -> ...\node_modules\nan\nan.h(822,20): error C2661: 'v8::Object::GetAlignedPointerFromInternalField': no overloaded function takes 1 arguments [...\build\hello.vcxproj] ...\node_modules\nan\nan.h(829,13): error C2660: 'v8::Object::SetAlignedPointerInInternalField': function does not take 2 arguments [...\build\hello.vcxproj] These failures do not occur when compiling against standard Node builds using older V8 versions. They occur only when building against Electron 41+ because its toolchain exposes the newer V8 APIs where the untagged overloads have been removed. Here is the update in node <nodejs/node#60589> Steps to Reproduce Here is a repo <https://github.com/ssalekin-extron/nan-hello-electron> that contains a minimal example reproducing the issue Suggested Fix I have a small patch that detects V8 ≥ 14 using V8_MAJOR_VERSION and switches to the tagged overloads but reserves the legacy API for older Node versions. Once maintainers confirm the desired direction, I can open a PR with the changes. Thank you! — Reply to this email directly, view it on GitHub <#1009>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AA7JXKPEFR2FSPWICVTRUDD4QR5LDAVCNFSM6AAAAACWRPSUSOVHI2DSMVQWIX3LMV43ASLTON2WKOZUGA3TGNJQGA4DMNQ> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[ssalekin-extron]

Hi @kkoopa, I opened a PR with my changes. I was able to build and run the test suites locally for node 24.14.0 and 18.15.0. Looks like it needs a maintainer approval for GitHub CI run. Appreciate it whenever you get a chance to review this!

[ssalekin-extron]

there was an unintended line that sneaked into #1010. Added a second PR (#1011) to address that.