Skip to content

Commit

Permalink
docs: added note on hanging servers from testing
Browse files Browse the repository at this point in the history
  • Loading branch information
arctic-hen7 committed Feb 2, 2023
1 parent 76c5f97 commit ade5137
Showing 1 changed file with 12 additions and 0 deletions.
12 changes: 12 additions & 0 deletions docs/next/en-US/fundamentals/testing.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,3 +60,15 @@ It is entirely permissible, and indeed encouraged, for apps that have more advan
Common uses of custom checkpoints are particularly when combined with the [suspended state] system, if some of your pages fetch state on the client-side, and you want to test for that all working correctly.

If a checkpoint is not emitted, tests waiting for it will fail with a timeout error.

## Hanging servers

Note that *some* critical errors during testing will lead to process termination in such a way that Perseus sometimes won't catch the child process failure correctly, which may lead to a server being left open on your computer. These are easy to terminate manually though: on Linux you might do this:

```
netstat -lnp | grep 8080
```

You would replace `8080` with whatever port you're running the tests on, and then this should list a PID that you can kill with `kill <pid-here>`.

Please note that this is considered a bug, but it's a known one, and it will be addressed soon!

0 comments on commit ade5137

Please sign in to comment.