1.2.0 • Published 3 years ago

@piyushmishra/oust v1.2.0

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
3 years ago

This is a custom fork to resolve "css-what" vulnerability.

Warning some of the intended features might not work. Please use the original package oust

oust Build Status dependencies Status devDependencies Status

Extract URLs to stylesheets, scripts, links, images or HTML imports from HTML

Install

npm install --save-dev oust

Usage

First include:

const oust = require("oust");

Resource links can then be extracted from either files:

Extract stylesheets references <link rel="stylesheet">

const hrefs = oust(htmlString, "stylesheets");

Extract stylesheets references with media print <link rel="stylesheet" media="print">

const hrefs = oust(htmlString, "stylesheets", (i, $el) => {
    return $el.attr("media") === "print";
});

Extract script references <script src>

const srcs = oust(htmlString, "scripts");

Extract HTML imports <link rel="import">

const hrefs = oust(htmlString, "imports");

Extract style preload references <link rel="preload" as="style">

const hrefs = oust(htmlString, "preload");

Extract URL references <a href>

const srcs = oust(htmlString, "links");

Extract image source references <img src>

const srcs = oust(htmlString, "images");

Extract inline styles <style>...</style>

const styles = oust(htmlString, "styles");

Extract preload and stylesheet references combined

const hrefs = oust(htmlString, ["preload", "stylesheets"]);

Extract cheerio elements alongside the value

Usefull 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

AttributeDefaultDescription
srcnot seta valid HTML string to parse for references
typenot setone 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>

Extract stylesheets references <link rel="stylesheet">

oust myFile.html stylesheets

Extract script references <script src>

oust myFile.html scripts

Extract HTML imports <link rel="import">

oust myFile.html imports

Extract URL references <a href>

oust myFile.html links

Extract image source references <img src>

oust myFile.html images

License

Released under the Apache 2 license. © Google 2014.

1.2.0

3 years ago