Skip to content

Commit 4354b9a

Browse files
EugeneHlushkoskipjack
authored andcommitted
docs(config): document info-verbosity option in watch.md (#1817)
1 parent 7b89b9f commit 4354b9a

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

src/content/configuration/watch.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,12 @@ contributors:
55
- sokra
66
- skipjack
77
- SpaceK33z
8+
- EugeneHlushko
89
---
910

1011
webpack can watch files and recompile whenever they change. This page explains how to enable this and a couple of tweaks you can make if watching does not work properly for you.
1112

13+
1214
## `watch`
1315

1416
`boolean`
@@ -21,6 +23,7 @@ watch: false
2123

2224
T> In webpack-dev-server and webpack-dev-middleware watch mode is enabled by default.
2325

26+
2427
## `watchOptions`
2528

2629
`object`
@@ -34,6 +37,7 @@ watchOptions: {
3437
}
3538
```
3639

40+
3741
## `watchOptions.aggregateTimeout`
3842

3943
`number`
@@ -44,6 +48,7 @@ Add a delay before rebuilding once the first file changed. This allows webpack t
4448
aggregateTimeout: 300 // The default
4549
```
4650

51+
4752
## `watchOptions.ignored`
4853

4954
For some systems, watching many file systems can result in a lot of CPU or memory usage. It is possible to exclude a huge folder like `node_modules`:
@@ -58,6 +63,7 @@ It is also possible to use [anymatch](https://github.com/es128/anymatch) pattern
5863
ignored: "files/**/*.js"
5964
```
6065

66+
6167
## `watchOptions.poll`
6268

6369
`boolean` `number`
@@ -71,6 +77,17 @@ poll: 1000 // Check for changes every second
7177
T> If watching does not work for you, try out this option. Watching does not work with NFS and machines in VirtualBox.
7278

7379

80+
## `info-verbosity`
81+
82+
`string`: `none` `info` `verbose`
83+
84+
Controls verbosity of the lifecycle messaging, e.g. the `Started watching files...` log. Setting `info-verbosity` to `verbose` will also message to console at the beginning and the end of incremental build. `info-verbosity` is set to `info` by default.
85+
86+
```bash
87+
webpack --watch --info-verbosity verbose
88+
```
89+
90+
7491
## Troubleshooting
7592

7693
If you are experiencing any issues, please see the following notes. There are a variety of reasons why webpack might miss a file change.

0 commit comments

Comments
 (0)