Functions Custom Handlers - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

windows_first

windows_tools

powershell_heavy

Summary

The documentation exhibits a Windows bias by consistently using Windows-style executable names (e.g., 'handler.exe') in configuration and file structure examples, mentioning Windows executables before Linux equivalents, and omitting explicit Linux/macOS command-line examples or file naming conventions. There are no Linux shell or cross-platform deployment instructions, and the documentation assumes familiarity with Windows patterns.

Recommendations

In all file structure and configuration examples, show both Windows (e.g., 'handler.exe') and Linux/macOS (e.g., 'handler' or './handler') executable naming conventions side by side.
Explicitly mention that the 'defaultExecutablePath' can be set to platform-specific executables, and provide examples for both Windows and Linux/macOS.
Wherever a command or tool is referenced (such as deployment with Azure Functions Core Tools), include both PowerShell/Windows Command Prompt and Bash/Linux/macOS equivalents.
Add a section or callouts that clarify any platform-specific behaviors or requirements, such as file permissions for executables on Linux/macOS.
Provide at least one end-to-end example (including file structure, configuration, and deployment) that is explicitly shown for Linux/macOS users.
Avoid using Windows-specific terminology or file extensions as the default; instead, use neutral or dual-platform examples (e.g., 'handler.exe' and 'handler').

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean
2025-07-09 23:22	#6	cancelled	Clean

Flagged Code Snippets

{
  "version": "2.0",
  "customHandler": {
    "description": {
      "defaultExecutablePath": "handler.exe"
    }
  }
}

{
  "version": "2.0",
  "customHandler": {
    "description": {
      "defaultExecutablePath": "app/handler.exe",
      "arguments": [
        "--database-connection-string",
        "%DATABASE_CONNECTION_STRING%"
      ],
      "workingDirectory": "app"
    }
  }
}

{
  "version": "2.0",
  "customHandler": {
    "description": {
      "defaultExecutablePath": "handler.exe"
    }
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

{
  "version": "2.0",
  "customHandler": {
    "description": {
      "defaultExecutablePath": "handler.exe"
    },
    "enableForwardingHttpRequest": true
  }
}

{
  "version": "2.0",
  "customHandler": {
    "description": {
      "defaultExecutablePath": "handler.exe"
    }
  },
  "logging": {
    "logLevel": {
      "default": "Trace"
    }
  }
}