Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

gulp-brotli

Package Overview
Dependencies
Maintainers
1
Versions
10
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

gulp-brotli

A gulp plugin for file compression using the brotli compression included in node.js's zlib native module, without any native or WASM extraneous libraries.

  • 3.0.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
7.3K
decreased by-2.1%
Maintainers
1
Weekly downloads
 
Created
Source

gulp-brotli

Build Status npm License npm type definitions

A gulp plugin for file compression using the brotli compression included in node.js's zlib native module, without any native or WASM extraneous libraries.

Installation

gulp-brotli is available as npm package, you can use npm to install it:

npm install --save-dev gulp-brotli

Usage

Since gulp-brotli uses the native brotli support in node.js, all the native API's options are directly exposed to keep things simple and flexible. The only extra options are:

  • extension - specifies the file name extension to add the file names of all compressed files (without the leading dot (.)). The extension option is optional and defaults to br.
  • skipLarger - when true, any compressed files that would end up being larger that their uncompressed versions will be omitted from the output. The skipLarger option is optional and defaults to false. The option is ignored for streams.

Compressing files

import gulpBrotli from 'gulp-brotli'
import gulp from 'gulp'
import zlib from 'zlib'

export function compressBrotli() {
  return gulp
    .src(`path/to/files/to/compress`)
    .pipe(gulpBrotli({
      // the options are documented at https://nodejs.org/docs/latest-v10.x/api/zlib.html#zlib_class_brotlioptions 
      params: {
        // brotli parameters are documented at https://nodejs.org/docs/latest-v10.x/api/zlib.html#zlib_brotli_constants
        [zlib.constants.BROTLI_PARAM_QUALITY]: zlib.constants.BROTLI_MAX_QUALITY,
      },
    }))
    .pipe(gulp.dest(`destination/path/which/is/usually/the/source/path`))
}

Here's an example showing the extension and skipLarger options, as well as the compress alias:

import gulpBrotli from 'gulp-brotli'
import gulp from 'gulp'
import zlib from 'zlib'

export function compressBrotli() {
  return gulp
    .src(`path/to/files/to/compress`)
    .pipe(gulpBrotli.compress({
      extension: 'brotli',
      skipLarger: true,
      // the options are documented at https://nodejs.org/docs/latest-v10.x/api/zlib.html#zlib_class_brotlioptions 
      params: {
        // brotli parameters are documented at https://nodejs.org/docs/latest-v10.x/api/zlib.html#zlib_brotli_constants
        [zlib.constants.BROTLI_PARAM_QUALITY]: zlib.constants.BROTLI_MAX_QUALITY,
      },
    }))
    .pipe(gulp.dest(`destination/path/which/is/usually/the/source/path`))
}

You may use the default configuration by omitting the options object altogether. The following example shows streaming the files instead of buffering them (the skipLarger option would be ignored in this case):

import gulpBrotli from 'gulp-brotli'
import gulp from 'gulp'
import zlib from 'zlib'

export function compressBrotli() {
  return gulp
    .src(`path/to/files/to/compress`, {buffer: false})
    .pipe(gulpBrotli.compress()) // Or you may use .pipe(gulpBrotli()) instead
    .pipe(gulp.dest(`destination/path/which/is/usually/the/source/path`))
}

Decompressing files

Decompressing files like this will also remove the .br file name extension from the resulting files (unless another extension is specified using the extension option):

import gulpBrotli from 'gulp-brotli'
import gulp from 'gulp'
import zlib from 'zlib'

export function decompressBrotli() {
  return gulp
    .src(`path/to/files/to/compress`)
    .pipe(gulpBrotli.decompress({
      // the options are documented at https://nodejs.org/docs/latest-v10.x/api/zlib.html#zlib_class_brotlioptions 
      params: {
        // brotli parameters are documented at https://nodejs.org/docs/latest-v10.x/api/zlib.html#zlib_brotli_constants
      },
    }))
    .pipe(gulp.dest(`destination/path/which/is/usually/the/source/path`))
}

The options object is optional here as well if you want to use the default configuration.

Keywords

FAQs

Package last updated on 12 Jun 2020

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc