Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

node-sass-extra

0.3.0 • Public • Published

npm Travis (.org) Libraries.io dependency status for GitHub repo GitHub stars GitHub issues GitHub license Open Source Love Commitizen friendly

node-sass-extra

A drop-in replacement for node-sass' Node API that adds support for globs, promises and more.

Why?

✔️ Glob support
✔️ Promise support
✔️ Write css
✔️ Write source maps
✔️ Output to directory
✔️ Dynamically define output destination
✔️ Compile multiple files at once
✔️ Compile multiple files into single output
✔️ Sync and async support
✔️ Non-breaking node-sass API

Install

npm install node-sass-extra -D

Usage

const sass = require('node-sass-extra');
 
const results = await sass.render({
    file: 'src/**/*.scss',
    [, ...options]
});
 
// OR
 
const results = sass.renderSync({
    file: 'src/**/*.scss',
    [, ...options]
});

Options

Name Type Description
data string | string[] String(s) to be compiled.
file string | string[] File(s) to be compiled; can be a file path or a glob pattern.
output string | function The output destination; if provided, files WILL be written to disk. Can be a file path, a directory, or a callback that returns a file path or directory. Must be/return a file path when paired with data.
outFile string | function The output destination; does NOT write files to disk. Can be a file path, a directory, or a callback that returns a file path or directory. Must be/return a file path when paired with data. output will override this value if provided.
sourceMap string | function The source map destination. If paired with output, source maps WILL be written to disk. Either the output or outFile option must be set to use this option. Can be a boolean, a file path, a directory, or a callback that returns a boolean, file path or directory. If a boolean or directory, the file will be named after the output file.
globOptions object The configuration options for the glob pattern.
... All other node-sass options.

Examples

// compile but don't write files
const results = await sass.render({
    file: 'src/**/*.scss',
    outFile: 'css'
});
 
// write css and source maps
await sass.render({
    file: 'src/**/*.scss',
    output: 'css',
    sourceMap: true
});
 
// add `.min` suffix to compressed output
await sass.render({
    file: 'src/**/*.scss',
    output: srcFile => srcFile.replace(/.scss$/, '.min.css'),
    outputStyle: 'compressed'
});
 
// ignore sass partials
await sass.render({
    file: 'src/**/*.scss',
    output: 'css',
    globOptions: {
        ignore: '_*.scss',
        follow: true
    }
});
 
// combine multiple sources into a single output
await sass.render({
    file: 'src/**/*.scss',
    output: 'main.css'
});
 
// dynamically determine the css and source map destinations
await sass.render({
    file: 'src/**/*.scss',
    output: srcFile => srcFile.replace(/src\//, 'css/'),
    sourceMap: destFile => destFile.replace(/css\//, 'maps/')
});

API

sass.render(options[, callback])

Asynchronous rendering; returns a promise. Promise resolves with a result object(s) and rejects with an error object. If more than one source is compiled an array of results is returned.

const sass = require('node-sass-extra');
 
const results = await sass.render({
    file: 'src/**/*.scss'
    [, ...options]
});

sass.renderSync(options)

Synchronous rendering; returns a result object(s). If more than one source is compiled an array of results is returned.

const sass = require('node-sass-extra');
 
const results = sass.renderSync({
    file: 'src/**/*.scss'
    [, ...options]
});

sass.info

Version information for node-sass-extra, node-sass and libsass.

const sass = require('node-sass-extra');
 
console.log(sass.info);
 
// outputs something like:
 
// node-sass-extra 0.1.0   (Wrapper)       [JavaScript]
// node-sass       2.0.1   (Wrapper)       [JavaScript]
// libsass         3.1.0   (Sass Compiler) [C/C++]

Install

npm i node-sass-extra

DownloadsWeekly Downloads

0

Version

0.3.0

License

MIT

Unpacked Size

22 kB

Total Files

5

Last publish

Collaborators

  • avatar