Have ideas to improve npm?Join in the discussion! »

    find-unused-sass-variables
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/find-unused-sass-variables package

    3.1.0 • Public • Published

    find-unused-sass-variables

    NPM version Total alerts Build Status Dependency Status devDependency Status

    A simple tool to check for unused Sass variables in a directory.

    Install

    npm install find-unused-sass-variables --save-dev

    Usage

    find-unused-sass-variables folder [, folder2...] --ignore "$my-var,$my-second-var"
    # or
    fusv folder [, folder2...]

    API

    const fusv = require('find-unused-sass-variables')
    // 'scss' is a folder
    let unused = fusv.find('scss')
    // Array of unused variables
    console.log(unused.unused);
    // ['$foo', '$bar', '$imunused']
    console.log(unused.total);
    // Total number of variables in the files
    
    // ignoring variables
    const ignoredVars = ['$my-var', '$my-second-var']
    unused = fusv.find('scss', { ignore: ignoredVars })

    find(dir, options)

    • dir: string
    • options: optional options Object

    Returns an object with unused and total. unused has the array of unused variables and total has the sum of all variables in the files (unused and used ones).

    options.ignore

    Array of strings of the variables to ignore, e.g. ['$my-var', '$my-second-var']

    Disable & enable

    Disable or enable fusv with the fusv-disable and fusv-enable comments:

    $used-variable-1: #666;
    
    // fusv-disable
    $unused-variable: #coffee;
    // fusv-enable
    
    $used-variable-2: #ace;

    Notes

    • The tool's logic is pretty "dumb"; if you use the same name for a variable in different files or namespaces, then it won't distinguish between them.
    • The tool only looks for .scss files currently.

    License

    MIT

    Install

    npm i find-unused-sass-variables

    DownloadsWeekly Downloads

    39,691

    Version

    3.1.0

    License

    MIT

    Unpacked Size

    9.32 kB

    Total Files

    6

    Last publish

    Collaborators

    • avatar
    • avatar