WriteToConsoleError 1.0.1

🧩 WriteToConsoleError

ASP.NET 4.8 utility that automatically writes unhandled server exceptions or custom messages to the browser console (console.error), with simple configuration and helper APIs.

🚀 Features

✅ Automatically logs unhandled server exceptions to browser console
✅ Manually log exceptions or messages from your code-behind
✅ Instantly inspect the current value of variables at runtime
✅ Works in Web Forms or MVC (.NET Framework 4.8)
✅ Toggleable via web.config
✅ Optional stack trace output
✅ Clean, dependency-free design
✅ Includes unit tests + sample WebForms demo

📦 Installation

Install from NuGet:

Install-Package WriteToConsoleError

or manually copy the DLL into your /bin folder.

⚙️ Configuration (web.config)

<appSettings>
  <add key="WriteToConsoleError:Enabled" value="true" />
  <add key="WriteToConsoleError:ShowStack" value="false" />
</appSettings>

<system.webServer>
  <modules>
    <add name="WriteToConsoleErrorHttpModule"
         type="WriteToConsoleError.WriteToConsoleErrorHttpModule, WriteToConsoleError" />
  </modules>
</system.webServer>

The module injects JavaScript similar to:

<script>console.error('Server Error: [your message]');</script>

🧰 Manual Logging and Variable Inspection

Use WriteToConsoleErrorLogger anywhere in your code-behind to log exceptions, messages, or variable values directly to your browser console.

using WriteToConsoleError;

protected void Page_Load(object sender, EventArgs e)
{
    string username = "Alice";
    int orderCount = 5;

    // You can log any variable values for quick inspection:
    WriteToConsoleErrorLogger.LogMessage($"Current user: {username}");
    WriteToConsoleErrorLogger.LogMessage($"Orders today: {orderCount}");

    // Log an exception manually
    try
    {
        throw new Exception("Manual test exception");
    }
    catch (Exception ex)
    {
        WriteToConsoleErrorLogger.LogToBrowser(ex);
    }
}

Then open DevTools → Console tab in your browser to see:

Server Error: Current user: Alice
Server Error: Orders today: 5
Server Error: Manual test exception

This is extremely handy when debugging legacy WebForms or MVC apps — no need for breakpoints or Response.Write.

🧪 Example Output

Server Error: Demo exception from Default.aspx Page_Load
Server Error: Current user: Alice
Server Error: Orders today: 5

🧩 How It Works

📁 Repository Structure

WriteToConsoleError/
├── src/
│   └── WriteToConsoleError/
│       ├── WriteToConsoleErrorHttpModule.cs
│       ├── WriteToConsoleErrorLogger.cs
│       ├── Internals.cs
│       └── WriteToConsoleError.csproj
├── tests/
│   └── WriteToConsoleError.Tests/
├── samples/
│   └── WebFormsDemo/
└── README.md

🧰 Build & Test

dotnet restore
dotnet build -c Release
dotnet test  -c Release
dotnet pack  -c Release -o artifacts

Run the WebForms demo (set it as startup project in Visual Studio), open the browser console, and watch your server-side logs appear live.

🧩 Typical Use Cases

🔒 Security Notes

• Do not enable ShowStack in production.
• Use this primarily for development and QA environments.
• For full logging, integrate a dedicated logger (Serilog/NLog).

🤝 Contributing

Pull requests welcome!
Please ensure code follows SRP and includes matching unit tests.

🪪 License

MIT License © 2025 [Your Name]
See LICENSE for details.

🌐 Links

• 📦 NuGet: WriteToConsoleError on nuget.org
• 💻 GitHub: Repository Link
• 🧪 CI/CD: .github/workflows/ci.yml