oust
Extract URLs to stylesheets, scripts, links, images or HTML imports from HTML
Install
npm install oust -D
Usage
First include:
const oust = require('oust');
Resource links can then be extracted from either files:
<link rel="stylesheet">
Extract stylesheets references const hrefs = oust(htmlString, 'stylesheets');
<link rel="stylesheet" media="print">
Extract stylesheets references with media print const hrefs = oust(htmlString, 'stylesheets', (i, $el) => {
return $el.attr('media') === 'print';
});
<script src>
Extract script references const srcs = oust(htmlString, 'scripts');
<link rel="import">
Extract HTML imports const hrefs = oust(htmlString, 'imports');
<link rel="preload" as="style">
Extract style preload references const hrefs = oust(htmlString, 'preload');
<a href>
Extract URL references const srcs = oust(htmlString, 'links');
<img src>
Extract image source references const srcs = oust(htmlString, 'images');
<style>...</style>
Extract inline styles const styles = oust(htmlString, 'styles');
Extract preload and stylesheet references combined
const hrefs = oust(htmlString, ['preload', 'stylesheets']);
Extract cheerio elements alongside the value
Useful for post processing/filtering as you get an array of matched elements
with cheerio convenience syntax (e.g. $el.attr()
)
const srcs = oust.raw(htmlString, '...');
/*
-> [
{value: '...', $el: '...'},
{value: '...', $el: '...'},
...
]
*/
API
Options
Attribute | Default | Description |
---|---|---|
src |
not set | a valid HTML string to parse for references |
type |
not set | one of stylesheets , scripts , imports , preload , styles , links , images |
CLI
npm install --global oust
Extract URLs to stylesheets, scripts, links, images or HTML imports from HTML
Usage:
$ oust <filename> <type>
<link rel="stylesheet">
Extract stylesheets references oust myFile.html stylesheets
<script src>
Extract script references oust myFile.html scripts
<link rel="import">
Extract HTML imports oust myFile.html imports
<a href>
Extract URL references oust myFile.html links
<img src>
Extract image source references oust myFile.html images
License
Released under the Apache 2 license. © Google 2014.