mirror of
https://github.com/KumoCorp/kumomta.git
synced 2026-10-03 16:00:31 +00:00
Headers were built and rebuilt as "Mime-Version" rather than "MIME-Version". Both are valid per RFC 2045, but some spam filters, such as rspamd, score the mixed-case form as a deliverability signal. Fix the header name in the accessor macro and in ParsedHeader's grammar table, the places that spell it, and update the snapshot tests across mailparsing, message, kumo-log-types, mod-mimepart, and kumod that captured the old spelling, along with the reference docs that showed the old casing in their examples. #564
1.7 KiB
1.7 KiB
value
local value = header.value
{{since('2025.10.06-5ec871ab')}}
Depending on the header name, returns one of the structured representations of the header value.
If there is no defined header name and structured representation, the fallback behavior is to return the same value that you'd see if you accessed header.unstructured.
!!! note
For the sake of forwards compatibility, it is possible that we will add
support for names and structured representations in future versions. In that
scenario, if you were using header.value and relying on it returning
the same value as header.unstructured then your logic may be broken
by upgrading.
With that in mind, we recommend that you explicitly use `header.unstructured`
in your code for headers that are not included in the table below, rather
than relying on the fallback behavior.
Supported Header Names and Types
If the Since column is blank, it is assumed to be since the inception of header.value,
which is the version shown at the top of this page.
| Name | Equivalent field accessor | Since |
|---|---|---|
| Authentication-Results | authentication_results | |
| Bcc | address_list | |
| Cc | address_list | |
| Comments | unstructured | |
| Content-Disposition | mime_params | |
| Content-Id | message_id | |
| Content-Transfer-Encoding | mime_params | |
| Content-Type | mime_params | |
| From | mailbox_list | |
| Message-ID | message_id | |
| MIME-Version | unstructured | |
| References | message_id_list | |
| Reply-To | address_list | |
| Resent-Bcc | address_list | |
| Resent-Cc | address_list | |
| Resent-From | mailbox_list | |
| Resent-Sender | mailbox | |
| Resent-To | address_list | |
| Sender | mailbox | |
| Subject | unstructured | |
| To | address_list |