Sourced from youch's releases.

Tag as latest after a stable beta being tested for more than a year

4.1.0 (2026-02-24)

Breaking Changes

• Switch from CommonJS to ESM. The package can no longer be require()'d.
• Switch from a default export to named exports.

  - import Youch from 'youch'
  + import { Youch } from 'youch'

• The Youch constructor no longer accepts the error or request object. Instead, the error is passed directly to toHTML(), toJSON(), and the new toANSI() methods.

  - const youch = new Youch(error, req)
  - const html = await youch.toHTML()
  - const json = await youch.toJSON()
  + const youch = new Youch()
  + const html = await youch.toHTML(error)
  + const json = await youch.toJSON(error)

• The HTTP request is no longer passed to the constructor. Pass it as an option to toHTML() instead. The request must be a plain object with url, method, and headers properties (not a Node.js http.IncomingMessage).

  - const youch = new Youch(error, req)
  - const html = await youch.toHTML()
  + const youch = new Youch()
  + const html = await youch.toHTML(error, {
  +   request: {
  +     url: req.url,
  +     method: req.method,
  +     headers: req.headers,
  +   },
  + })

• The toJSON() return value is now a ParsedError object directly, instead of being wrapped inside { error: {...} }.

  - const { error } = await youch.toJSON()
  - console.log(error.message)
  + const error = await youch.toJSON(error)
  + console.log(error.message)

• The toHTML() method no longer accepts arbitrary template data. Use the structured options object instead, which accepts title, cspNonce, ide, request, offset, and frameSourceBuffer.

  - await youch.toHTML({ cspNonce: 'abc123' })
  + await youch.toHTML(error, { cspNonce: 'abc123' })

• The preLines and postLines constructor options have been replaced by frameSourceBuffer on each render method.

  - const youch = new Youch(error, req, { preLines: 8, postLines: 8 })
  - const html = await youch.toHTML()
  + const youch = new Youch()

... (truncated)

• See full diff in compare view

This version was pushed to npm by [GitHub Actions](https://www.npmjs.com/~GitHub Actions), a new releaser for youch since your current version.

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)