# Format: [modifier] test-name [[ expectations ]] [# comment]
#
# READ THIS BEFORE ADDING AN ENTRY.
#
# An entry does ONE thing: it removes the file from the run on every platform
# the modifier matches. The runner parses the expectation kind (FAIL / SKIP /
# CRASH / FLAKY / LEAK / TIMEOUT) but never reads it — see getRelevantTests in
# scripts/runner.node.mjs. They are all the same thing, and there is no
# "run it and expect failure" mode.
#
# So: quarantining ONE broken case here silently deletes the whole file's
# coverage. If a single test is broken, skip THAT test in the file
# (test.skip / test.skipIf(isASAN) / test.todo, with a comment naming the
# failure) and do not add an entry here. Reserve this file for a file that
# cannot be run at all — it hangs, crashes the runner, or trips LeakSanitizer.
#
# Entries match by SUBSTRING, so a path prefix quarantines an entire family.
# A stale entry is invisible: the file simply never runs and nobody finds out.

# The whole file's beforeAll builds a napi addon with node-gyp, and the Windows
# agents have no ClangCL toolset ("MSB8020: The build tools for ClangCL cannot
# be found"), so nothing in the file can run there. Remove once the agent image
# ships ClangCL. Runs everywhere else. (Verified still failing, build 87834.)
[ WINDOWS ] test/bundler/native-plugin.test.ts [ SKIP ] # node-gyp needs a ClangCL toolset the Windows agents do not have

# Windows-only gap in named-pipe half-close: WindowsNamedPipe::shutdown() /
# on_read_error(EOF) issue a full uv_close instead of uv_shutdown, so the
# final write after the peer half-closes is lost. Passes on Linux and macOS.
# (Verified still failing on both Windows lanes, build 87834.)
[ WINDOWS ] test/js/node/test/parallel/test-net-pingpong.js [ FAIL ] # named-pipe half-close: count 1000 !== 1001 at close

# Cluster workers sharing a listen port behave differently on Linux, where
# SO_REUSEPORT load-balances across the workers' own listeners instead of the
# primary distributing accepted connections; the upstream test's expectations
# only hold on the distributing model. Passes on macOS and Windows.
# (Verified still failing on every Linux lane, build 87834.)
[ LINUX ] test/js/node/test/sequential/test-net-listen-shared-ports.js [ FAIL ] # SO_REUSEPORT shared-listener semantics on Linux
