fix: TypeScript require() now tries extensions for paths with non-standard suffixes (e.g., environment.TEST)

- Fixed require() wrapper to only treat known extensions (.js, .cjs, .mjs, .json, .node) as real extensions
- Paths like './environments/environment.TEST' will now try .TEST.js, .TEST.cjs, etc.
- Previously, .TEST was treated as an extension, blocking the extension probe logic
- Added test case for require() with dynamic environment-based paths
- Bumped version to 4.0.0-beta.17

Author: kobenguyent

lib/utils/typescript.js

@@ -41,7 +41,37 @@ export async function transpileTypeScript(mainFilePath, typescript) {
         // This ensures dynamic require() calls work with relative paths from the original file location
         const originalFileUrl = `file://${filePath.replace(/\\/g, '/')}`
         esmGlobals += `import { createRequire } from 'module';
-const require = createRequire('${originalFileUrl}');
+import { extname as __extname } from 'path';
+const __baseRequire = createRequire('${originalFileUrl}');
+
+// Wrap require to auto-resolve extensions (mimics CommonJS behavior)
+const require = (id) => {
+  try {
+    return __baseRequire(id);
+  } catch (err) {
+    // If module not found and it's a relative/absolute path without extension, try common extensions
+    if (err.code === 'MODULE_NOT_FOUND' && (id.startsWith('./') || id.startsWith('../') || id.startsWith('/'))) {
+      const ext = __extname(id);
+      // Only treat known file extensions as real extensions (so names like .TEST don't block probing)
+      const __knownExts = ['.js', '.cjs', '.mjs', '.json', '.node'];
+      const hasKnownExt = ext && __knownExts.includes(ext.toLowerCase());
+      if (!hasKnownExt) {
+        // Try common extensions in order: .js, .cjs, .json, .node
+        const extensions = ['.js', '.cjs', '.json', '.node'];
+        for (const testExt of extensions) {
+          try {
+            return __baseRequire(id + testExt);
+          } catch (e) {
+            // Continue to next extension
+          }
+        }
+      }
+    }
+    // Re-throw original error if all attempts failed
+    throw err;
+  }
+};
+
 const module = { exports: {} };
 const exports = module.exports;
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "4.0.0-beta.16",
+  "version": "4.0.0-beta.17",
   "type": "module",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [

scripts/debug-transpile.mjs

@@ -0,0 +1,19 @@
+import path from 'path';
+import fs from 'fs';
+import { transpileTypeScript } from '../lib/utils/typescript.js';
+import ts from 'typescript';
+
+const target = process.argv[2];
+if (!target) {
+  console.error('Usage: node debug-transpile.mjs <path-to-ts-file>');
+  process.exit(1);
+}
+
+const abs = path.resolve(target);
+console.log('Transpiling', abs);
+const result = await transpileTypeScript(abs, ts);
+console.log('Result:', result);
+console.log('Files exist:');
+for (const f of result.allTempFiles) {
+  console.log(' -', f, 'exists?', fs.existsSync(f));
+}

test/data/typescript-require-relative/codecept.conf.ts

@@ -0,0 +1,13 @@
+import { E2EEnvironment } from './environments';
+
+export const config = {
+  tests: './*_test.js',
+  output: './output',
+  helpers: {
+    REST: {
+      endpoint: E2EEnvironment.url,
+      timeout: E2EEnvironment.timeout
+    }
+  },
+  name: 'typescript-require-relative-test'
+};

test/data/typescript-require-relative/environments.ts

@@ -0,0 +1,32 @@
+// Load environment configuration
+let env = process.env.E2E_ENV || "TEST";
+
+if (process.env.PROD === 'true') {
+    env = 'PROD';
+}
+
+const environmentPath = `./environments/environment.${env}`;
+// Using require to load the file dynamically
+const environment = require(environmentPath);
+
+environment.url = process.env.E2E_URL || environment.url;
+
+if (environment.url.endsWith("/")) {
+    // Remove tailing slash, since it would lead to problems with further configuration.
+    environment.url = environment.url.slice(0, -1);
+}
+
+// Setting default values on optional fields.
+if (!environment.urlApi) {
+    environment.urlApi = `${environment.url}/api`;
+}
+
+// Parse additional environment configurations.
+const environmentParsed = environment;
+environmentParsed.outputDir = `./../reports/e2e/results/`;
+environmentParsed.env = env;
+
+// There is no other logger in the E2E environment.
+console.log(`Parsed E2E environment:`, environmentParsed);
+
+export const E2EEnvironment = environmentParsed;

test/data/typescript-require-relative/environments/environment.TEST.cjs

@@ -0,0 +1,4 @@
+module.exports = {
+  url: 'https://test.example.com',
+  timeout: 10000
+};

test/data/typescript-require-relative/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "typescript-require-relative",
+  "version": "1.0.0",
+  "type": "module"
+}

test/data/typescript-require-relative/test-require.ts

@@ -0,0 +1,10 @@
+// Simple test to check if require wrapper tries extensions
+const modulePath = './environments/environment.TEST';
+console.log('Testing require wrapper...');
+
+try {
+  const env = require(modulePath);
+  console.log('SUCCESS: Loaded module without extension:', env);
+} catch (err) {
+  console.log('FAILED: Could not load module:', err.message);
+}

test/data/typescript-require-relative/test-simple.ts

@@ -0,0 +1,2 @@
+const result = require('./environments/environment.TEST');
+console.log('SUCCESS! Loaded:', result);

test/unit/config_test.js

@@ -106,4 +106,17 @@ describe('Config', () => {
     expect(cfg.helpers.REST.timeout).to.equal(5000)
     expect(cfg.name).to.equal('typescript-directory-import-test')
   })
+
+  it('should load TypeScript config with require() for paths without extensions', async () => {
+    const configPath = './test/data/typescript-require-relative/codecept.conf.ts'
+    process.env.E2E_ENV = 'TEST'
+    const cfg = await config.load(configPath)
+    
+    expect(cfg).to.be.ok
+    expect(cfg.helpers).to.have.property('REST')
+    expect(cfg.helpers.REST.endpoint).to.equal('https://test.example.com')
+    expect(cfg.helpers.REST.timeout).to.equal(10000)
+    expect(cfg.name).to.equal('typescript-require-relative-test')
+    delete process.env.E2E_ENV
+  })
 })