Skip to content

Commit 3e727f7

Browse files
committed
adding a note on pipe errors
1 parent 59771d3 commit 3e727f7

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,28 @@ To install it in Julia ≥ 1.6, use the package manager with
2121
pkg> add LiveServer
2222
```
2323

24+
### Broken pipe message
25+
26+
Infrequently, you _may_ see an error message in your console while using LiveServer that does not
27+
interrupt the server and does not otherwise affect your ability to see updates in the browser.
28+
This error message will look like
29+
30+
```
31+
┌ LogLevel(1999): handle_connection handler error
32+
│ exception =
33+
│ IOError: write: broken pipe (EPIPE)
34+
```
35+
36+
You can basically ignore this message, it's a problem with [HTTP.jl](https://github.com/JuliaWeb/HTTP.jl).
37+
38+
If your application depends on LiveServer and you'd like to avoid having that kind of messages being shown to your users, you can consider using [LoggingExtras.jl](https://github.com/JuliaLogging/LoggingExtras.jl) which
39+
allows you to filter out messages based on their provenance.
40+
41+
We experimented with shipping LoggingExtras in LiveServer but ended up rolling that back as it made
42+
other applications less stable.
43+
44+
45+
2446
### Legacy notes
2547

2648
For Julia `< 1.6`, you can use LiveServer's version 0.9.2:

0 commit comments

Comments
 (0)