html-get
v2.16.9
Published
Get the HTML from any website, fine-tuned for correction & speed
Downloads
2,915
Maintainers
Readme
Get the HTML from any website, fine-tuned for correction & speed.
Features
- Get HTML markup for any URL, including images, video, audio, or pdf.
- Block ads tracker or any non-necessary network subrequest.
- Handle unreachable or timeout URLs gracefully.
- Ensure HTML markup is appropriately encoded.
html-get takes advantage of puppeteer headless technology when is needed, such as client-side apps that needs to be prerender.
Install
$ npm install browserless puppeteer html-get --save
Usage
const createBrowserless = require('browserless')
const getHTML = require('html-get')
// Spawn Chromium process once
const browserlessFactory = createBrowserless()
// Kill the process when Node.js exit
process.on('exit', () => {
console.log('closing resources!')
browserlessFactory.close()
})
const getContent = async url => {
// create a browser context inside Chromium process
const browserContext = browserlessFactory.createContext()
const getBrowserless = () => browserContext
const result = await getHTML(url, { getBrowserless })
// close the browser context after it's used
await getBrowserless((browser) => browser.destroyContext())
return result
}
getContent('https://example.com')
.then(content => {
console.log(content)
process.exit()
})
.catch(error => {
console.error(error)
process.exit(1)
})
Command Line
$ npx html-get https://example.com
API
getHTML(url, [options])
url
Required
Type: string
The target URL for getting the HTML markup.
options
encoding
Type: string
Default: 'utf-8'
It ensures the HTML markup is encoded to the encoded value provided.
The value will be passes to html-encode
getBrowserless
Required
Type: function
A function that should return a browserless instance to be used for interact with puppeteer:
getMode
Type: function
It determines the strategy to use based on the url
, being the possibles values 'fetch'
or 'prerender'
.
getTemporalFile
Type: function
It creates a temporal file.
gotOpts
Type: object
It passes configuration object to got under 'fetch'
strategy.
headers
Type: object
Request headers that will be passed to fetch/prerender process.
mutoolPath
Type: function
It returns the path for mutool binary, used for turning PDF files into HTML markup.
prerender
Type: boolean
|string
Default: 'auto'
Enable or disable prerendering as mechanism for getting the HTML markup explicitly.
The value auto
means that that internally use a list of websites that don't need to use prerendering by default. This list is used for speedup the process, using fetch
mode for these websites.
See getMode parameter for know more.
puppeteerOpts
Type: object
It passes coniguration object to puppeteer under 'prerender'
strategy.
rewriteUrls
Type: boolean
Default: false
When is true
, it will be rewritten CSS/HTML relatives URLs present in the HTML markup into absolutes.
License
html-get © Microlink, released under the MIT License. Authored and maintained by Kiko Beats with help from contributors.
microlink.io · GitHub microlinkhq · X @microlinkhq