Function validateSnippet

tests/snippet-validation.test.cjs:491–590

* Validate a snippet based on its language

(snippet)

 * Validate a snippet based on its language
 */
async function validateSnippet(snippet) {
  totalTests++;

  const relativePath = path.relative(DOCS_BASE_DIR, snippet.file);
  const testName = `${relativePath}:${snippet.line} (${snippet.language} block #${snippet.index})`;

  log(`\nTesting: ${testName}`, 'info');
  log(`  Code preview: ${snippet.code.substring(0, 60)}...`, 'dim');

  if (!snippet.shouldTest) {
    skippedTests++;
    log(`  ⊘ SKIPPED (not marked for testing)`, 'warning');
    return;
  }

  let result;

  try {
    switch (snippet.language.toLowerCase()) {
      case 'javascript':
      case 'typescript':
      case 'js':
      case 'ts':
        result = await testJavaScriptSnippet(snippet);
        break;

      case 'bash':
      case 'sh':
      case 'shell':
        // Check if it's a supported bash command (skip comments to find actual command)
        const lines = snippet.code.split('\n');
        const firstCommand = lines.find(line => {
          const trimmed = line.trim();
          return trimmed && !trimmed.startsWith('#');
        });

        if (!firstCommand) {
          result = { success: false, error: 'No executable command found in bash snippet' };
        } else {
          // Extract the command name (first word)
          const commandName = firstCommand.trim().split(/\s+/)[0];

          // Skip informational commands (installation, navigation, etc.)
          const SKIP_COMMANDS = ['npm', 'pip', 'pip3', 'cd', 'ls', 'mkdir', 'uv'];
          if (SKIP_COMMANDS.includes(commandName)) {
            skippedTests++;
            log(`  ⊘ SKIPPED (informational command: ${commandName})`, 'warning');
            return;
          }

          // Test supported executable commands
          if (commandName === 'curl') {
            result = await testCurlCommand(snippet);
          } else if (commandName === 'npx' || commandName === 'uvx') {
            result = await testBashCommand(snippet);
          } else {
            result = { success: false, error: `Bash command '${commandName}' not supported for testing (only curl, npx, uvx)` };
          }