posthtml-urls

PostHTML plugin for transforming URLs.

Installation

Node.js >= 6 is required. To install, type this at the command line:

npm install posthtml-urls

Usage

const posthtml = require('posthtml');
const urls = require('posthtml-urls');

const options = {
  eachURL: (url, attr, element) => `http://domain.com/${url}`
};

posthtml()
  .use( urls(options) )
  .process('<a href="link.html">link</a>')
  .then(result => console.log(result.html));
//-> <a href="http://domain.com/link.html">link</a>

Options

eachURL

Type: Function
Default value: undefined
A callback function ran for each URL value found. You can return either a synchronous value or a Promise.

filter

Type: Object
Default value: {…}
The elements and attributes for which to search. An attribute value can optionally be a function, for deeper filtering.

FAQ

1. How can I filter <style> elements and style attributes?
   Use posthtml-postcss and postcss-url.