Add NODE_RAW_ENV to mirror host env vars under node

One can still use `-sDETERMINISITIC` to avoid this behaviour.

Fixes: #18816, #25791

Author: sbc100

ChangeLog.md

@@ -20,6 +20,9 @@ See docs/process.md for more on how version tagging works.
 
 4.0.21 (in development)
 -----------------------
+- When using `-sNODERAWFS` emscripten will now also mirror all host environment
+  variables.  This behaviour can also be separetely controlled with a new
+  `NODE_HOST_ENV` setting. (#18820)
 
 4.0.20 - 11/18/25
 -----------------

site/source/docs/tools_reference/settings_reference.rst

@@ -1506,6 +1506,18 @@ handles permissions and errors and so forth may be noticeable.
 
 Default value: false
 
+.. _node_host_env:
+
+NODE_HOST_ENV
+=============
+
+When running under nodejs, expose the underlying OS environment variables.
+This is similiar to how ``NODERAWFS`` exporses the underlying FS.
+This setting gets enabled by default when ``NODERAWFS`` is enabled, but can
+also be controlled separatley.
+
+Default value: false
+
 .. _node_code_caching:
 
 NODE_CODE_CACHING

src/lib/libwasi.js

@@ -67,6 +67,12 @@ var WasiLibrary = {
         '_': getExecutableName()
 #endif
       };
+#if ENVIRONMENT_MAY_BE_NODE && NODE_HOST_ENV
+      if (ENVIRONMENT_IS_NODE) {
+        // When NODE_HOST_ENV is enabled we mirror then entire host environment.
+        env = process.env;
+      }
+#endif
       // Apply the user-provided values, if any.
       for (var x in ENV) {
         // x is a key in ENV; if ENV[x] is undefined, that means it was

src/settings.js

@@ -1035,6 +1035,12 @@ var FORCE_FILESYSTEM = false;
 // [link]
 var NODERAWFS = false;
 
+// When running under nodejs, expose the underlying OS environment variables.
+// This is similiar to how ``NODERAWFS`` exporses the underlying FS.
+// This setting gets enabled by default when ``NODERAWFS`` is enabled, but can
+// also be controlled separatley.
+var NODE_HOST_ENV = false;
+
 // This saves the compiled wasm module in a file with name
 // ``$WASM_BINARY_NAME.$V8_VERSION.cached``
 // and loads it on subsequent runs. This caches the compiled wasm code from

test/other/test_std_filesystem_tempdir.cpp

@@ -0,0 +1,27 @@
+#include <cassert>
+#include <filesystem>
+#include <fstream>
+#include <iostream>
+
+namespace fs = std::filesystem;
+
+int main() {
+  // libc++'s temp_directory_path dependong on one of these env vars
+  // being set, and falls back to /tmp as a default.
+  // Log these values in case this test ever fails:
+  const char* env_paths[] = {"TMPDIR", "TMP", "TEMP", "TEMPDIR"};
+  for (int i = 0; i < sizeof(env_paths)/sizeof(char*); i++) {
+    const char* p = getenv(env_paths[i]);
+    std::cout << env_paths[i] << " -> " << (p ? p : "(NULL)") << "\n";
+    if (p) {
+      std::cout <<  env_paths[i] << " exists: " << fs::exists(env_paths[i]) << "\n";
+    }
+  }
+  std::cout << "default /tmp exists: " << fs::exists("/tmp") << "\n";
+
+  fs::path tmp{fs::temp_directory_path()};
+  std::cout << "temp_directory_path: " << tmp << "\n";
+  assert(fs::exists(tmp));
+  std::cout << "exists ok!" << "\n";
+  return 0;
+}

test/other/test_std_filesystem_tempdir.out

@@ -0,0 +1 @@
+exists ok!

test/test_other.py

@@ -7841,6 +7841,23 @@ def test_override_js_execution_environment(self):
         seen = self.run_js('test.js', engine=engine, assert_returncode=NON_ZERO)
         self.assertContained('Module.ENVIRONMENT has been deprecated. To force the environment, use the ENVIRONMENT compile-time option (for example, -sENVIRONMENT=web or -sENVIRONMENT=node', seen)
 
+  @requires_node
+  @with_env_modify({'FOO': 'bar'})
+  @parameterized({
+    '': ([], '|(null)|\n'),
+    'rawfs': (['-sNODERAWFS'], '|bar|\n'),
+    'enabled': (['-sNODE_HOST_ENV'], '|bar|\n'),
+  })
+  def test_node_host_env(self, args, expected):
+     create_file('src.c', r'''
+      #include <stdlib.h>
+      #include <stdio.h>
+      int main() {
+        printf("|%s|\n", getenv("FOO"));
+      }
+    ''')
+     self.do_runf('src.c', expected, cflags=args)
+
   def test_override_c_environ(self):
     create_file('pre.js', r'''
       Module.preRun = () => { ENV.hello = '💩 world'; ENV.LANG = undefined; }
@@ -13653,12 +13670,20 @@ def test_fs_icase(self):
     # c++20 for ends_with().
     self.do_other_test('test_fs_icase.cpp', cflags=['-sCASE_INSENSITIVE_FS', '-std=c++20'])
 
+  @crossplatform
   @with_all_fs
   def test_std_filesystem(self):
     if (WINDOWS or MACOS) and self.get_setting('NODERAWFS'):
       self.skipTest('Rawfs directory removal works only on Linux')
     self.do_other_test('test_std_filesystem.cpp')
 
+  @crossplatform
+  @with_all_fs
+  def test_std_filesystem_tempdir(self):
+    if (WINDOWS or MACOS) and self.get_setting('NODERAWFS') and self.get_setting('WASMFS'):
+      self.skipTest('NODERAWFS + WASMFS is does not allow access to arbitrary paths')
+    self.do_other_test('test_std_filesystem_tempdir.cpp', cflags=['-g'])
+
   def test_strict_js_closure(self):
     self.do_runf('hello_world.c', cflags=['-sSTRICT_JS', '-Werror=closure', '--closure=1', '-O3'])
 

tools/link.py

@@ -1884,6 +1884,9 @@ def get_full_import_name(name):
   if settings.PTHREADS:
     settings.REQUIRED_EXPORTS.append('_emscripten_tls_init')
 
+  if settings.NODERAWFS:
+    default_setting('NODE_HOST_ENV', 1)
+
   settings.PRE_JS_FILES = options.pre_js
   settings.POST_JS_FILES = options.post_js