Giter Club home page Giter Club logo

oust's Introduction

oust Build 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

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>

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.

oust's People

Contributors

addyosmani avatar xhmikosr avatar bezoerb avatar dependabot[bot] avatar jackfranklin avatar akrawchyk avatar arthurvr avatar d-g-h avatar passy avatar sindresorhus avatar tom-bonnike avatar

Stargazers

Lillian Song avatar Roman avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.