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


5.0.0 • Public • Published


Trim trailing spaces from each line of the selected files

Build Status Maintainability devDependencies Status Built with Grunt

Getting Started

This plugin requires Grunt ~1.0 and Node.js version to be minimum of 10.13.0, which is the active Long Term Support (LTS) version.

Add this to your project's Gruntfile.js configuration:


Then add grunt-trimtrailingspaces to your "package.json" dependencies. This can be done with:

npm install grunt-trimtrailingspaces --save-dev

Or by manually editing the package.json file by adding the following line inside devDependencies object:

  "grunt-trimtrailingspaces": "^5.0.0"

Later on it would be possible to install the plugin with the command npm install

It can be updated with the command npm update, in case there is a newer version in the npm registry.

The name to use in your own task definitions is trimtrailingspaces.


Add an entry to your Gruntfile.js, within the initConfig object, which will define the files of which will the trailing spaces to be removed.

By using the src property for selecting files to be processed, they are replaced by the ones processed.

By setting the failIfTrimmed option to true, the grunt task will fail after trimming all files if any whitespace was removed. This is very useful for running trimtrailingspaces as a pre-commit task (in combination with grunt-githooks), because it will prevent the commit from going through which would not include the trimming changes.

The examples below are using the built-in custom filter property.

  trimtrailingspaces: {
    main: {
      src: ['public_html/js/**/*.js'],
      options: {
        filter: 'isFile',
        encoding: 'utf8',
        failIfTrimmed: false

It is possible to save the processed files to a different location by using the files property, as shown below. The destination (key) should be a directory path in which the src files (array value) are stored. No trailing slash needed.

Please note that this method will create a flat directory of the result.

  trimtrailingspaces: {
    main: {
      files: {
        'public_html/js/trimmed': ['public_html/js/**/*.js']
      filter: 'isFile',
      encoding: 'utf8'

For further information on how files are matched, please see the documentation of the minimatch package, as it is used underneath Grunt.

To run it:

grunt trimtrailingspaces


"A Beginner's Guide to Open Source: The Best Advice for Making your First Contribution".

Also there is a blog post about "45 Github Issues Dos and Don’ts".

Linting is done with ESLint and can be executed with npm run lint. There should be no errors appearing after any JavaScript file changes.

Version history

  • v5.0.0 (2020-05-28)
    • Minimum Node.js version lifted from 8.11.1 to 10.13.0
    • Dependencies updated of course 🎩
    • Run tests with versions 10, 12, and 14 of Node.js at Travis CI
  • v4.0.0 (2019-01-22)
    • Minimum Node.js version lifted from 6.9.5 to 8.11.1. That is all.
  • v3.0.0 (2017-10-17)
    • Minimum Node.js version lifted from 4.2.0 to 6.9.5
    • main property in package.json was pointing to a wrong file
    • Finally got that failIfTrimmed feature unit tested #10
  • v2.3.1 (2016-08-10)
    • Dependencies are sure 🎩 up to date
    • Use shared ESLint configuration and ESLint directly without the Grunt.js plugin
  • v2.3.0 (2016-04-05)
    • Update dependencies and remove grunt-cli from devDependencies as it is in grunt now
  • v2.2.0 (2016-03-02)
    • Update dependencies again and allow using Grunt 1.0.0, that should come out soon
  • v2.1.0 (2016-02-15)
    • Minimum Node.js version supported is 4.2.0 (LTS)
    • Update dependencies
  • v2.0.0 (2015-10-20)
    • Support Node.js 4+ only
    • Slightly better output messaging
  • v1.1.0 (2014-11-29)
    • Source copied to destination even when no trimming occurred
  • v1.0.0 (2014-11-10)
    • Touch file only if it needs to be trimmed
    • More efficient file handling with single regular expression check
  • v0.4.0 (2013-12-20)
    • Fail if trimmed option and use case added
  • v0.3.2 (2013-11-07)
    • Documentation for filter in examples
  • v0.3.1 (2013-08-28)
    • Dependency update to Node.js 0.10 from 0.8
  • v0.3.0 (2013-07-31)
    • Added tests and made it possible to save processed files to other location
  • v0.2.1 (2013-07-25)
    • Removed string.js dependency and use grunt.file API
  • v0.2.0 (2013-07-11)
    • Support for Grunt src files array
  • v0.1.0 (2013-07-05)
    • Initial release


Copyright (c) Juga Paazmaya paazmaya@yahoo.com

Licensed under the MIT license.


npm i grunt-trimtrailingspaces

DownloadsWeekly Downloads






Unpacked Size

10.6 kB

Total Files


Last publish


  • avatar