Skip to content

Document req.headerList and res.headerList scripting API#95

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/headerlist-api-1778476120
Open

Document req.headerList and res.headerList scripting API#95
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/headerlist-api-1778476120

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 11, 2026

Summary

Adds reference documentation for the new PropertyList API exposed via req.headerList (read-write) and res.headerList (read-only), introduced in usebruno/bruno#7673 (merged May 5, 2026).

Changes

  • testing/script/request/request-object.mdx — adds a headerList section documenting all read, search, iteration, transform, and write methods on req.headerList, including handling of disabled headers.
  • testing/script/response/response-object.mdx — adds a headerList section documenting the read-only API on res.headerList, with a note that write methods throw.

Context

The existing req.headers / res.headers raw objects remain unchanged for backward compatibility. The new headerList API provides:

  • Case-insensitive lookups (get, has, one, indexOf)
  • Iteration helpers (forEach, map, reduce, filter, find)
  • Transforms (toObject, toString, toJSON)
  • Write methods on req.headerList (append, set, delete, clear, populate, repopulate, assimilate)
  • Disabled-header tracking on req.headerList

Method naming aligns with the MDN Web API Headers interface.

Validation

  • mint validate — passed
  • mint broken-links — no new broken links introduced

Adds reference documentation for the new PropertyList API exposed via
req.headerList (read-write) and res.headerList (read-only) introduced
in usebruno/bruno#7673.

Generated-By: mintlify-agent
@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 11, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
bruno-docs-main 🟢 Ready View Preview May 11, 2026, 5:12 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants