# postcss-log-warnings

**Repository Path**: mirrors_davidtheclark/postcss-log-warnings

## Basic Information

- **Project Name**: postcss-log-warnings
- **Description**: Log PostCSS warnings in the console
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# postcss-log-warnings [![Build Status](https://travis-ci.org/davidtheclark/postcss-log-warnings.svg?branch=master)](https://travis-ci.org/davidtheclark/postcss-log-warnings)

---

**DEPRECATED** -- **DEPRECATED** -- **DEPRECATED**

This plugin has grown up and become [postcss-reporter](https://github.com/postcss/postcss-reporter)!

Please switch to the new official PostCSS plugin!

**DEPRECATED** -- **DEPRECATED** -- **DEPRECATED**

---

Log PostCSS warnings in the console.

## Purpose

As of PostCSS 4.1, a single PostCSS process can accumulate warnings from all of the plugins it uses.
Presumably, plugin authors want you to see those warnings.
So this plugin exists to read the accumulated warnings (or warnings from only the plugins you've specified), format them for human legibility, and print them to the console.

## Example Output

![Example](example.png?raw=true)

## Installation

```
npm install postcss-log-warnings
```

## Usage

Add it to your plugin list *after any plugins whose warnings you want to log*, and pass it an object of options.

For example, using [gulp-postcss](https://github.com/w0rm/gulp-postcss):

```js
gulp.task('css', function() {
  return gulp.src('./src/*.css')
    .pipe(postcss([
      bemLinter(),
      customProperties(),
      calc(),
      rejectAllColors(),
      logWarnings(myOptions) // <------ ding
    ]))
    .pipe(gulp.dest('./dist'));
});
```

*By default, this plugin will clear the warnings after it logs them*. Otherwise, your other plugins or your PostCSS runner might re-print the same warnings, causing some confusion. This can be changed by setting the option `{ keepWarnings: true }`.

You can also use this module as a library:

```js
var processResult = require('postcss-log-warnings/lib/processResult');
var warningLog = processResult(postcssResult, options);
```

### Options

- **keepWarnings** (boolean, default = `false`)

  If true, the plugin will *not* clear the warnings after it logs them (by default, it will clear them). Other plugins will then have access to these warnings and might re-print them.

- **plugins** (array of strings, default = `[]`)

  If empty, the plugin will log every warning, regardless of which plugin registered it.
  To limit output, name the plugins whose warnings you would like to see.
  For example, `{ plugins: ['postcss-bem-linter'] }` will only log warnings from the `postcss-bem-linter` plugin.

- **throwError** (boolean, default = `false`)

  If `true`, after the plugin logs your warnings it will throw an error if it found any warnings.
  (Not part of the library options.)