AngleSharp / AngleSharp/AngleSharp.Io

Add Reporting and Network Error Observability Hooks

Open
#46 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

api enhancement up-for-grabs
Dominant language
C#
Stars
37
Forks
13
PR merge metrics
No merged PRs in 30d

Description

Proposal

Introduce a lightweight reporting surface for collecting browser-like diagnostics in automation contexts.

Scope:

  • Add API hooks for reporting events and network error signals.
  • Allow configurable sinks for captured reports.
  • Provide filtering by type and endpoint.
    Technical Notes:
  • Reporting backend should be injected for storage/forwarding.
  • Keep event model minimal and deterministic.
    Acceptance Criteria:
  • Reports can be emitted, enumerated, and flushed.
  • Network error events can be captured from requester pipeline.
  • Tests validate schema shape and filtering behavior.
    Out of Scope:
  • Full browser reporting policy implementation.
  • Full CSP/NEL parity on first release.

Description

Add reporting/observability hooks for browser-like diagnostics, including structured report emission and network-error-related capture points.

Background

Automation and headless deployments benefit from centralized diagnostics. A lightweight reporting layer improves debuggability without requiring full browser reporting-policy parity.

Specification

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the existing requester pipeline and API abstractions used for injected backends. Define the minimal report and network-error surfaces around those entry points, then add tests for schema shape, emission, enumeration, flushing, and filtering. Done means reports can use configurable sinks and network errors are captured without implementing full browser policy parity.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
api, networking, observability
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.