node/test/parallel/test-compile-cache-api-env.js
Joyee Cheung ff5ef7083d
src: add JS APIs for compile cache and NODE_DISABLE_COMPILE_CACHE
This patch adds the following API for tools to enable compile
cache dynamically and query its status.

- module.enableCompileCache(cacheDir)
- module.getCompileCacheDir()

In addition this adds a NODE_DISABLE_COMPILE_CACHE environment
variable to disable the code cache enabled by the APIs as
an escape hatch to avoid unexpected/undesired effects of
the compile cache (e.g. less precise test coverage).

When the module.enableCompileCache() method is invoked without
a specified directory, Node.js will use the value of
the NODE_COMPILE_CACHE environment variable if it's set, or
defaults to `path.join(os.tmpdir(), 'node-compile-cache')`
otherwise. Therefore it's recommended for tools to call this
method without specifying the directory to allow overrides.

PR-URL: https://github.com/nodejs/node/pull/54501
Fixes: https://github.com/nodejs/node/issues/53639
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
2024-08-28 23:22:57 +00:00

82 lines
2.8 KiB
JavaScript

'use strict';
// This tests module.enableCompileCache() and module.getCompileCacheDir() work
// with a NODE_COMPILE_CACHE environment variable override.
require('../common');
const { spawnSyncAndAssert } = require('../common/child_process');
const assert = require('assert');
const fixtures = require('../common/fixtures');
const tmpdir = require('../common/tmpdir');
const fs = require('fs');
{
// Test that it works with non-existent directory.
tmpdir.refresh();
const apiDir = tmpdir.resolve('api_dir');
const envDir = tmpdir.resolve('env_dir');
spawnSyncAndAssert(
process.execPath,
['-r', fixtures.path('compile-cache-wrapper.js'), fixtures.path('empty.js')],
{
env: {
...process.env,
NODE_DEBUG_NATIVE: 'COMPILE_CACHE',
NODE_COMPILE_CACHE: envDir,
NODE_TEST_COMPILE_CACHE_DIR: apiDir,
},
cwd: tmpdir.path
},
{
stdout(output) {
console.log(output); // Logging for debugging.
assert.match(output, /dir before enableCompileCache: .*env_dir/);
assert.match(output, /Compile cache already enabled/);
assert.match(output, /dir after enableCompileCache: .*env_dir/);
return true;
},
stderr(output) {
console.log(output); // Logging for debugging.
assert.match(output, /reading cache from .*env_dir.* for CommonJS .*empty\.js/);
assert.match(output, /empty\.js was not initialized, initializing the in-memory entry/);
assert.match(output, /writing cache for .*empty\.js.*success/);
return true;
}
});
const cacheDir = fs.readdirSync(tmpdir.path);
assert.strictEqual(cacheDir.length, 1);
const entries = fs.readdirSync(tmpdir.resolve(cacheDir[0]));
assert.strictEqual(entries.length, 1);
// Second run reads the cache, but no need to re-write because it didn't change.
spawnSyncAndAssert(
process.execPath,
['-r', fixtures.path('compile-cache-wrapper.js'), fixtures.path('empty.js')],
{
env: {
...process.env,
NODE_DEBUG_NATIVE: 'COMPILE_CACHE',
NODE_COMPILE_CACHE: envDir,
NODE_TEST_COMPILE_CACHE_DIR: apiDir,
},
cwd: tmpdir.path
},
{
stdout(output) {
console.log(output); // Logging for debugging.
assert.match(output, /dir before enableCompileCache: .*env_dir/);
assert.match(output, /Compile cache already enabled/);
assert.match(output, /dir after enableCompileCache: .*env_dir/);
return true;
},
stderr(output) {
console.log(output); // Logging for debugging.
assert.match(output, /reading cache from .*env_dir.* for CommonJS .*empty\.js/);
assert.match(output, /cache for .*empty\.js was accepted, keeping the in-memory entry/);
assert.match(output, /.*skip .*empty\.js because cache was the same/);
return true;
}
});
}