![hapi-response-utilities logo](https://github.com/futurestudio/hapi-response-utilities/raw/master/media/hapi-response-utilities.png?raw=true)
hapi response decorations to conveniently compose responses
Installation 路 Usage 路 Methods
Follow @marcuspoehls for updates!
Development of this hapi plugin is supported by Future Studio University 馃殌
Join the Future Studio University and Skyrocket in Node.js
A hapi plugin that decorates the response toolkit h
with methods to conveniently compose responses.
hapi v19 (or later) and Node.js v12 (or newer)
This plugin requires hapi v19 (or later) and Node.js v12 or newer.
Major Release | hapi.js version | Node.js version |
---|---|---|
v2 |
>=17 hapi |
>=12 |
v1 |
>=17 hapi |
>=8 |
Add hapi-response-utilities
as a dependency to your project:
npm i hapi-response-utilities
Register hapi-response-utilities
to your hapi server and that's it :)
await server.register({
plugin: require('hapi-response-utilities')
})
// went smooth like hot chocolate :)
An overview of available hapi toolkit
decorations.
Creates a PDF response including the PDF related content type and HTTP headers allowing a custom filename.
The filename
defaults to download
.
handler: async (_, h) => {
const content = await createPdfContent()
return h.pdf(content, 'filename.pdf')
}
Shortcut to respond with just an HTTP status code.
handler: (_, h) => {
return h.status(204)
}
Sets a cookie for the given key-value-pair. It's a convenience method for h.state
.
handler: (_, h) => {
return
h.cookie('userId', '1')
.cookie('username', 'Marcus')
.continue
}
Set a response header for the given key-value-pair. This method provides a unified interface to set response headers, no matter if the response is a hapi response object or a boom error instance:
handler: (_, h) => {
return h
.header('content-type', 'text/html')
.header('api-key', 'secret-api-key')
.continue
}
The accepted options
are the same as provided by hapi itself.
Returns an object containing the response headers. This method provides a unified interface to set response headers, no matter if the response is a hapi response object or a boom error instance:
handler: (_, h) => {
const responseHeaders = h.headers()
return h.continue
}
Determines whether the response is a rendered view:
handler: (_, h) => {
if (h.isView()) {
// handle view response
}
return h.continue
}
Do you miss a feature? Please don鈥檛 hesitate to create an issue with a short description of your desired addition to this plugin.
- hapi tutorial series with 100+ tutorials
- Create a fork
- Create your feature branch:
git checkout -b my-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request 馃殌
MIT 漏 Future Studio
futurestud.io 聽路聽 GitHub @futurestudio 聽路聽 Twitter @futurestud_io