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

missing_linux_example

Summary

The documentation page demonstrates a Windows bias in several areas. File and executable naming conventions (e.g., 'handler.exe') are Windows-centric and appear before or instead of Linux equivalents. Example directory structures and configuration files consistently use Windows-style executable names, and there are no explicit Linux or macOS command-line or file examples. The documentation does not provide parity in showing how to configure or run custom handlers on Linux (e.g., using './handler' or without the '.exe' extension), nor does it mention Linux-specific tools or patterns.

Recommendations

In all file and executable examples, show both Windows and Linux/macOS equivalents (e.g., 'handler.exe' for Windows, './handler' for Linux/macOS).
In directory structure diagrams, include both 'handler.exe' and 'handler' to illustrate cross-platform deployment.
In configuration file examples, clarify that 'defaultExecutablePath' should match the platform (e.g., 'handler.exe' on Windows, 'handler' on Linux/macOS).
Add explicit Linux/macOS command-line examples where relevant (e.g., how to build and run the handler on Linux).
Mention cross-platform considerations (such as file permissions on Linux, executable extensions, and case sensitivity) in relevant sections.
Where tools are referenced (such as Azure Functions Core Tools), clarify that they are available on all platforms and provide installation/use instructions for Linux/macOS as well as Windows.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-12 00:00	#243	cancelled	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-09-16 00:00	#113	completed	Clean
2025-08-17 00:01	#83	cancelled	Clean
2025-07-13 21:37	#48	completed	Clean
2025-07-09 13:09	#3	cancelled	Clean
2025-07-08 04:23	#2	cancelled	Biased

Flagged Code Snippets

func azure functionapp publish $functionAppName

{
  "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"
    }
  }
}