Skip to content

Get the HTML from any website, using prerendering when necessary.

License

Notifications You must be signed in to change notification settings

microlinkhq/html-get

Repository files navigation

microlink logo microlink logo

Last version Coverage Status NPM Status

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.

rewriteHtml

Type: boolean
Default: false

When is true, it will rewrite some common mistake related with HTML meta tags.

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