diff --git a/doc/api/cli.md b/doc/api/cli.md index c17af97f38b3fd..da3e9691eba6c1 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -789,6 +789,21 @@ about [this configuration][`--experimental-sea-config`] for details. ### `--experimental-shadow-realm` +### `--experimental-task-ordering` + +Enable experimental task ordering. Always drain micro task queue +before running `process.nextTick` to avoid unintuitive behavior +and unexpected logical deadlocks when mixing async callback and +event API's with `Promise`, `async`/`await`` and `queueMicroTask`. + + + +> Stability: 1 - Experimental + + +