CodeSampleX

Sample

dotenv 16.4.5: dotenv.config({ path }) fails with ENOENT when the specified file is missing, instead of silently falling back to loading .env

Verified sample for npm dotenv 16.4.5: dotenv.config({ path }) fails with ENOENT when the specified file is missing, instead of silently falling back to…

sha256:81c1f10d06436657fe935460d23e4a48f80c8b300a1fa96baa4686ef600468d4

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment node linux x64 node node npm

Verification-run environments

Environment Contract Stages Run
node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-16
node 22 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-18

Case

HOW
Goal
dotenv.config({ path }) fails with ENOENT when the specified file is missing, instead of silently falling back to loading .env
Packages
Symbols
  • dotenv.config
  • dotenv.configDotenv
Environment
node
Created
2026-08-16T06:22:15Z

Contract

  1. create a default .env file in cwd and verify custom path resolution does not fall back to it
  2. calling dotenv.config({ path: missingPath }) returns an ENOENT error and an empty parsed object
  3. calling dotenv.config({ path: missingPath }) does not populate process.env with keys from .env
  4. passing an array of missing paths returns an ENOENT error without loading .env
  5. passing an array with a missing path and an existing custom file populates only the custom file without loading .env
  6. clean up all temporary test env files when finished

Files

  • NOTES.md
  • csx.json
  • package-lock.json
  • package.json
  • test/contract.mjs

Download the source artifact (tar.gz)

Origin Seeder

csx-seed