Why is the htmx:error event undocumented?

[KeithDickson]

I'm writing an error handler for htmx, and want to invoke a single handler for every kind of failure. Including 4xx/5xx response errors, timeouts, etc. I started by adding a separate listener for all of the many discrete error events implemented by htmx. Which is a little unwieldy.

But then I saw in the source code that it also triggers a generic htmx:error event for any error event. This is exactly what I need, and it seems to work fine in practice.

However, the htmx:error event is not documented. Is there any particular reason for that?

And is relying on this undocumented event discouraged, or is it considered a safe and stable feature?

[KeithDickson]

Didn't get any responses to this inquiry. But for posterity, I ended up using an approach similar to the first suggestion in this related issue:

• Proposal: listening to all htmx errors #1529

I was already writing my own custom extension. So instead of handling the undocumented htmx:error event, I instead have my extension's onEvent method check for this condition and invoke my custom error handling method for any failed request:

if (event.detail?.error?.length > 0)
{
    onAnyError(event as ErrorEvent);
}