Skip to contentpackage
posthtml-fetch
v4.0.0PostHTML plugin for fetching and displaying remote or local content.
node >=14.0.06 depscjstypesopen source
- license
- MIT
- deps
- 6
- unpacked
- 13.5 kB
- files
- 6
- node
- >=14.0.0
$npm install posthtml-fetch@4.0.0 README
GitHub-flavored package documentation.
downloads
Across all versions, last 30 days.
48,871weekly+16.6%
170,355 in 30 days
Oct 16 → Nov 14hover or arrows
compatibility
Runtime metadata.
keywords
Tagged topics.
htmlposthtmlposthtml-pluginfetchremoteresponseapiget
install size
Estimated unpacked size across 15 packages.
1.3 MB
Includes dependencies.
dependencies
6 direct · 1 outdated
versions
Latest published Jun 24, 2025
contents
Fetch Content
A plugin for fetching and working with remote and local content
Jul 25, 2024
maintainers
Registry package owners.
About
This plugin allows you to fetch remote or local content and display it in your HTML.
<fetch url="https://jsonplaceholder.typicode.com/users/1">
{{ response.name }}'s username is {{ response.username }}
</fetch>
Leanne Graham's username is Bret
Install
npm i posthtml posthtml-fetch
Usage
const posthtml = require('posthtml')
const posthtmlFetch = require('posthtml-fetch')
posthtml()
.use(posthtmlFetch())
.process('<fetch url="https://example.test">{{ response }}</fetch>')
.then(result => console.log(result.html))
// => interpolated response body
The response body will be available under the response local variable.
Response types
The plugin supports json and text responses.
Only the response body is returned.
Expressions
For example, you can iterate over items in a JSON response:
<fetch url="https://jsonplaceholder.typicode.com/users">
<each loop="user in response">
{{ user.name }}
</each>
</fetch>
Options
You may configure the plugin with the following options.
Type: String[]
Default: ['fetch', 'remote']
Array of supported tag names.
Only tags from this array will be processed by the plugin.
const posthtml = require('posthtml')
const posthtmlFetch = require('posthtml-fetch')
posthtml()
.use(posthtmlFetch({
tags: ['get']
}))
.process('<get url="https://example.test">{{ response }}</get>')
.then(result => console.log(result.html))
attribute
Type: String
Default: 'url'
String representing attribute name containing the URL to fetch.
const posthtml = require('posthtml')
const posthtmlFetch = require('posthtml-fetch')
posthtml()
.use(posthtmlFetch({
attribute: 'from'
}))
.process('<fetch from="https://example.test">{{ response }}</fetch>')
.then(result => {
console.log(result.html) // interpolated response body
})
ofetch
The plugin uses ofetch to fetch data. You can pass options directly to it, inside the ofetch object.
const posthtml = require('posthtml')
const posthtmlFetch = require('posthtml-fetch')
posthtml()
.use(posthtmlFetch({
ofetch: {
// pass options to ofetch...
}
}))
.process('<fetch url="https://example.test">{{ response }}</fetch>')
.then(result => {
console.log(result.html) // interpolated response body
})
preserveTag
Type: Boolean
Default: false
When set to true, this option will preserve the tag around the response body.
const posthtml = require('posthtml')
const posthtmlFetch = require('posthtml-fetch')
posthtml()
.use(posthtmlFetch({
preserveTag: true
}))
.process('<fetch url="https://example.test">{{ response }}</fetch>')
.then(result => {
console.log(result.html)
// => <fetch url="https://example.test">interpolated response body</fetch>
})
expressions
You can pass options to posthtml-expressions.
const posthtml = require('posthtml')
const posthtmlFetch = require('posthtml-fetch')
posthtml()
.use(posthtmlFetch({
expressions: {
delimiters: ['[[', ']]'],
}
}))
.process('<fetch url="https://example.test">[[ response ]]</fetch>')
.then(result => {
console.log(result.html) // interpolated response body
})
Plugins
after/before
List of plugins that will be called after/before receiving and processing locals
const posthtml = require('posthtml')
const posthtmlFetch = require('posthtml-fetch')
posthtml()
.use(posthtmlFetch({
plugins: {
before: [
tree => {
// Your plugin implementation
},
tree => {
// Your plugin implementation
}
],
after: [
tree => {
// Your plugin implementation
},
tree => {
// Your plugin implementation
}
]
}
}))
.process('<fetch url="https://example.test">{{ response }}</fetch>')
.then(result => {
console.log(result.html) // interpolated response body
})